HtmlTaskPane.Navigate, méthode
Charge le document HTML spécifié dans le volet Office personnalisé.
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
Public MustOverride Sub Navigate ( _
url As String _
)
'Utilisation
Dim instance As HtmlTaskPane
Dim url As String
instance.Navigate(url)
public abstract void Navigate(
string url
)
Paramètres
- url
Type : System.String
URL (Uniform Resource Locator) du document HTML à atteindre.
Exceptions
| Exception | Condition |
|---|---|
| WebException | Une erreur s'est produite lors d'une tentative d'ouverture de l'URL spécifiée. |
| ArgumentNullException | Le paramètre transmis à cette méthode est une référence NULL (Nothing dans Visual Basic). |
| ArgumentException | Le paramètre passé à cette méthode n'est pas valide. Par exemple, le type ou le format est incorrect. |
Remarques
Notes
La méthode Navigate ne peut pas être appelée depuis un gestionnaire d'événements pour l'événement Loading car la vue n'est pas encore chargée lorsque l'événement se produit et des volets Office sont associés à la vue.
Ce membre est accessible uniquement par les formulaires qui s’exécutent dans le même domaine que le formulaire ouvert ou par les formulaires qui disposent d’autorisations valables pour plusieurs domaines.
Ce type ou ce membre est accessible uniquement à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.
Exemples
Dans l'exemple suivant, la méthode Navigate de la classe HtmlTaskPane est utilisée pour charger un fichier HTML dans le volet Office personnalisé. Le document HTML qu'elle charge est l'un des documents ajoutés en que tant fichiers de ressources du modèle de formulaire :
// 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")