DataSource.SetNamedNodeProperty(XPathNavigator, String, String) Método

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

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

public:
 abstract void SetNamedNodeProperty(System::Xml::XPath::XPathNavigator ^ target, System::String ^ name, System::String ^ value);

public abstract void SetNamedNodeProperty (System.Xml.XPath.XPathNavigator target, string name, string value);

abstract member SetNamedNodeProperty : System.Xml.XPath.XPathNavigator * string * string -> unit

Public MustOverride Sub SetNamedNodeProperty (target As XPathNavigator, name As String, value As String)

Parâmetros

target

XPathNavigator

Um objeto XPathNavigator posicionado no nó XML correspondente a um nó nonattribute na fonte de dados main, para o qual uma propriedade nomeada deve ser definida.

name

String

O nome da propriedade a ser definido.

value

String

O valor ao qual a propriedade será definida.

Exceções

ArgumentException

Os parâmetros passados para esse método não são válidos. Por exemplo, eles são do tipo ou formato errado.

ArgumentNullException

Os parâmetros passados para esse método são uma referência nula (Nada no Visual Basic).

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 método SetNamedNodeProperty . Use o GetNamedNodeProperty(XPathNavigator, String) método para ler o valor de uma propriedade nomeada.

Os valores de propriedade definidos com o método SetNamedNodeProperty não são salvos quando o formulário é salvo.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed from code running in forms opened in Microsoft InfoPath Filler or in a Web browser.