Compartilhar via


_XDocument2.GetNamedNodeProperty(Object, String, String) Método

Definição

Obtém o valor de uma propriedade nomeada para o nó XML especificado, que deve ser um nó nonattribute na fonte de dados main.

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

Parâmetros

varMainDOMNode
Object

Um nó XML correspondente a um nó nonattribute na fonte de dados main, para o qual uma propriedade nomeada deve ser retornada.

bstrPropertyName
String

Especifica o nome da propriedade cujo valor deve ser retornado.

bstrDefaultValue
String

Especifica o valor padrão a ser retornado se a propriedade não tiver sido definida.

Retornos

A propriedade nomeada para o nó XML especificado, que deve ser um nó nonattribute na fonte de dados main.

Exemplos

O exemplo a seguir demonstra a configuração e a obtenção do valor de uma propriedade nomeada (com o nome "custo") de um nó XML (chamado "item"):

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");

No exemplo XSL a seguir, a propriedade "custo" nomeada do nó de item é exibida:

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

O exemplo a seguir demonstra a configuração e a obtenção do valor de uma propriedade nomeada (com o nome "custo") de um nó XML (chamado "item"):

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");

No exemplo XSL a seguir, a propriedade "custo" nomeada do nó de item é exibida:

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

Comentários

As propriedades nomeadas permitem que os usuários associem cadeias de caracteres a propriedades definidas pelo usuário de nós de elemento XML na fonte de dados main. O valor de uma propriedade nomeada pode ser definido usando o SetNamedNodeProperty(IXMLDOMNode, String, String) método Usar o método GetNamedNodeProperty para ler o valor de uma propriedade nomeada.

Importante: esse membro só pode ser acessado por formulários em execução no mesmo domínio que o formulário aberto atualmente ou por formulários que receberam permissões entre domínios.

Aplica-se a