XmlElement.SetAttribute Méthode

Définition

Espace de noms:

System.Xml

Assemblys:

System.Xml.dll, System.Xml.XmlDocument.dll

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.XmlDocument.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Définit la valeur de l'attribut spécifié.

Surcharges

SetAttribute(String, String)	Définit la valeur de l'attribut avec le nom spécifié.
SetAttribute(String, String, String)	Définit la valeur de l'attribut avec le nom local et l'URI de l'espace de noms spécifiés.

SetAttribute(String, String)

Définit la valeur de l'attribut avec le nom spécifié.

C#

public virtual void SetAttribute (string name, string value);

C#

public virtual void SetAttribute (string name, string? value);

Paramètres

name

String

Nom de l'attribut à créer ou à modifier. Il s’agit d’un nom qualifié. Si le nom contient un signe deux-points, il est analysé dans les composants de préfixe et de nom local.

value

String

Valeur à définir pour l'attribut.

Exceptions

XmlException

Le nom spécifié contient un caractère non valide.

ArgumentException

Le nœud est en lecture seule.

Remarques

Si un attribut portant le même nom est déjà présent dans l’élément, sa valeur est remplacée par celle de value. value est une chaîne simple. Elle n’est pas analysée car elle est définie. Tout balisage, tel que la syntaxe à reconnaître comme une référence d’entité, est traité comme du texte littéral et doit être correctement placé dans une séquence d’échappement par l’implémentation lorsqu’il est écrit. Pour affecter une valeur d’attribut qui contient des références d’entité, l’utilisateur doit créer un XmlAttribute nœud et XmlText tous les XmlEntityReference nœuds, générer la sous-arborescence appropriée et l’utiliser SetAttributeNode pour l’affecter en tant que valeur d’un attribut.

SetAttribute(String, String, String)

Définit la valeur de l'attribut avec le nom local et l'URI de l'espace de noms spécifiés.

C#

public virtual string SetAttribute (string localName, string namespaceURI, string value);

C#

public virtual string? SetAttribute (string localName, string? namespaceURI, string? value);

Paramètres

localName

String

Le nom local de l'attribut.

namespaceURI

String

L'URI de l'espace de noms de l'attribut.

value

String

Valeur à définir pour l'attribut.

Retours

String

Valeur de l'attribut