Partilhar via


XElement.SetElementValue(XName, Object) Método

Definição

Define o valor de um elemento filho e adiciona ou remove um elemento filho.

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

Parâmetros

name
XName

Um XName que contém o nome do elemento filho a ser alterado.

value
Object

O valor a ser atribuído ao elemento filho. O elemento filho 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 à propriedade Value do elemento filho.

Exceções

O value é uma instância de XObject.

Exemplos

O exemplo a seguir cria um elemento com um elemento filho. Em seguida, ele usa esse método para definir o valor do elemento filho.

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

// Add some name/value pairs.
root.SetElementValue("Ele1", 1);
root.SetElementValue("Ele2", 2);
root.SetElementValue("Ele3", 3);
Console.WriteLine(root);

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

// Remove one of the name/value pairs.
root.SetElementValue("Ele3", null);
Console.WriteLine(root);
' Create an element with no content.
Dim root As XElement = <Root/>

' Add some name/value pairs.
root.SetElementValue("Ele1", 1)
root.SetElementValue("Ele2", 2)
root.SetElementValue("Ele3", 3)
Console.WriteLine(root)

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

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

Esse exemplo gera a saída a seguir:

<Root>
  <Ele1>1</Ele1>
  <Ele2>2</Ele2>
  <Ele3>3</Ele3>
</Root>
<Root>
  <Ele1>1</Ele1>
  <Ele2>22</Ele2>
  <Ele3>3</Ele3>
</Root>
<Root>
  <Ele1>1</Ele1>
  <Ele2>22</Ele2>
</Root>

Comentários

Esse método foi projetado para facilitar a manutenção de uma lista de pares nome/valor como um conjunto de elementos filhos. 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 elemento filho, esse método criará um elemento filho para você. Se você chamar esse método passando o nome de um elemento filho existente, esse método modificará o valor do elemento filho para o valor especificado. Se você passar null para value, esse método removerá o elemento filho.

Esse método gerará eventos.

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

Esse método não adiciona nós ou atributos filho ao elemento filho especificado. Esse método gerará uma exceção se qualquer objeto derivado de XObject for passado como value.

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

Aplica-se a

Confira também