_XDocument3.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.Interop.InfoPath
Assembly: Microsoft.Office.Interop.InfoPath (in microsoft.office.interop.infopath.dll)

Syntax

<DispIdAttribute(58)> _
Sub NotifyHost ( _
    <InAttribute> bstrNotification As String _
)

Dim instance As _XDocument3
Dim bstrNotification As String

instance.NotifyHost(bstrNotification)

[DispIdAttribute(58)] 
void NotifyHost (
    [InAttribute] string bstrNotification
)

Parameter

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

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 im Artikel "Hosting the InfoPath 2007 Form Editing Environment in a Custom Web Form" im InfoPath-Entwicklerportal 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.

Informationen zum Hosten von InfoPath als Steuerelement in einer anderen Anwendung finden Sie im Artikel "Hosting the InfoPath 2007 Form Editing Environment in a Custom Web Form" imInfoPath-Entwicklerportal auf MSDN.

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 bstrNotification-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

_XDocument3-Schnittstelle
_XDocument3-Member
Microsoft.Office.Interop.InfoPath-Namespace

Share via