共用方式為


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)

參數

name
XName

XName,包含要變更之子項目的名稱。

value
Object

要指派給子元素的值。 如果值為 null,會移除子項目。 否則,值會轉換為其字串表示並指派給子項目的 Value 屬性。

例外狀況

valueXObject 的執行個體。

範例

下列範例會建立具有子項目的專案。 然後,它會使用這個方法來設定子項目的值。

// 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 ,這個方法就會擲回例外狀況。

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

適用於

另請參閱