HtmlTaskPane.Navigate-Methode
Lädt das angegebene HTML-Dokument in den benutzerdefinierten Aufgabenbereich.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride Sub Navigate ( _
url As String _
)
'Usage
Dim instance As HtmlTaskPane
Dim url As String
instance.Navigate(url)
public abstract void Navigate(
string url
)
Parameter
- url
Typ: System.String
Der URL (Uniform Resource Locator) des HTML-Dokuments, zu dem navigiert werden soll.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| WebException | Fehler beim Versuch, den angegebenen URL zu öffnen. |
| ArgumentNullException | Der an diese Methode übergebene Parameter lautet ein Nullverweis (Nothing in Visual Basic). |
| ArgumentException | Der an diese Methode übergebene Parameter ist nicht gültig. Er weist beispielsweise den falschen Typ oder das falsche Format auf. |
Hinweise
Hinweis
Die Navigate-Methode kann aus einem Ereignishandler für das Loading-Ereignis nicht aufgerufen werden, da die Ansicht beim Eintreten dieses Ereignisses noch nicht geladen wurde und Aufgabenbereiche der Ansicht zugeordnet sind.
Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.
Auf diesen Typ oder diesen Member kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft InfoPath Filler geöffnet wurden.
Beispiele
Im folgenden Beispiel wird die Navigate-Methode der HtmlTaskPane-Klasse verwendet, um eine HTML-Datei in den benutzerdefinierten Aufgabenbereich zu laden. Bei dem geladenen HTML-Dokument handelt es sich um ein Dokument, das als Ressourcendatei der Formularvorlage hinzugefügt wurde.
// 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")