_XDocument3.NotifyHost-Methode

Článek
04/27/2010

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

Diese Methode ist nicht CLS-kompatibel.

Namespace: Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in microsoft.office.interop.infopath.semitrust.dll)

Syntax

'Declaration
<DispIdAttribute(58)> _
Sub NotifyHost ( _
    bstrNotification As String _
)
'Usage
Dim instance As _XDocument3
Dim bstrNotification As String

instance.NotifyHost(bstrNotification)

[DispIdAttribute(58)] 
void NotifyHost (
    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 (in englischer Sprache).

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 (in englischer Sprache)

Da die NotifyHost-Methode in Microsoft Office InfoPath 2007 neu hinzugekommen ist, müssen Sie sie deklarieren und in den _XDocument3 -Typ umwandeln, um auf diese Methode zuzugreifen. Weitere Informationen hierzu finden Sie unter Vorgehensweise: Verwenden von nicht mit InfoPath 2003 kompatiblen Microsoft.Office.Interop.InfoPath.SemiTrust-Membern.

Wichtig:
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.

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.SemiTrust-Namespace

Sdílet prostřednictvím