XContainer.AddFirst Metode

Referensi

Definisi

Ruang nama:: System.Xml.Linq

Rakitan:: System.Xml.XDocument.dll

Rakitan:: System.Xml.Linq.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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

Bagikan melalui

XContainer.AddFirst Metode

Definisi

Overload

Contoh

Keterangan

AddFirst(Object)

Parameter

Contoh

Keterangan

Lihat juga

Berlaku untuk

AddFirst(Object[])

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: