XElement.SetElementValue(XName, Object) 메서드

정의

네임스페이스:

System.Xml.Linq

어셈블리:

System.Xml.XDocument.dll

어셈블리:

System.Xml.Linq.dll

어셈블리:

netstandard.dll

자식 요소의 값을 설정하거나 자식 요소를 추가 또는 제거합니다.

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)

매개 변수

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

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

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

설명

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

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

값은 지정된 이름의 첫 번째 자식 요소에 할당됩니다. 지정한 이름의 자식 요소가 없으면 새 자식 요소가 추가됩니다. 값이 null이면 지정된 이름의 첫 번째 자식 요소(있는 경우)가 삭제됩니다.

이 메서드는 지정된 자식 요소에 자식 노드 또는 특성을 추가하지 않습니다. 이 메서드는 파생된 개체가 로 value전달되는 경우 예외를 throw합니다XObject.

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

추가 정보

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