DataSource.GetNamedNodeProperty-Methode
Ruft den Wert einer benannten Eigenschaft für den angegebenen XML-Knoten ab, 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 Function GetNamedNodeProperty ( _
target As XPathNavigator, _
name As String _
) As String
'Usage
Dim instance As DataSource
Dim target As XPathNavigator
Dim name As String
Dim returnValue As String
returnValue = instance.GetNamedNodeProperty(target, _
name)
public abstract string GetNamedNodeProperty(
XPathNavigator target,
string name
)
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 zurückgegeben werden soll.
- name
Typ: System.String
Der Name der Eigenschaft, deren Wert zurückgegeben werden soll.
Rückgabewert
Typ: System.String
Der Wert der angegebenen benannten Eigenschaft.
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 den benutzerdefinierten Eigenschaften von XML-Elementknoten in der Hauptdatenquelle zuzuordnen. Verwenden Sie die GetNamedNodeProperty-Methode zum Lesen des Wertes einer benannten Eigenschaft. Der Wert einer benannten Eigenschaft kann mithilfe der SetNamedNodeProperty-Methode festgelegt werden.
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.