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.StringEin in der Hostanwendung oder ASPX-Seite vom Code verwendeter benutzerdefinierter Wert.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentNullException | Der an diese Methode übergebene Parameter ist ein Nullverweis (Nothing in Visual Basic). |
| ArgumentException | Der an diese Methode übergebene Parameter ist nicht gültig. Er 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 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.
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