XElement.SetElementValue(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 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);
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 mudar.

value
Object

O valor a atribuir ao elemento filho. O elemento filho é 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 elemento filho.

Exceções

ArgumentException

O value é uma instância de XObject.

Exemplos

O exemplo seguinte cria um elemento com um elemento filho. Depois, utiliza este 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>

Observações

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

Este método vai aumentar os eventos.

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

Este método não adiciona nós filhos nem atributos ao elemento filho especificado. Este método lança uma exceção se qualquer objeto derivado de XObject for passado como value.

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

Aplica-se a

Ver também