XElement.SetElementValue(XName, Object) 方法

定義

命名空間:

System.Xml.Linq

組件:

System.Xml.XDocument.dll

來源:

XElement.cs

設定子元素的值、加入子元素或移除子元素。

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，包含要變更之子項目的名稱。

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>

備註

這個方法的設計目的是要輕鬆地維護名稱/值組清單做為一組子項目。 維護清單時，您必須新增配對、修改配對或刪除配對。 如果您呼叫這個方法，傳遞不存在為子專案的名稱，這個方法會為您建立子項目。 如果您呼叫這個方法，傳遞現有子專案的名稱，這個方法會將子專案的值修改為您指定的值。 如果您針對 value 傳遞 null ，這個方法會移除子專案。

這個方法會引發事件。

值會指派給具有指定名稱的第一個子專案。 如果沒有具有指定名稱的子專案存在，則會加入新的子專案。 如果值為 null，則會刪除具有指定名稱的第一個子專案。

這個方法不會將子節點或屬性加入指定的子專案。 如果任何衍生自 XObject 的物件傳遞為 value ，這個方法就會擲回例外狀況。

如需詳細資訊，請參閱 維護名稱/值組。

另請參閱

• SetValue(Object)
• SetElementValue(XName, Object)
• SetValue(Object)
• LINQ to XML 概觀
• 維持成對的名稱和數值