XElement.SetAttributeValue(XName, Object) Metoda

Definicja

Ustawia wartość atrybutu, dodaje atrybut lub usuwa atrybut.Sets the value of an attribute, adds an attribute, or removes an attribute.

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)

Parametry

name
XName

XName , Który zawiera nazwę atrybutu, który ma zostać zmieniony.An XName that contains the name of the attribute to change.

value
Object

Wartość, która ma zostać przypisana do atrybutu.The value to assign to the attribute. Ten atrybut jest usuwany, jeśli wartość nulljest.The attribute is removed if the value is null. W przeciwnym razie wartość zostanie przekonwertowana na reprezentację ciągu i przypisana do Value właściwości atrybutu.Otherwise, the value is converted to its string representation and assigned to the Value property of the attribute.

Wyjątki

value Jest wystąpieniem. XObjectThe value is an instance of XObject.

Przykłady

Poniższy przykład tworzy element z atrybutem.The following example creates an element with an attribute. Następnie używa tej metody do zastąpienia zawartości atrybutu.It then uses this method to replace the content of the attribute.

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

Ten przykład generuje następujące wyniki:This example produces the following output:

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

Uwagi

Ta metoda została zaprojektowana tak, aby ułatwić zachowanie listy par nazwa/wartość jako zestawu atrybutów.This method is designed to make it easy to maintain a list of name/value pairs as a set of attributes. Gdy zachowujesz listę, musisz dodać pary, zmodyfikować pary lub usunąć pary.When maintaining the list, you need to add pairs, modify pairs, or delete pairs. W przypadku wywołania tej metody do przekazania nazwy, która nie istnieje jako atrybut, ta metoda tworzy atrybut.If you call this method passing a name that does not exist as an attribute, this method creates an attribute for you. Jeśli wywoływana jest metoda przekazująca nazwę istniejącego atrybutu, ta Metoda modyfikuje wartość atrybutu do określonej wartości.If you call this method passing the name of an existing attribute, this method modifies the value of the attribute to the value that you specify. Jeśli zostanie przekazany null do value, ta metoda usunie atrybut.If you pass null for value, this method removes the attribute.

Ta metoda spowoduje podnoszenie Changed poziomu Changing i zdarzeń.This method will raise the Changed and the Changing events.

Wartość jest przypisana do atrybutu o określonej nazwie.The value is assigned to the attribute with the specified name. Jeśli żaden atrybut o podanej nazwie nie istnieje, zostanie dodany nowy atrybut.If no attribute with the specified name exists, a new attribute is added. Jeśli wartość to null, atrybut o określonej nazwie (jeśli istnieje) jest usuwany.If the value is null, the attribute with the specified name, if any, is deleted.

Aby uzyskać więcej informacji, zobacz temat Obsługa par nazwa/wartość.For more information, see Maintaining Name/Value Pairs.

Dotyczy

Zobacz też