XElement.SetAttributeValue(XName, Object) 메서드

정의

네임스페이스:

System.Xml.Linq

어셈블리:

System.Xml.XDocument.dll

Source:

XElement.cs

특성 값을 설정하거나 특성을 추가 또는 제거합니다.

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)

매개 변수

name

XName

변경할 특성의 이름이 들어 있는 XName입니다.

value

Object

특성에 할당할 값입니다. 값이 null이면 특성이 제거됩니다. 그렇지 않으면 값이 문자열 표현으로 변환되어 특성의 Value 속성에 할당됩니다.

예외

ArgumentException

value가 XObject의 인스턴스인 경우

예제

다음 예제에서는 특성을 사용하여 요소를 만듭니다. 그런 다음 이 메서드를 사용하여 특성의 내용을 바꿉 있습니다.

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

이 예제는 다음과 같은 출력을 생성합니다.

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

설명

이 메서드는 이름/값 쌍 목록을 특성 집합으로 쉽게 유지 관리할 수 있도록 설계되었습니다. 목록을 유지 관리하는 경우 쌍을 추가하거나, 쌍을 수정하거나, 쌍을 삭제해야 합니다. 특성으로 존재하지 않는 이름을 전달하는 이 메서드를 호출하는 경우 이 메서드는 특성을 만듭니다. 기존 특성의 이름을 전달하는 이 메서드를 호출하는 경우 이 메서드는 특성 값을 지정한 값으로 수정합니다. 에 를 value전달 null 하면 이 메서드는 특성을 제거합니다.

이 메서드는 및 이벤트를 발생 Changed 합니다 Changing .

값은 지정된 이름의 특성에 할당됩니다. 지정된 이름의 특성이 없으면 새 특성이 추가됩니다. 값이 이 null면 지정된 이름의 특성(있는 경우)이 삭제됩니다.

자세한 내용은 이름-값 쌍 유지 관리를 참조하세요.

추가 정보

• SetValue(Object)
• SetElementValue(XName, Object)
• SetValue(Object)
• LINQ to XML 개요
• 이름 값 쌍 유지 관리