XContainer.AddFirst 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

Belirtilen içeriği bu belgenin veya öğenin ilk alt öğeleri olarak ekler.

Aşırı Yüklemeler

AddFirst(Object)

Belirtilen içeriği bu belgenin veya öğenin ilk alt öğeleri olarak ekler.
AddFirst(Object[])

Belirtilen içeriği bu belgenin veya öğenin ilk alt öğeleri olarak ekler.

Örnekler

Aşağıdaki örnek iki XML ağacı oluşturur ve sonra bu yöntemi kullanarak bir sorgunun sonuçlarını bunlardan birine ekler.

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)

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

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

Açıklamalar

Bu yöntem, yeni içeriği mevcut içeriğinin XContainerönüne ekler.

Bu işleve geçirilebilen geçerli içerik hakkında ayrıntılı bilgi için bkz. Geçerli XElement ve XDocument Nesnelerinin İçeriği.

Bu yöntem ve olaylarını Changed tetikler Changing .

AddFirst(Object)

Source:
XContainer.cs
Source:
XContainer.cs
Source:
XContainer.cs

Belirtilen içeriği bu belgenin veya öğenin ilk alt öğeleri olarak ekler.

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)

Parametreler

content
Object

Basit içerik içeren bir içerik nesnesi veya eklenecek içerik nesneleri koleksiyonu.

Örnekler

Aşağıdaki örnek iki XML ağacı oluşturur, bu yöntemi kullanarak bir XElement nesneyi bunlardan birine ilk öğe olarak ekler. Ayrıca BIR LINQ sorgusunun sonuçlarını XML ağacına ekler.

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)

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

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

Açıklamalar

Bu yöntem, yeni içeriği mevcut içeriğinin XContainerönüne ekler.

Bu işleve geçirilebilen geçerli içerik hakkında ayrıntılı bilgi için bkz. Geçerli XElement ve XDocument Nesnelerinin İçeriği.

Bu yöntem ve olaylarını Changed tetikler Changing .

Ayrıca bkz.

Şunlara uygulanır

AddFirst(Object[])

Source:
XContainer.cs
Source:
XContainer.cs
Source:
XContainer.cs

Belirtilen içeriği bu belgenin veya öğenin ilk alt öğeleri olarak ekler.

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

Parametreler

content
Object[]

İçerik nesnelerinin parametre listesi.

Özel durumlar

InvalidOperationException

Üst öğe şeklindedir null.

Örnekler

Aşağıdaki örnekte iki XML ağacı oluşturulur ve bunlardan birine ilk öğe olarak bir XElement nesne eklemek için bu yöntem kullanılır. Ayrıca BIR LINQ sorgusunun sonuçlarını XML ağacına ekler.

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)

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

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

Açıklamalar

Bu yöntem, yeni içeriği mevcut içeriğinin XContainerönüne ekler.

Bu işleve geçirilebilen geçerli içerik hakkında ayrıntılı bilgi için bkz. Geçerli XElement ve XDocument Nesnelerinin İçeriği.

Bu yöntem ve olaylarını Changed tetikler Changing .

Ayrıca bkz.

Şunlara uygulanır