_XDocument3.NotifyHost(String) Methode

Referenz

Definition

Namespace:: Microsoft.Office.Interop.InfoPath

Assembly:: Microsoft.Office.Interop.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.

Stellt einen benutzerdefinierten Wert für die Hostanwendung oder ASPX-Seite (Active Server Page Extension) bereit.

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

public void NotifyHost (string bstrNotification);

abstract member NotifyHost : string -> unit

Public Sub NotifyHost (bstrNotification As String)

Parameter

bstrNotification: String

Ein in der Hostanwendung oder ASPX-Seite vom Code verwendeter benutzerdefinierter Wert.

Beispiele

Im folgenden Beispiel wird gezeigt, wie der Ereignishandler im Code-Behind einer ASPX-Seite aussehen muss, um den über die NotifyHost-Methode bereitgestellten Zeichenfolgenwert zu empfangen. In diesem Beispiel würde die NotifyHost-Methode "ActionA" als bstrNotification Parameter bereitstellen, und der Ereignishandler würde eine bedingte Aktion ausführen, wenn der Wert empfangen wird.

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

Hinweise

Die NotifyHost-Methode ist für die Verwendung in Szenarien vorgesehen, in denen eine InfoPath-Formularvorlage in einem Microsoft.Office.InfoPath.Server.Controls.XmlFormView-Steuerelement auf einer ASPX-Seite gehostet wird, die von Microsoft SharePoint Server 2010 mit InfoPath Forms Services ausgeführt wird. Der Wert, den Sie für den notification Parameter angeben, ist eine Zeichenfolge, die vom CodeBehind der ASPX-Hostseite verwendet werden kann, um eine benutzerdefinierte Aktion auszuführen.

Informationen zum Hosten einer InfoPath-Formularvorlage auf einer ASPX-Seite finden Sie im InfoPath-Entwicklerportal im Artikel "Hosten der InfoPath-Formularbearbeitungsumgebung in einem benutzerdefinierten Webformular".

Die NotifyHost-Methode kann auch verwendet werden, wenn die InfoPath-Anwendung selbst als Steuerelement in einer anderen Anwendung gehostet wird, obwohl Sie in diesem Szenario normalerweise die Host -Eigenschaft verwenden würden, um stattdessen ein benutzerdefiniertes Objekt für die Arbeit mit dem Objektmodell der Hostanwendung abzurufen.

Informationen zum Hosten von InfoPath als Steuerelement in einer anderen Anwendung finden Sie im InfoPath-Entwicklerportal im Artikel "Hosten der InfoPath-Formularbearbeitungsumgebung in einem benutzerdefinierten Webformular".

Gilt für:

Share via