HtmlTaskPane.Navigate(String) 方法

定义

命名空间:

Microsoft.Office.InfoPath

程序集:

Microsoft.Office.InfoPath.dll

将指定的 HTML 文档加载到自定义任务窗格中。

public:
 abstract void Navigate(System::String ^ url);

public abstract void Navigate (string url);

abstract member Navigate : string -> unit

Public MustOverride Sub Navigate (url As String)

参数

url

String

要导航到的 HTML 文档的统一资源定位器 (URL)。

例外

WebException

尝试打开指定的 URL 时出错。

ArgumentNullException

传递给此方法的参数是一个 null 引用， (Visual Basic) 中无任何内容。

ArgumentException

传递给此方法的参数无效。 例如，它的类型或格式有误。

示例

在以下示例中，HtmlTaskPane 类的 Navigate 方法用于将 HTML 文件加载到自定义任务窗格中。 该方法加载的 HTML 文档是已作为表单模板的资源文件添加的 HTML 文档。

// Get a reference to the custom task pane. 
// It is always index [0] in the TaskPanes collection.
HtmlTaskPane oTaskPane = (Microsoft.Office.InfoPath.HtmlTaskPane)
   (this.CurrentView.Window.TaskPanes[0]);

// Navigate to new task pane based on url specified.
oTaskPane.Navigate("taskpane2.html");

' Get a reference to the custom task pane. It is always index (0) in 
' the TaskPanes collection.
Dim oTaskPane As HtmlTaskPane = _
   DirectCast(Me.CurrentView.Window.TaskPanes(0), _
   Microsoft.Office.InfoPath.HtmlTaskPane)

' Navigate to new task pane based on url specified.
oTaskPane.Navigate("taskpane2.html")

注解

注意：无法从事件的事件处理程序Loading中调用 Navigate 方法，因为发生此事件时视图尚未加载，并且任务窗格与视图相关联。

此成员只能由与当前打开的表单在相同域中运行的表单访问，或者由已授予跨域权限的表单访问。

可以通过 Microsoft InfoPath Filler 中打开的表单中运行的代码访问此类型或成员。