Bagikan melalui

XContainer.AddFirst Metode

  • Referensi

Definisi

Ruang nama:
System.Xml.Linq
Rakitan:
System.Xml.XDocument.dll
Rakitan:
System.Xml.Linq.dll
Rakitan:
netstandard.dll

Menambahkan isi yang ditentukan sebagai turunan pertama dari dokumen atau elemen ini.

Overload

AddFirst(Object)

Menambahkan isi yang ditentukan sebagai turunan pertama dari dokumen atau elemen ini.
AddFirst(Object[])

Menambahkan isi yang ditentukan sebagai turunan pertama dari dokumen atau elemen ini.

Contoh

Contoh berikut membuat dua pohon XML, lalu menggunakan metode ini untuk menambahkan hasil kueri ke salah satunya.

XElement srcTree = new XElement("Root",  
    new XElement("Element1", 1),  
    new XElement("Element2", 2),  
    new XElement("Element3", 3),  
    new XElement("Element4", 4),  
    new XElement("Element5", 5)  
);  
XElement xmlTree = new XElement("Root",  
    new XElement("NewElement", "Content")  
);  
xmlTree.AddFirst(  
    from el in srcTree.Elements()  
    where (int)el >= 3  
    select el  
);  
Console.WriteLine(xmlTree);  

Dim srcTree As XElement = _   
        <Root>  
            <Element1>1</Element1>  
            <Element2>2</Element2>  
            <Element3>3</Element3>  
            <Element4>4</Element4>  
            <Element5>5</Element5>  
        </Root>  
Dim xmlTree As XElement = <Root>  
                              <NewElement>Content</NewElement>  
                          </Root>  
xmlTree.AddFirst( _  
    From el In srcTree.Elements _  
    Where CInt(el) >= 3 _  
    Select el)  
Console.WriteLine(xmlTree)

Contoh ini mencetak output berikut:

<Root>  
  <Element3>3</Element3>  
  <Element4>4</Element4>  
  <Element5>5</Element5>  
  <NewElement>Content</NewElement>  
</Root>

Keterangan

Metode ini menambahkan konten baru sebelum konten yang ada dari XContainer.

Untuk detail tentang konten valid yang dapat diteruskan ke fungsi ini, lihat Konten Valid XElement dan Objek XDocument.

Metode ini akan meningkatkan Changed peristiwa dan Changing .

AddFirst(Object)

Sumber:
XContainer.cs
Sumber:
XContainer.cs
Sumber:
XContainer.cs

Menambahkan isi yang ditentukan sebagai turunan pertama dari dokumen atau elemen ini.

public:
 void AddFirst(System::Object ^ content);
public void AddFirst (object content);
public void AddFirst (object? content);
member this.AddFirst : obj -> unit
Public Sub AddFirst (content As Object)

Parameter

content
Object

Objek konten yang berisi konten sederhana atau kumpulan objek konten yang akan ditambahkan.

Contoh

Contoh berikut membuat dua pohon XML, menggunakan metode ini untuk menambahkan XElement objek sebagai elemen pertama ke salah satunya. Ini juga menambahkan hasil kueri LINQ ke pohon XML.

XElement srcTree = new XElement("Root",  
    new XElement("Element1", 1),  
    new XElement("Element2", 2),  
    new XElement("Element3", 3),  
    new XElement("Element4", 4),  
    new XElement("Element5", 5)  
);  
XElement xmlTree = new XElement("Root",  
    new XElement("Child1", 1),  
    new XElement("Child2", 2),  
    new XElement("Child3", 3),  
    new XElement("Child4", 4),  
    new XElement("Child5", 5)  
);  
xmlTree.AddFirst(new XElement("NewChild", "new content"));  
xmlTree.AddFirst(  
    from el in srcTree.Elements()  
    where (int)el > 3  
    select el  
);  
// Even though Child9 does not exist in srcTree, the following statement will not  
// throw an exception, and nothing will be added to xmlTree  
xmlTree.AddFirst(srcTree.Element("Child9"));  
Console.WriteLine(xmlTree);  

Dim srcTree As XElement = _   
        <Root>  
            <Element1>1</Element1>  
            <Element2>2</Element2>  
            <Element3>3</Element3>  
            <Element4>4</Element4>  
            <Element5>5</Element5>  
        </Root>  

Dim xmlTree As XElement = _   
        <Root>  
            <Child1>1</Child1>  
            <Child2>2</Child2>  
            <Child3>3</Child3>  
            <Child4>4</Child4>  
            <Child5>5</Child5>  
        </Root>  

xmlTree.AddFirst(New XElement("NewChild", "new content"))  
xmlTree.AddFirst( _  
    From el In srcTree.Elements() _  
    Where CInt(el) > 3 _  
    Select el _  
)  
' Even though Child9 does not exist in srcTree, the following statement will not  
' throw an exception, and nothing will be added to xmlTree  
xmlTree.AddFirst(srcTree.<Child9>)  
Console.WriteLine(xmlTree)

Contoh ini mencetak output berikut:

<Root>  
  <Element4>4</Element4>  
  <Element5>5</Element5>  
  <NewChild>new content</NewChild>  
  <Child1>1</Child1>  
  <Child2>2</Child2>  
  <Child3>3</Child3>  
  <Child4>4</Child4>  
  <Child5>5</Child5>  
</Root>

Keterangan

Metode ini menambahkan konten baru sebelum konten yang ada dari XContainer.

Untuk detail tentang konten valid yang dapat diteruskan ke fungsi ini, lihat Konten Valid XElement dan Objek XDocument.

Metode ini akan meningkatkan Changed peristiwa dan Changing .

Lihat juga

Berlaku untuk

AddFirst(Object[])

Sumber:
XContainer.cs
Sumber:
XContainer.cs
Sumber:
XContainer.cs

Menambahkan isi yang ditentukan sebagai turunan pertama dari dokumen atau elemen ini.

public:
 void AddFirst(... cli::array <System::Object ^> ^ content);
public void AddFirst (params object[] content);
public void AddFirst (params object?[] content);
member this.AddFirst : obj[] -> unit
Public Sub AddFirst (ParamArray content As Object())

Parameter

content
Object[]

Daftar parameter objek konten.

Pengecualian

InvalidOperationException

Induknya adalah null.

Contoh

Contoh berikut membuat dua pohon XML, dan menggunakan metode ini untuk menambahkan XElement objek sebagai elemen pertama ke salah satunya. Ini juga menambahkan hasil kueri LINQ ke pohon XML.

XElement srcTree = new XElement("Root",  
    new XElement("Element1", 1),  
    new XElement("Element2", 2),  
    new XElement("Element3", 3),  
    new XElement("Element4", 4),  
    new XElement("Element5", 5)  
);  
XElement xmlTree = new XElement("Root",  
    new XElement("Child1", 1),  
    new XElement("Child2", 2),  
    new XElement("Child3", 3),  
    new XElement("Child4", 4),  
    new XElement("Child5", 5)  
);  
xmlTree.AddFirst(new XElement("NewChild", "new content"));  
xmlTree.AddFirst(  
    from el in srcTree.Elements()  
    where (int)el > 3  
    select el  
);  
// Even though Child9 does not exist in srcTree, the following statement will not  
// throw an exception, and nothing will be added to xmlTree.  
xmlTree.AddFirst(srcTree.Element("Child9"));  
Console.WriteLine(xmlTree);  

Dim srcTree As XElement = _   
        <Root>  
            <Element1>1</Element1>  
            <Element2>2</Element2>  
            <Element3>3</Element3>  
            <Element4>4</Element4>  
            <Element5>5</Element5>  
        </Root>  

Dim xmlTree As XElement = _   
        <Root>  
            <Child1>1</Child1>  
            <Child2>2</Child2>  
            <Child3>3</Child3>  
            <Child4>4</Child4>  
            <Child5>5</Child5>  
        </Root>  

xmlTree.AddFirst(New XElement("NewChild", "new content"))  
xmlTree.AddFirst( _  
    From el In srcTree.Elements() _  
    Where CInt(el) > 3 _  
    Select el _  
)  
' Even though Child9 does not exist in srcTree, the following statement will not  
' throw an exception, and nothing will be added to xmlTree.  
xmlTree.AddFirst(srcTree.<Child9>)  
Console.WriteLine(xmlTree)

Contoh ini mencetak output berikut:

<Root>  
  <Element4>4</Element4>  
  <Element5>5</Element5>  
  <NewChild>new content</NewChild>  
  <Child1>1</Child1>  
  <Child2>2</Child2>  
  <Child3>3</Child3>  
  <Child4>4</Child4>  
  <Child5>5</Child5>  
</Root>

Keterangan

Metode ini menambahkan konten baru sebelum konten yang ada dari XContainer.

Untuk detail tentang konten valid yang dapat diteruskan ke fungsi ini, lihat Konten Valid XElement dan Objek XDocument.

Metode ini akan meningkatkan Changed peristiwa dan Changing .

Lihat juga

Berlaku untuk