XElement.SetElementValue(XName, Object) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Xml.Linq
Assembly:
System.Xml.XDocument.dll
Assembly:
System.Xml.Linq.dll
Assembly:
netstandard.dll

Imposta il valore di un elemento figlio oppure lo aggiunge o lo rimuove.

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)

Parametri

name
XName

Oggetto XName che contiene il nome dell'elemento figlio da cambiare.

value
Object

Valore da assegnare all'elemento figlio. L'elemento figlio viene rimosso se il valore è null. In caso contrario, il valore viene convertito in una rappresentazione di stringa e assegnato alla proprietà Value dell'elemento figlio.

Eccezioni

ArgumentException

value è un'istanza di XObject.

Esempio

Nell'esempio seguente viene creato un elemento con un elemento figlio. Usa quindi questo metodo per impostare il valore dell'elemento figlio.

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

Nell'esempio viene prodotto l'output seguente:

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

Commenti

Questo metodo è progettato per semplificare la gestione di un elenco di coppie nome/valore come set di elementi figlio. Quando si gestisce l'elenco, è necessario aggiungere coppie, modificare coppie o eliminare coppie. Se si chiama questo metodo passando un nome che non esiste come elemento figlio, questo metodo crea automaticamente un elemento figlio. Se si chiama questo metodo passando il nome di un elemento figlio esistente, questo metodo modifica il valore dell'elemento figlio al valore specificato. Se si passa null per value, questo metodo rimuove l'elemento figlio.

Questo metodo genererà eventi.

Il valore viene assegnato al primo elemento figlio con il nome specificato. Se non esiste alcun elemento figlio con il nome specificato, viene aggiunto un nuovo elemento figlio. Se il valore è Null, il primo elemento figlio con il nome specificato, se presente, viene eliminato.

Questo metodo non aggiunge nodi figlio o attributi all'elemento figlio specificato. Questo metodo genera un'eccezione se qualsiasi oggetto che deriva da XObject viene passato come value.

Per altre informazioni, vedere Gestire le coppie nome-valore.

Si applica a

Vedi anche