XElement.SetElementValue(XName, Object) XElement.SetElementValue(XName, Object) XElement.SetElementValue(XName, Object) XElement.SetElementValue(XName, Object) Method

정의

자식 요소의 값을 설정하거나 자식 요소를 추가 또는 제거합니다.Sets the value of a child element, adds a child element, or removes a child element.

public:
 void SetElementValue(System::Xml::Linq::XName ^ name, System::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 XName XName

변경할 자식 요소의 이름이 들어 있는 XName입니다.An XName that contains the name of the child element to change.

value
Object Object Object Object

자식 요소에 할당할 값입니다.The value to assign to the child element. 값이 null이면 자식 요소가 제거됩니다.The child element is removed if the value is null. 그렇지 않으면 값이 문자열 표현으로 변환되어 자식 요소의 Value 속성에 할당됩니다.Otherwise, the value is converted to its string representation and assigned to the Value property of the child element.

예외

valueXObject의 인스턴스인 경우The value is an instance of XObject.

예제

다음 예제에서는 자식 요소를 사용 하 여 요소를 만듭니다.The following example creates an element with a child element. 그런 다음이 메서드를 사용 하 여 자식 요소의 값을 설정 합니다.It then uses this method to set the value of the child element.

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

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

설명

이 메서드는 자식 요소 집합으로 이름/값 쌍의 목록을 유지 관리 하기 쉬운 되도록 설계 되었습니다.This method is designed to make it easy to maintain a list of name/value pairs as a set of children elements. 목록을 유지 관리, 쌍을 추가, 쌍을 수정 또는 쌍을 삭제 해야 합니다.When maintaining the list, you need to add pairs, modify pairs, or delete pairs. 자식 요소로 존재 하지 않는 이름을 전달 하는이 메서드를 호출 하는 경우이 메서드는 자식 요소를 만듭니다.If you call this method passing a name that does not exist as a child element, this method creates a child element for you. 기존 자식 요소의 이름을 전달 하는이 메서드를 호출 하는 경우이 메서드는 지정 된 값으로 자식 요소의 값을 수정 합니다.If you call this method passing the name of an existing child element, this method modifies the value of the child element to the value that you specify. 전달 하는 경우 null 에 대 한 value,이 메서드는 자식 요소를 제거 합니다.If you pass null for value, this method removes the child element.

이 메서드는 이벤트를 발생 시킵니다.This method will raise events.

값은 지정 된 이름의 첫 번째 자식 요소에 할당 됩니다.The value is assigned to the first child element with the specified name. 지정한 이름 가진 자식 요소가 없는 경우 새 자식 요소를 추가 됩니다.If no child element with the specified name exists, a new child element is added. 값이 null 이면 지정 된 이름의 첫 번째 자식 요소가 있는 경우 삭제 됩니다.If the value is null, the first child element with the specified name, if any, is deleted.

이 메서드는 지정 된 자식 요소에 특성 또는 자식 노드를 추가 하지 않습니다.This method does not add child nodes or attributes to the specified child element. 파생 되는 모든 개체 하는 경우이 메서드가 예외를 throw XObject 으로 전달 되어 value입니다.This method throws an exception if any object that derives from XObject is passed as value.

자세한 내용은 이름/값 쌍 유지 관리합니다.For more information, see Maintaining Name/Value Pairs.

적용 대상

추가 정보