_XDocument4.GetNamedNodeProperty(Object, String, String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 Nichtattributenknoten 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:
<xsl:value-of select="xdXDocument:<span class="label">GetNamedNodeProperty</span>(item, 'cost', 'empty')"/>
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:
<xsl:value-of select="xdXDocument:<span class="label">GetNamedNodeProperty</span>(item, 'cost', 'empty')"/>
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 Microsoft.Office.Interop.InfoPath._XDocument4.SetNamedNodeProperty(Microsoft.Office.Interop.InfoPath.IXMLDOMNode,System.String,System.String) -Methode festgelegt werden. Verwenden Sie die GetNamedNodeProperty-Methode zum Lesen des Wertes einer benannten Eigenschaft.