XElement.SetAttributeValue(XName, Object) Metod

Definition

Namnområde:
System.Xml.Linq
Sammansättningar:
System.Xml.Linq.dll, System.Xml.XDocument.dll
Sammansättning:
System.Xml.Linq.dll
Sammansättning:
System.Xml.XDocument.dll
Sammansättning:
netstandard.dll

Anger värdet för ett attribut, lägger till ett attribut eller tar bort ett attribut.

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)

Parametrar

name
XName

En XName som innehåller namnet på attributet som ska ändras.

value
Object

Värdet som ska tilldelas till attributet. Attributet tas bort om värdet är null. Annars konverteras värdet till dess strängrepresentation och tilldelas egenskapen för Value attributet.

Undantag

ArgumentException

value är en instans av XObject.

Exempel

I följande exempel skapas ett element med ett attribut. Den använder sedan den här metoden för att ersätta innehållet i attributet.

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

Det här exemplet genererar följande utdata:

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

Kommentarer

Den här metoden är utformad för att göra det enkelt att underhålla en lista med namn/värde-par som en uppsättning attribut. När du underhåller listan måste du lägga till par, ändra par eller ta bort par. Om du anropar den här metoden och skickar ett namn som inte finns som ett attribut skapar den här metoden ett attribut åt dig. Om du anropar den här metoden och skickar namnet på ett befintligt attribut ändrar den här metoden värdet för attributet till det värde som du anger. Om du skickar null för valuetar den här metoden bort attributet.

Den här metoden genererar Changed händelserna och Changing .

Värdet tilldelas attributet med det angivna namnet. Om det inte finns något attribut med det angivna namnet läggs ett nytt attribut till. Om värdet är nulltas attributet med det angivna namnet, om det finns, bort.

Mer information finns i Underhålla namn/värde-par.

Gäller för

Se även