_XDocument2.GetNamedNodeProperty(Object, String, String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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:
<xsl:value-of select="xdXDocument:<span class="label">GetNamedNodeProperty</span>(item, 'cost', 'empty')"/>
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:
<xsl:value-of select="xdXDocument:<span class="label">GetNamedNodeProperty</span>(item, 'cost', 'empty')"/>
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.