Freigeben über


_XDocument3.GetNamedNodeProperty(Object, String, String) Methode

Definition

Ruft den Wert einer benannten Eigenschaft für den angegebenen XML-Knoten ab, bei dem es sich um einen nonattribute (nicht attributierten) Knoten in der Hauptdatenquelle handeln muss.

public:
 System::String ^ GetNamedNodeProperty(System::Object ^ varMainDOMNode, System::String ^ bstrPropertyName, System::String ^ bstrDefaultValue);
public string GetNamedNodeProperty (object varMainDOMNode, string bstrPropertyName, string bstrDefaultValue);
abstract member GetNamedNodeProperty : obj * string * string -> string
Public Function GetNamedNodeProperty (varMainDOMNode As Object, bstrPropertyName As String, bstrDefaultValue As String) As String

Parameter

varMainDOMNode
Object

Ein XML-Knoten, der einem nicht attributierten Knoten in der Hauptdatenquelle entspricht, für den eine benannte Eigenschaft zurückgegeben werden soll.

bstrPropertyName
String

Gibt den Namen der Eigenschaft an, deren Wert zurückgegeben werden soll.

bstrDefaultValue
String

Gibt den Standardwert an, der zurückgegeben werden soll, wenn die Eigenschaft nicht festgelegt wurde.

Gibt zurück

Die benannte Eigenschaft für den angegebenen XML-Knoten, bei dem es sich um einen nonattribute (nicht attributierten) Knoten in der Hauptdatenquelle handeln muss.

Implementiert

Beispiele

Im folgenden Beispiel wird das Festlegen und Abrufen des Wertes einer benannten Eigenschaft (mit der Bezeichnung "cost") eines XML-Knotens (mit der Bezeichnung "item") veranschaulicht:

IXMLDOMNode item = thisXDocument.DOM.selectSingleNode(@"/items/item");
string test = thisXDocument.<span class="label">GetNamedNodeProperty</span>(item, 'cost', 'Value not set');
// The value of the "cost" named property is set to 100.
thisXDocument.SetNamedNodeProperty(item, "cost", "100");
test = thisXDocument.GetNamedNodeProperty(item, "cost", "Value not set");

Im folgenden XSL-Beispiel wird die benannte Eigenschaft "cost" des Elementknotens angezeigt:

&lt;xsl:value-of select="xdXDocument:<span class="label">GetNamedNodeProperty</span>(item, 'cost', 'empty')"/&gt;

Im folgenden Beispiel wird das Festlegen und Abrufen des Wertes einer benannten Eigenschaft (mit der Bezeichnung "cost") eines XML-Knotens (mit der Bezeichnung "item") veranschaulicht:

IXMLDOMNode item = thisXDocument.DOM.selectSingleNode(@"/items/item");
string test = thisXDocument.<span class="label">GetNamedNodeProperty</span>(item, 'cost', 'Value not set');
// The value of the "cost" named property is set to 100.
thisXDocument.SetNamedNodeProperty(item, "cost", "100");
test = thisXDocument.GetNamedNodeProperty(item, "cost", "Value not set");

Im folgenden XSL-Beispiel wird die benannte Eigenschaft "cost" des Elementknotens angezeigt:

&lt;xsl:value-of select="xdXDocument:<span class="label">GetNamedNodeProperty</span>(item, 'cost', 'empty')"/&gt;

Hinweise

Benannte Eigenschaften ermöglichen es Benutzern, Zeichenfolgen mit benutzerdefinierten Eigenschaften von XML-Elementknoten in der Hauptdatenquelle zu verknüpfen. Der Wert einer benannten Eigenschaft kann mithilfe der SetNamedNodeProperty(IXMLDOMNode, String, String) -Methode festgelegt werden. Verwenden Sie die GetNamedNodeProperty-Methode zum Lesen des Wertes einer benannten Eigenschaft.

Gilt für: