_XDocument3.GetNamedNodeProperty-Methode

Článek
04/27/2010

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.

Diese Methode ist nicht CLS-kompatibel.

Namespace: Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in microsoft.office.interop.infopath.semitrust.dll)

Syntax

'Declaration
<DispIdAttribute(43)> _
Function GetNamedNodeProperty ( _
    varMainDOMNode As Object, _
    bstrPropertyName As String, _
    bstrDefaultValue As String _
) As String
'Usage
Dim instance As _XDocument3
Dim varMainDOMNode As Object
Dim bstrPropertyName As String
Dim bstrDefaultValue As String
Dim returnValue As String

returnValue = instance.GetNamedNodeProperty(varMainDOMNode, bstrPropertyName, bstrDefaultValue)

[DispIdAttribute(43)] 
string GetNamedNodeProperty (
    Object varMainDOMNode,
    string bstrPropertyName,
    string bstrDefaultValue
)

Parameter

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

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

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

Rückgabewert

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

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-Methode festgelegt werden. Mithilfe der GetNamedNodeProperty-Methode können Sie den Wert einer benannten Eigenschaft lesen.

Wichtig:
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.

Beispiel

Im folgenden Beispiel wird das Festlegen und Abrufen des Werts 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.GetNamedNodeProperty(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:GetNamedNodeProperty(item, 'cost', 'empty')"/>

Siehe auch

Referenz

_XDocument3-Schnittstelle
_XDocument3-Member
Microsoft.Office.Interop.InfoPath.SemiTrust-Namespace

Sdílet prostřednictvím