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

Définition

Espace de noms:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Définit la valeur d'une propriété nommée pour le nœud XML spécifié, lequel doit être un nœud nonattribute dans la source de données principale.

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)

Paramètres

target

XPathNavigator

Objet XPathNavigator placé sur le nœud XML correspondant à un nœud nonattribute dans la source de données principale, pour laquelle une propriété nommée doit être définie.

name

String

Nom de la propriété à définir.

value

String

Valeur avec laquelle définir la propriété.

Exceptions

ArgumentException

Les paramètres transmis à cette méthode ne sont pasvalides. Par exemple, ils sont d'un type ou format incorrect.

ArgumentNullException

Les paramètres passés à cette méthode sont une référence null (Nothing en Visual Basic).

Remarques

Les propriétés nommées permettent aux utilisateurs d'associer des chaînes aux propriétés utilisateur des nœuds d'élément XML dans la source de données principale. La valeur d'une propriété nommée peut être définie à l'aide de la méthode SetNamedNodeProperty. Utilisez la GetNamedNodeProperty(XPathNavigator, String) méthode pour lire la valeur d’une propriété nommée.

Les valeurs des propriétés définies avec la méthode SetNamedNodeProperty ne sont pas enregistrées lors de l'enregistrement du formulaire.

Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.

Vous pouvez accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur web.