GetNamedNodeProperty-metoden

Microsoft Office InfoPath

Returnerer verdien for en navngitt egenskap for den angitte XML-noden, som må være en ikke-attributtnode i hoveddatakilden.

expression.GetNamedNodeProperty(ByVal varMainDOMNode As Variant, ByVal bstrPropertyName As String, ByVal bstrDefaultValue As String) As String

expression    Obligatorisk. Et uttrykk som returnerer en referanse til et XDocument-objekt.

varMainDOMNode    Obligatorisk Variant. En XML-node som tilsvarer en ikke-attributtnode i hoveddatavisningen, som en navngitt egenskap skal angis for.

bstrPropertyName Obligatorisk String. Angir navnet til egenskapen som har verdien som skal returneres.

bstrDefaultValue Obligatorisk String. Angir standardverdien som skal returneres hvis egenskapen ikke er angitt.

returns    En streng som tilsvarer den gjeldende verdien for den navngitte egenskapen for den angitte XML-noden i hoveddatakilden. Hvis den angitte egenskapen ikke er angitt for denne XML-noden, returneres den angitte standardstrengen.

Sikkerhetsnivå

2: Kan åpnes bare av skjemaer som kjører på samme domene som skjemaet som i øyeblikket er åpent, eller av skjemaer som har fått tillatelser på tvers av domener.

Merknader

Navngitte egenskaper gjør at brukere kan knytte strenger til brukerdefinerte egenskaper for XML-elementnoder i hoveddatakilden. Verdien for en navngitt egenskap kan angis ved hjelp av SetNamedNodeProperty-metoden. Bruk GetNamedNodeProperty-metoden til å lese verdien for en navngitt egenskap.

Obs!  Denne objektmodellen støttes ikke når alternativet Deaktiver funksjoner fra oppdateringspakke under Avansert-kategorien i Alternativer-dialogboksen i InfoPath er valgt, eller når Microsoft Office 2003 Service Pack 1 eller senere ikke er installert. Skjemaer som implementerer dette objektmodellmedlemmet i kode, vil generere en feilmelding hvis de åpnes i InfoPath nå oppdateringspakkefunksjoner er deaktivert eller ikke er tilgjengelige.

Eksempel

I eksempelet nedenfor vises det hvordan du angir og henter verdien for en navngitt egenskap (med navnet "cost") for en XML-node (med navnet "item"):

var objXMLNode = XDocument.DOM.selectSingleNode("/items/item");

var strTest = XDocument.GetNamedNodeProperty(objXMLNode, 'cost', 'Value not set');

// The value of the "cost" named property is set to 100.
XDocument.SetNamedNodeProperty(objXMLNode, 'cost', '100');

strTest = XDocument.GetNamedNodeProperty(objXMLNode, 'cost', 'Value not set');

I XSL-eksempelet nedenfor vises den navngitte egenskapen "cost" for elementnoden:

<xsl:value-of select="xdXDocument:GetNamedNodeProperty(item, 'cost', 'empty')"/>