HtmlTaskPane.Navigate(String) Methode

Referenz

Definition

Namespace:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Lädt das angegebene HTML-Dokument in den benutzerdefinierten Aufgabenbereich.

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)

Parameter

url: String

Der URL (Uniform Resource Locator) des HTML-Dokuments, zu dem navigiert werden soll.

Ausnahmen

WebException

Fehler beim Versuch, den angegebenen URL zu öffnen.

ArgumentNullException

Der an diese Methode übergebene Parameter ist ein NULL-Verweis (Nothing in Visual Basic).

ArgumentException

Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf.

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")

Hinweise

Hinweis: Die Navigate-Methode kann nicht von einem Ereignishandler für das Loading Ereignis aufgerufen werden, da die Ansicht noch nicht geladen ist, wenn dieses Ereignis eintritt, und Aufgabenbereiche der Ansicht zugeordnet sind.

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.

Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.

Gilt für:

Freigeben über