XmlForm.NotifyHost-Methode
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
Typ: System.String
Ein in der Hostanwendung oder ASPX-Seite vom Code verwendeter benutzerdefinierter Wert.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentNullException | Der an diese Methode übergebene Parameter lautet ein Nullverweis (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. |
Hinweise
Die NotifyHost-Methode wird für Szenarien verwendet, in denen eine InfoPath-Formularvorlage in einem Microsoft.Office.InfoPath.Server.Controls.XmlFormView-Steuerelement auf einer ASPX-Seite gehostet wird, die in Microsoft SharePoint Server 2010 mit InfoPath Forms Services ausgeführt 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 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.
Detaillierte Informationen zum Hosten von InfoPath in einer anderen Anwendung finden Sie unter „Hosting the InfoPath Editing Environment in a Custom Windows Form Application“ im InfoPath-Entwicklerportal 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 InfoPath Filler oder einem Webbrowser geöffnet wurden.
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 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