XElement.SetElementValue(XName, Object) 메서드

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)

매개 변수

예외

예제

다음 예제에서는 자식 요소를 사용하여 요소를 만듭니다. 그런 다음 이 메서드를 사용하여 자식 요소의 값을 설정합니다.

// 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 개요
• 이름 값 쌍 유지 관리