_XDocument3.NotifyHost(String) Méthode

Référence

Définition

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

Assembly:: Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

public:
 void NotifyHost(System::String ^ bstrNotification);

public void NotifyHost (string bstrNotification);

abstract member NotifyHost : string -> unit

Public Sub NotifyHost (bstrNotification As String)

Paramètres

bstrNotification: String

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

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 fournit « ActionA » comme bstrNotification paramètre et le gestionnaire d’événements effectue une action conditionnelle lors de 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

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

Remarques

La méthode NotifyHost est destinée à être utilisée dans les scénarios où un modèle de formulaire InfoPath est hébergé dans un contrôle Microsoft.Office.InfoPath.Server.Controls.XmlFormView sur une page ASPX exécutée à partir de Microsoft SharePoint Server 2010 avec InfoPath Forms Services. La valeur que vous fournissez pour le notification paramètre est une chaîne qui peut être utilisée par le code-behind de la page ASPX hôte pour effectuer 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é « Hébergement de l’environnement d’édition de formulaire InfoPath dans un formulaire web personnalisé » sur le portail des développeurs InfoPath

La méthode NotifyHost peut également être utilisée lorsque l’application InfoPath est elle-même hébergée en tant que contrôle dans une autre application, bien que dans ce scénario, vous utilisiez généralement la Host propriété pour récupérer un objet personnalisé afin d’utiliser le modèle objet de l’application hôte à la place.

Pour plus d’informations sur l’hébergement d’InfoPath en tant que contrôle dans une autre application, consultez l’article intitulé « Hébergement de l’environnement d’édition de formulaire InfoPath 2007 dans un formulaire web personnalisé » sur le portail des développeurs InfoPath

Étant donné que la méthode NotifyHost est nouvelle dans Microsoft InfoPath, vous devez déclarer et effectuer un cast vers le _XDocument3 type pour accéder à cette méthode. Pour plus d'informations, consultez Procédure : utiliser les membres du modèle objet qui ne sont pas compatibles avec InfoPath 2003.

Important : ce membre est accessible uniquement par les formulaires s’exécutant dans le même domaine que le formulaire actuellement ouvert, ou par les formulaires auxquels des autorisations inter-domaines ont été accordées.

S’applique à

Share via