XElement.SetAttributeValue(XName, Object) Método

Definição

Espaço de Nomes:
System.Xml.Linq
Assemblagens:
System.Xml.Linq.dll, System.Xml.XDocument.dll
Assemblagens:
netstandard.dll, System.Xml.XDocument.dll
Assemblagem:
System.Xml.XDocument.dll
Assemblagem:
System.Xml.Linq.dll
Assemblagem:
netstandard.dll
Origem:
XElement.cs
Origem:
XElement.cs
Origem:
XElement.cs
Origem:
XElement.cs
Origem:
XElement.cs

Define o valor de um atributo, adiciona um atributo ou remove um atributo.

public:
 void SetAttributeValue(System::Xml::Linq::XName ^ name, System::Object ^ value);
public void SetAttributeValue(System.Xml.Linq.XName name, object value);
public void SetAttributeValue(System.Xml.Linq.XName name, object? value);
member this.SetAttributeValue : System.Xml.Linq.XName * obj -> unit
Public Sub SetAttributeValue (name As XName, value As Object)

Parâmetros

name
XName

Um XName que contém o nome do atributo a mudar.

value
Object

O valor a atribuir ao atributo. O atributo é removido se o valor for null. Caso contrário, o valor é convertido para a sua representação de cadeia e atribuído à Value propriedade do atributo.

Exceções

ArgumentException

O value é uma instância de XObject.

Exemplos

O exemplo seguinte cria um elemento com um atributo. Depois, utiliza este método para substituir o conteúdo do atributo.

// Create an element with no content.
XElement root = new XElement("Root");

// Add some name/value pairs.
root.SetAttributeValue("Att1", 1);
root.SetAttributeValue("Att2", 2);
root.SetAttributeValue("Att3", 3);
Console.WriteLine(root);

// Modify one of the name/value pairs.
root.SetAttributeValue("Att2", 22);
Console.WriteLine(root);

// Remove one of the name/value pairs.
root.SetAttributeValue("Att3", null);
Console.WriteLine(root);

' Create an element with no content.
Dim root As XElement = <Root/>

' Add some name/value pairs.
root.SetAttributeValue("Att1", 1)
root.SetAttributeValue("Att2", 2)
root.SetAttributeValue("Att3", 3)
Console.WriteLine(root)

' Modify one of the name/value pairs.
root.SetAttributeValue("Att2", 22)
Console.WriteLine(root)

' Remove one of the name/value pairs.
root.SetAttributeValue("Att3", Nothing)
Console.WriteLine(root)

Este exemplo produz a seguinte saída:

<Root Att1="1" Att2="2" Att3="3" />
<Root Att1="1" Att2="22" Att3="3" />
<Root Att1="1" Att2="22" />

Observações

Este método foi concebido para facilitar a manutenção de uma lista de pares nome/valor como um conjunto de atributos. Ao manter a lista, precisa de adicionar pares, modificar pares ou eliminar pares. Se chamar este método passando um nome que não existe como atributo, este método cria um atributo para si. Se chamar este método passando o nome de um atributo existente, este método modifica o valor do atributo para o valor que especifica. Se passar null por value, este método remove o atributo.

Este método irá aumentar os Changed e os Changing eventos.

O valor é atribuído ao atributo com o nome especificado. Se não existir nenhum atributo com o nome especificado, é adicionado um novo atributo. Se o valor for null, o atributo com o nome especificado, se existir, é eliminado.

Para mais informações, consulte Manter pares nome-valor.

Aplica-se a

Ver também