XContainer.AddFirst Metoda

Reference

Definice

Obor názvů:: System.Xml.Linq

Sestavení:: System.Xml.XDocument.dll

Sestavení:: System.Xml.Linq.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Přidá zadaný obsah jako první podřízené položky tohoto dokumentu nebo elementu.

Přetížení

AddFirst(Object)	Přidá zadaný obsah jako první podřízené položky tohoto dokumentu nebo elementu.
AddFirst(Object[])	Přidá zadaný obsah jako první podřízené položky tohoto dokumentu nebo elementu.

Příklady

Následující příklad vytvoří dva stromy XML a pak použije tuto metodu k přidání výsledků dotazu do jednoho z nich.

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)

Tento příklad vytvoří následující výstup:

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

Poznámky

Tato metoda přidá nový obsah před existující obsah .XContainer

Podrobnosti o platném obsahu, který lze předat této funkci, najdete v tématu Platný obsah objektů XElement a XDocument.

Tato metoda vyvolá Changed události a Changing .

AddFirst(Object)

Zdroj:: XContainer.cs

Zdroj:: XContainer.cs

Zdroj:: XContainer.cs

Přidá zadaný obsah jako první podřízené položky tohoto dokumentu nebo elementu.

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)

Parametry

content: Object

Objekt obsahu obsahující jednoduchý obsah nebo kolekci objektů obsahu, které mají být přidány.

Příklady

Následující příklad vytvoří dva stromy XML, pomocí této metody přidá XElement objekt jako první prvek do jednoho z nich. Přidá také výsledky dotazu LINQ do stromu 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)

Tento příklad vytvoří následující výstup:

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

Poznámky

Tato metoda přidá nový obsah před existující obsah .XContainer

Podrobnosti o platném obsahu, který lze předat této funkci, najdete v tématu Platný obsah objektů XElement a XDocument.

Tato metoda vyvolá Changed události a Changing .

Viz také

Platí pro

AddFirst(Object[])

Zdroj:: XContainer.cs

Zdroj:: XContainer.cs

Zdroj:: XContainer.cs

Přidá zadaný obsah jako první podřízené položky tohoto dokumentu nebo elementu.

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

Parametry

content: Object[]

Seznam parametrů objektů obsahu.

Výjimky

InvalidOperationException

Nadřazený objekt je null.

Příklady

Následující příklad vytvoří dva stromy XML a použije tuto metodu k přidání objektu XElement jako prvního elementu do jednoho z nich. Přidá také výsledky dotazu LINQ do stromu 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)

Tento příklad vytvoří následující výstup:

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

Poznámky

Tato metoda přidá nový obsah před existující obsah .XContainer

Podrobnosti o platném obsahu, který lze předat této funkci, najdete v tématu Platný obsah objektů XElement a XDocument.

Tato metoda vyvolá Changed události a Changing .

Viz také

Platí pro

Sdílet prostřednictvím

XContainer.AddFirst Metoda

Definice

Přetížení

Příklady

Poznámky

AddFirst(Object)

Parametry

Příklady

Poznámky

Viz také

Platí pro

AddFirst(Object[])

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Další materiály