XElement.SetAttributeValue(XName, Object) Método

Definição

Namespace:
System.Xml.Linq
Assemblies:
System.Xml.Linq.dll, System.Xml.XDocument.dll
Assembly:
System.Xml.Linq.dll
Assembly:
System.Xml.XDocument.dll
Assembly:
netstandard.dll

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);
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 ser alterado.

value
Object

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

Exceções

ArgumentException

É value uma instância de XObject.

Exemplos

O exemplo a seguir cria um elemento com um atributo. Em seguida, ele usa esse 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" />

Comentários

Esse método foi projetado para facilitar a manutenção de uma lista de pares nome/valor como um conjunto de atributos. Ao manter a lista, você precisa adicionar pares, modificar pares ou excluir pares. Se você chamar esse método passando um nome que não existe como um atributo, esse método criará um atributo para você. Se você chamar esse método passando o nome de um atributo existente, esse método modificará o valor do atributo para o valor especificado. Se você passar null , valueesse método removerá o atributo.

Esse método gerará o Changed e os Changing eventos.

O valor é atribuído ao atributo com o nome especificado. Se nenhum atributo com o nome especificado existir, um novo atributo será adicionado. Se o valor for null, o atributo com o nome especificado, se houver, será excluído.

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

Aplica-se a

Confira também