XContainer.AddFirst Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Xml.Linq

Zestawy:: System.Xml.Linq.dll, System.Xml.XDocument.dll

Zestawy:: netstandard.dll, System.Xml.XDocument.dll

Zestaw:: System.Xml.XDocument.dll

Zestaw:: System.Xml.Linq.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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:

XML

<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

Źródło:: XContainer.cs

Ź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);

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:

XML

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

Dotyczy

.NET 10 i inne wersje

Produkt	Wersje
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

AddFirst(Object[])

Źródło:: XContainer.cs

Źródło:: XContainer.cs

Ź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);

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:

XML

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

Dotyczy

.NET 10 i inne wersje

Produkt	Wersje
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Udostępnij za pośrednictwem

XContainer.AddFirst Metoda

Definicja

Przeciążenia

Przykłady

Uwagi

AddFirst(Object)

Parametry

Przykłady

Uwagi

Zobacz też

Dotyczy

AddFirst(Object[])

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Dodatkowe zasoby