XElement.SetElementValue(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 elemento filho, adiciona um elemento filho 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);
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 à Value propriedade do elemento filho.

Exceções

ArgumentException

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

Este exemplo produz a seguinte saída:

<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 , valueesse 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 filho ou atributos ao elemento filho especificado. Esse método gerará uma exceção se qualquer objeto que XObject derivar for passado como value.

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

Aplica-se a

Confira também