DataSource.SetNamedNodeProperty-Methode
Legt den Wert einer benannten Eigenschaft für den angegebenen XML-Knoten fest, bei dem es sich um einen nonattribute-Knoten in der Hauptdatenquelle handeln muss.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride Sub SetNamedNodeProperty ( _
target As XPathNavigator, _
name As String, _
value As String _
)
'Usage
Dim instance As DataSource
Dim target As XPathNavigator
Dim name As String
Dim value As String
instance.SetNamedNodeProperty(target, _
name, value)
public abstract void SetNamedNodeProperty(
XPathNavigator target,
string name,
string value
)
Parameter
- target
Typ: System.Xml.XPath.XPathNavigator
Ein XPathNavigator-Objekt, das an dem XML-Knoten positioniert ist, der einem nonattribute-Knoten in der Hauptdatenquelle entspricht, für den eine benannte Eigenschaft festgelegt werden soll.
- name
Typ: System.String
Der Name der festzulegenden Eigenschaft.
- value
Typ: System.String
Der Wert, auf den die Eigenschaft festgelegt wird.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentException | Der angegebene XML-Knoten ist ungültig. |
| ArgumentException | Der angegebene Eigenschaftenname ist ungültig. |
| ArgumentNullException | Die an diese Methode übergebenen Parameter sind ein Nullverweis (Nothing in Visual Basic). |
| ArgumentException | Die an diese Methode übergebenen Parameter sind ungültig. Sie weisen z. B. den falschen Typ oder das falsche Format auf. |
Hinweise
Benannte Eigenschaften ermöglichen es Benutzern, Zeichenfolgen mit benutzerdefinierten Eigenschaften von XML-Elementknoten in der Hauptdatenquelle zuzuordnen. Der Wert einer benannten Eigenschaft kann mithilfe der SetNamedNodeProperty-Methode festgelegt werden. Mithilfe der GetNamedNodeProperty-Methode können Sie den Wert einer benannten Eigenschaft lesen.
Mit der SetNamedNodeProperty-Methode festgelegte Eigenschaftenwerte werden nicht gespeichert, wenn das Formular gespeichert wird.
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.