HtmlTaskPane.Navigate-Methode

Artikel
04/27/2010

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
Der URL (Uniform Resource Locator) des HTML-Dokuments, zu dem navigiert werden soll.

Ausnahmen

Ausnahmetyp	Bedingung
WebException	Fehler beim Versuch, den angegebenen URL zu öffnen.
ArgumentNullException	Der an diese Methode übergebene Parameter lautet null.
ArgumentException	Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter 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 Office InfoPath 2007 geöffnet wurden.

Beispiel

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

Siehe auch

Referenz

HtmlTaskPane-Klasse
HtmlTaskPane-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über