XElement.SetElementValue(XName, Object) Metodo

Definizione

Imposta il valore di un elemento figlio oppure lo aggiunge o lo rimuove.Sets the value of a child element, adds a child element, or removes a child element.

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.An XName that contains the name of the child element to change.

value
Object

Valore da assegnare all'elemento figlio.The value to assign to the child element. L'elemento figlio viene rimosso se il valore è null.The child element is removed if the value is null. In caso contrario, il valore viene convertito in una rappresentazione di stringa e assegnato alla proprietà Value dell'elemento figlio.Otherwise, the value is converted to its string representation and assigned to the Value property of the child element.

Eccezioni

value è un'istanza di XObject.The value is an instance of XObject.

Esempio

Nell'esempio seguente viene creato un elemento con un elemento figlio.The following example creates an element with a child element. USA quindi questo metodo per impostare il valore dell'elemento figlio.It then uses this method to set the value of the child element.

// 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:This example produces the following output:

<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 è stato progettato in modo da semplificare la gestione di un elenco di coppie nome/valore come un set di elementi figlio.This method is designed to make it easy to maintain a list of name/value pairs as a set of children elements. Quando si gestisce l'elenco, è necessario aggiungere coppie, modificare coppie o eliminare coppie.When maintaining the list, you need to add pairs, modify pairs, or delete pairs. Se si chiama questo metodo passando un nome che non esiste come elemento figlio, questo metodo crea automaticamente un elemento figlio.If you call this method passing a name that does not exist as a child element, this method creates a child element for you. Se si chiama questo metodo passando il nome di un elemento figlio esistente, questo metodo modifica il valore dell'elemento figlio sul valore specificato.If you call this method passing the name of an existing child element, this method modifies the value of the child element to the value that you specify. Se si passa null per value , questo metodo rimuove l'elemento figlio.If you pass null for value, this method removes the child element.

Questo metodo genererà gli eventi.This method will raise events.

Il valore viene assegnato al primo elemento figlio con il nome specificato.The value is assigned to the first child element with the specified name. Se non esiste alcun elemento figlio con il nome specificato, viene aggiunto un nuovo elemento figlio.If no child element with the specified name exists, a new child element is added. Se il valore è null, il primo elemento figlio con il nome specificato, se presente, viene eliminato.If the value is null, the first child element with the specified name, if any, is deleted.

Questo metodo non aggiunge nodi figlio o attributi all'elemento figlio specificato.This method does not add child nodes or attributes to the specified child element. Questo metodo genera un'eccezione se un oggetto che deriva da XObject viene passato come value .This method throws an exception if any object that derives from XObject is passed as value.

Per ulteriori informazioni, vedere la pagina relativa alla gestione delle coppie nome/valore.For more information, see Maintain name-value pairs.

Si applica a

Vedi anche