XContainer.AddFirst Metoda

Definicja

Przestrzeń nazw:

System.Xml.Linq

Zestaw:

System.Xml.XDocument.dll

Dodaje określoną zawartość jako pierwsze elementy podrzędne tego dokumentu lub elementu.

Przeciążenia

AddFirst(Object)	Dodaje określoną zawartość jako pierwsze elementy podrzędne tego dokumentu lub elementu.
AddFirst(Object[])	Dodaje określoną zawartość jako pierwsze elementy podrzędne tego dokumentu lub elementu.

Przykłady

Poniższy przykład tworzy dwa drzewa XML, a następnie używa tej metody do dodania wyników zapytania do jednego 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)  

Ten przykład generuje następujące wyniki:

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

Uwagi

Ta metoda dodaje nową zawartość przed istniejącą zawartością obiektu XContainer.

Aby uzyskać szczegółowe informacje o prawidłowej zawartości, którą można przekazać do tej funkcji, zobacz Prawidłowa zawartość elementów XElement i XDocument Objects.

Ta metoda spowoduje wywołanie zdarzeń Changed i Changing .

AddFirst(Object)

Źródło:

XContainer.cs

Dodaje określoną zawartość jako pierwsze elementy podrzędne tego dokumentu lub elementu.

public:
 void AddFirst(System::Object ^ content);

public void AddFirst (object? content);

member this.AddFirst : obj -> unit

Public Sub AddFirst (content As Object)

Parametry

content

Object

Obiekt zawartości zawierający prostą zawartość lub kolekcję obiektów zawartości do dodania.

Przykłady

Poniższy przykład tworzy dwa drzewa XML, używa tej metody do dodania XElement obiektu jako pierwszego elementu do jednego z nich. Dodaje również wyniki zapytania LINQ do drzewa 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)  

Ten przykład generuje następujące wyniki:

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

Uwagi

Ta metoda dodaje nową zawartość przed istniejącą zawartością obiektu XContainer.

Aby uzyskać szczegółowe informacje o prawidłowej zawartości, którą można przekazać do tej funkcji, zobacz Prawidłowa zawartość elementów XElement i XDocument Objects.

Ta metoda spowoduje wywołanie zdarzeń Changed i Changing .

Zobacz też

• Add
• RemoveNodes()
• ReplaceNodes
• LINQ to XML — przegląd

AddFirst(Object[])

Źródło:

XContainer.cs

Dodaje określoną zawartość jako pierwsze elementy podrzędne tego dokumentu lub elementu.

public:
 void AddFirst(... cli::array <System::Object ^> ^ content);

public void AddFirst (params object?[] content);

member this.AddFirst : obj[] -> unit

Public Sub AddFirst (ParamArray content As Object())

Parametry

content

Object[]

Lista parametrów obiektów zawartości.

Wyjątki

InvalidOperationException

Elementem nadrzędnym jest null.

Przykłady

Poniższy przykład tworzy dwa drzewa XML i używa tej metody do dodania XElement obiektu jako pierwszego elementu do jednego z nich. Dodaje również wyniki zapytania LINQ do drzewa 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)  

Ten przykład generuje następujące wyniki:

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

Uwagi

Ta metoda dodaje nową zawartość przed istniejącą zawartością obiektu XContainer.

Aby uzyskać szczegółowe informacje o prawidłowej zawartości, którą można przekazać do tej funkcji, zobacz Prawidłowa zawartość elementów XElement i XDocument Objects.

Ta metoda spowoduje wywołanie zdarzeń Changed i Changing .

Zobacz też

• Add
• RemoveNodes()
• ReplaceNodes
• LINQ to XML — przegląd