XElement.SetAttributeValue(XName, Object) Método

  • Referência

Definição

Namespace:
System.Xml.Linq
Assembly:
System.Xml.XDocument.dll
Assembly:
System.Xml.Linq.dll
Assembly:
netstandard.dll
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 ser alterado.

value
Object

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

Exceções

ArgumentException

O 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)

Esse exemplo gera a saída a seguir:

<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 para value, esse método removerá o atributo .

Esse método gerará os ChangedChanging eventos e .

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