XmlForm.NotifyHost(String) Methode

Referenz

Definition

Namespace:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.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:
 abstract void NotifyHost(System::String ^ notification);

public abstract void NotifyHost (string notification);

abstract member NotifyHost : string -> unit

Public MustOverride Sub NotifyHost (notification As String)

Parameter

notification: String

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

Ausnahmen

ArgumentNullException

Der an diese Methode übergebene Parameter ist ein NULL-Verweis (Nothing in Visual Basic).

ArgumentException

Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie der Ereignishandler im Code-Behind einer ASPX-Seite aussehen muss, um den von der NotifyHost-Methode bereitgestellten Zeichenfolgenwert zu empfangen. In diesem Beispiel würde die NotifyHost-Methode "ActionA" als notification 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

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 unter 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 in einer anderen Anwendung finden Sie im InfoPath-Entwicklerportal im Artikel "Hosten der InfoPath-Bearbeitungsumgebung in einer benutzerdefinierten Windows Form-Anwendung".

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.

Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.

Gilt für:

Freigeben über