Aracılığıyla paylaş

XElement.SetElementValue(XName, Object) Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Xml.Linq
Bütünleştirilmiş Kod:
System.Xml.XDocument.dll
Bütünleştirilmiş Kod:
System.Xml.Linq.dll
Bütünleştirilmiş Kod:
netstandard.dll

Bir alt öğenin değerini ayarlar, bir alt öğe ekler veya bir alt öğeyi kaldırır.

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)

Parametreler

name
XName

XName Değiştirecek alt öğenin adını içeren bir.

value
Object

Alt öğeye atanacak değer. Değer nullise alt öğe kaldırılır. Aksi takdirde, değer dize gösterimine dönüştürülür ve alt öğenin özelliğine Value atanır.

Özel durumlar

ArgumentException

value bir örneğidirXObject.

Örnekler

Aşağıdaki örnek, bir alt öğe ile bir öğe oluşturur. Daha sonra alt öğenin değerini ayarlamak için bu yöntemi kullanır.

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

Bu örnek aşağıdaki çıkışı oluşturur:

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

Açıklamalar

Bu yöntem, ad/değer çiftlerinin listesini bir alt öğe kümesi olarak korumayı kolaylaştırmak için tasarlanmıştır. Listeyi korurken çift eklemeniz, çiftleri değiştirmeniz veya silmeniz gerekir. Alt öğe olarak var olmayan bir ad geçirerek bu yöntemi çağırırsanız, bu yöntem sizin için bir alt öğe oluşturur. Var olan bir alt öğenin adını geçirerek bu yöntemi çağırırsanız, bu yöntem alt öğenin değerini belirttiğiniz değerle değiştirir. için valuegeçirirseniznull, bu yöntem alt öğeyi kaldırır.

Bu yöntem olayları tetikler.

Değer, belirtilen ada sahip ilk alt öğeye atanır. Belirtilen ada sahip alt öğe yoksa, yeni bir alt öğe eklenir. Değer null ise, belirtilen ada sahip ilk alt öğe (varsa) silinir.

Bu yöntem, belirtilen alt öğeye alt düğümler veya öznitelikler eklemez. bu yöntem, türetilen XObject herhangi bir nesne olarak valuegeçirilirse bir özel durum oluşturur.

Daha fazla bilgi için bkz . Ad-değer çiftlerini koruma.

Şunlara uygulanır

Ayrıca bkz.