XElement.SetAttributeValue(XName, Object) Metodo

Definizione

Spazio dei nomi:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Source:

XElement.cs

Imposta il valore di un attributo oppure lo aggiunge o lo rimuove.

public:
 void SetAttributeValue(System::Xml::Linq::XName ^ name, System::Object ^ value);

public void SetAttributeValue (System.Xml.Linq.XName name, object? value);

member this.SetAttributeValue : System.Xml.Linq.XName * obj -> unit

Public Sub SetAttributeValue (name As XName, value As Object)

Parametri

name

XName

Oggetto XName che contiene il nome dell'attributo da cambiare.

value

Object

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

Eccezioni

ArgumentException

value è un'istanza di XObject.

Esempio

Nell'esempio seguente viene creato un elemento con un attributo . Usa quindi questo metodo per sostituire il contenuto dell'attributo .

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

// Add some name/value pairs.
root.SetAttributeValue("Att1", 1);
root.SetAttributeValue("Att2", 2);
root.SetAttributeValue("Att3", 3);
Console.WriteLine(root);

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

// Remove one of the name/value pairs.
root.SetAttributeValue("Att3", null);
Console.WriteLine(root);

' Create an element with no content.
Dim root As XElement = <Root/>

' Add some name/value pairs.
root.SetAttributeValue("Att1", 1)
root.SetAttributeValue("Att2", 2)
root.SetAttributeValue("Att3", 3)
Console.WriteLine(root)

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

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

Nell'esempio viene prodotto l'output seguente:

<Root Att1="1" Att2="2" Att3="3" />
<Root Att1="1" Att2="22" Att3="3" />
<Root Att1="1" Att2="22" />

Commenti

Questo metodo è progettato per semplificare la gestione di un elenco di coppie nome/valore come set di attributi. 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 attributo, questo metodo crea automaticamente un attributo. Se si chiama questo metodo passando il nome di un attributo esistente, questo metodo modifica il valore dell'attributo sul valore specificato. Se si passa null per value, questo metodo rimuove l'attributo .

Questo metodo genererà gli Changed eventi e Changing .

Il valore viene assegnato all'attributo con il nome specificato. Se non esiste alcun attributo con il nome specificato, viene aggiunto un nuovo attributo. Se il valore è null, l'attributo con il nome specificato, se presente, viene eliminato.

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

Vedi anche

• SetValue(Object)
• SetElementValue(XName, Object)
• SetValue(Object)
• Panoramica di LINQ to XML
• Gestire coppie nome-valore