XmlForm.NotifyHost-Methode

Artikel
04/27/2010

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

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

'Declaration
Public MustOverride Sub NotifyHost ( _
    notification As String _
)
'Usage
Dim instance As XmlForm
Dim notification As String

instance.NotifyHost(notification)

public abstract void NotifyHost (
    string notification
)

Parameter

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

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	Der an diese Methode übergebene Parameter lautet null.
ArgumentException	Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf.

Hinweise

Die NotifyHost-Methode wird nur für Szenarien verwendet, in denen eine InfoPath-Formularvorlage in einem Microsoft.Office.InfoPath.Server.Controls.XmlFormView-Steuerelement auf einer in Microsoft Office Forms Server 2007 oder von Microsoft Office SharePoint Server 2007 mit InfoPath Forms Services ausgeführten ASPX-Seite gehostet wird. Der für den notification-Parameter bereitgestellte Wert ist eine Zeichenfolge, die vom Code-Behind der ASPX-Seite zum Ausführen einer benutzerdefinierten Aktion verwendet werden kann.

Informationen zum Hosten einer InfoPath-Formularvorlage in einer ASPX-Seite finden Sie unter "Hosting the InfoPath 2007 Form Editing Environment in a Custom Web Form" im InfoPath-Entwicklerportal (in Englisch) auf MSDN.

Die NotifyHost-Methode kann auch verwendet werden, wenn die InfoPath-Anwendung in einer anderen Anwendung als Steuerelement gehostet wird, obwohl in diesem Szenario in der Regel eine Host-Eigenschaft verwendet wird, um ein benutzerdefiniertes Objekt für die Verwendung des Objektmodells der Hostanwendung abzurufen.

Weitere Informationen zum Hosten von InfoPath in einer anderen Anwendung finden Sie unter "Hosting the InfoPath 2007 Editing Environment in a Custom Windows Form Application" im InfoPath-Entwicklerportal (in Englisch) auf MSDN.

Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.

Auf diesen Typ oder diesen Member kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft Office InfoPath 2007 oder einem Webbrowser geöffnet wurden.

Beispiel

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 stellt die NotifyHost-Methode "ActionA" als notification-Parameter bereit, und der Ereignishandler führt beim Empfang des Werts eine bedingte Aktion aus.

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

Siehe auch

Referenz

XmlForm-Klasse
XmlForm-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über