XContainer.Add Metoda

Definicja

Dodaje określoną zawartość jako elementy podrzędne do tego XContainerelementu .

Przeciążenia

Add(Object)

Dodaje określoną zawartość jako elementy podrzędne tego XContainerelementu .

Add(Object[])

Dodaje określoną zawartość jako elementy podrzędne tego XContainerelementu .

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.

C#
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.Add(  
    from el in srcTree.Elements()  
    where (int)el >= 3  
    select el  
);  
Console.WriteLine(xmlTree);  

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

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

Uwagi

Ta metoda dodaje nową zawartość po istniejącej zawartości elementu 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 obiektów XDocument.

Ta metoda zgłosi Changed zdarzenia i Changing .

Add(Object)

Źródło:
XContainer.cs
Źródło:
XContainer.cs
Źródło:
XContainer.cs

Dodaje określoną zawartość jako elementy podrzędne tego XContainerelementu .

C#
public void Add(object content);
C#
public void Add(object? content);

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, a następnie używa tej metody do dodania XElement obiektu do jednego z nich. Dodaje również wyniki zapytania LINQ do drzewa XML.

C#
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.Add(new XElement("NewChild", "new content"));  
xmlTree.Add(  
    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.Add(srcTree.Element("Child9"));  
Console.WriteLine(xmlTree);  

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

XML
<Root>  
  <Child1>1</Child1>  
  <Child2>2</Child2>  
  <Child3>3</Child3>  
  <Child4>4</Child4>  
  <Child5>5</Child5>  
  <NewChild>new content</NewChild>  
  <Element4>4</Element4>  
  <Element5>5</Element5>  
</Root>  

Uwagi

Ta metoda dodaje nową zawartość po istniejącej zawartości elementu 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 obiektów XDocument.

Ta metoda zgłosi Changed zdarzenia 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

Add(Object[])

Źródło:
XContainer.cs
Źródło:
XContainer.cs
Źródło:
XContainer.cs

Dodaje określoną zawartość jako elementy podrzędne tego XContainerelementu .

C#
public void Add(params object[] content);
C#
public void Add(params object?[] content);

Parametry

content
Object[]

Lista parametrów obiektów zawartości.

Przykłady

Poniższy przykład tworzy dwa drzewa XML, używa tej metody do dodania XElement obiektu do jednego z nich. Dodaje również wyniki zapytania LINQ do drzewa XML.

C#
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.Add(new XElement("NewChild", "new content"));  
xmlTree.Add(  
    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.Add(srcTree.Element("Child9"));  
Console.WriteLine(xmlTree);  

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

XML
<Root>  
  <Child1>1</Child1>  
  <Child2>2</Child2>  
  <Child3>3</Child3>  
  <Child4>4</Child4>  
  <Child5>5</Child5>  
  <NewChild>new content</NewChild>  
  <Element4>4</Element4>  
  <Element5>5</Element5>  
</Root>  

Uwagi

Ta metoda dodaje nową zawartość po istniejącej zawartości elementu 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 obiektów XDocument.

Ta metoda zgłosi Changed zdarzenia 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