XmlElement.SetAttribute Método

  • Referência

Definição

Namespace:
System.Xml
Assemblies:
System.Xml.dll, System.Xml.XmlDocument.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.XmlDocument.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Define o valor do atributo especificado.

Sobrecargas

SetAttribute(String, String)

Define o valor do atributo com o nome especificado.
SetAttribute(String, String, String)

Define o valor do atributo com o nome do local e o URI de namespace especificados.

SetAttribute(String, String)

Define o valor do atributo com o nome especificado.

public:
 virtual void SetAttribute(System::String ^ name, System::String ^ value);
public virtual void SetAttribute (string name, string value);
public virtual void SetAttribute (string name, string? value);
abstract member SetAttribute : string * string -> unit
override this.SetAttribute : string * string -> unit
Public Overridable Sub SetAttribute (name As String, value As String)

Parâmetros

name
String

O nome do atributo a ser criado ou alterado. Este é um nome qualificado. Se o nome contiver dois-pontos, ele será analisado em componentes de nome local e prefixo.

value
String

O valor a ser definido para o atributo.

Exceções

XmlException

O nome especificado contém um caractere inválido.

ArgumentException

O nó é somente leitura.

Comentários

Se um atributo com o mesmo nome já estiver presente no elemento, seu valor será alterado para o de value. value é uma cadeia de caracteres simples. Ele não é analisado como está sendo definido. Qualquer marcação, como sintaxe a ser reconhecida como uma referência de entidade, é tratada como texto literal e precisa ser escapada corretamente pela implementação quando ela é gravada. Para atribuir um valor de atributo que contém referências de entidade, o usuário deve criar um XmlAttribute nó mais qualquer XmlText e XmlEntityReference nós, criar a subárvore apropriada e usá-la SetAttributeNode como o valor de um atributo.

Aplica-se a

SetAttribute(String, String, String)

Define o valor do atributo com o nome do local e o URI de namespace especificados.

public:
 virtual System::String ^ SetAttribute(System::String ^ localName, System::String ^ namespaceURI, System::String ^ value);
public virtual string SetAttribute (string localName, string namespaceURI, string value);
public virtual string? SetAttribute (string localName, string? namespaceURI, string? value);
abstract member SetAttribute : string * string * string -> string
override this.SetAttribute : string * string * string -> string
Public Overridable Function SetAttribute (localName As String, namespaceURI As String, value As String) As String

Parâmetros

localName
String

O nome local do atributo.

namespaceURI
String

O URI do namespace do atributo.

value
String

O valor a ser definido para o atributo.

Retornos

String

O valor do atributo.

Aplica-se a