_XDocument3.NotifyHost - Méthode

Fournit une valeur personnalisée à l’application hôte ou à la page ASPX.

Espace de noms :  Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly :  Microsoft.Office.Interop.InfoPath.SemiTrust (dans Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Syntaxe

'Déclaration
Sub NotifyHost ( _
    bstrNotification As String _
)
'Utilisation
Dim instance As _XDocument3
Dim bstrNotification As String

instance.NotifyHost(bstrNotification)

void NotifyHost(
    string bstrNotification
)

Paramètres

• bstrNotification
  Type : System.String

  Une valeur personnalisée qui sera utilisée par le code dans l'application hôte ou la page ASPX.

Remarques

La méthode NotifyHost est conçue pour être utilisée lorsqu'un modèle de formulaire InfoPath est hébergé dans un contrôle Microsoft.Office.InfoPath.Server.Controls.XmlFormView sur une page ASPX s'exécutant sur Microsoft SharePoint Server 2010 avec InfoPath Forms Services. La valeur à donner au paramètre notification est une chaîne qui peut être utilisée par le code appartenant à la page ASPX hôte pour réaliser une action personnalisée.

Pour plus d'informations sur l'hébergement d'un modèle de formulaire InfoPath dans une page ASPX, consultez l'article intitulé « Hosting the InfoPath 2007 Form Editing Environment in a Custom Web Form » sur le Portail des développeurs InfoPath, sur MSDN.

La méthode NotifyHost peut aussi être utilisée lorsque l'application InfoPath est elle-même hébergée sous forme de contrôle dans une autre application, même si dans cette situation on utilise généralement la propriété Host pour récupérer un objet personnalisé et travailler plutôt avec le modèle objet de l'application hôte.

Pour plus informations détaillées sur l'hébergement d'InfoPath sous forme de contrôle dans une autre application, consultez l'article intitulé « Hosting the InfoPath 2007 Form Editing Environment in a Custom Web Form » sur le Portail des développeurs InfoPath, sur MSDN.

Puisque la méthode NotifyHost est une nouveauté dans Microsoft InfoPath, il est nécessaire de la déclarer et de l'envoyer au type _XDocument3 pour y accéder. Pour plus d'informations, consultez Procédure : utiliser des membres du modèle objet non compatibles avec InfoPath 2003.

Exemples

L'exemple suivant montre ce à quoi doit ressembler de gestionnaire d'événements dans le code d'une page ASPX pour recevoir la valeur de chaîne fournie par la méthode NotifyHost. Dans cet exemple, la méthode NotifyHost doit fournir « ActionA » comme paramètre bstrNotification et le gestionnaire doit réaliser une action conditionnelle à la réception de la valeur.

private void XmlFormView1_NotifyHost(Object sender, 
   NotifyHostEventArgs e)
{
   if (e.Notification == "ActionA")
   {
      // Code to perform if 'ActionA' is received.
   }

   else 
   {
      // Code to perform an alternative action.
   }
}

Private Sub XmlFormView1_NotifyHost(sender As Object, _
   e As NotifyHostEventArgs)
   If (e.Notification = "ActionA") Then
      ' Code to perform if 'ActionA' is received.
   Else 
      ' Code to perform an alternative action.
   End If
End Sub

Voir aussi

Référence

_XDocument3 interface

_XDocument3 - Membres

Microsoft.Office.Interop.InfoPath.SemiTrust - Espace de noms