XStreamingElement.Add Метод

Определение

Пространство имен:

System.Xml.Linq

Сборка:

System.Xml.XDocument.dll

Добавляет указанное содержимое в качестве дочерних элементов в данный объект XStreamingElement.

Перегрузки

Add(Object)	Добавляет указанное содержимое в качестве дочерних элементов в данный объект XStreamingElement.
Add(Object[])	Добавляет указанное содержимое в качестве дочерних элементов в данный объект XStreamingElement.

Add(Object)

Исходный код:

XStreamingElement.cs

Добавляет указанное содержимое в качестве дочерних элементов в данный объект XStreamingElement.

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

public void Add (object? content);

member this.Add : obj -> unit

Public Sub Add (content As Object)

Параметры

content

Object

Содержимое для добавления к потоковому элементу.

Примеры

В следующем примере создается новый XStreamingElementобъект . Затем он добавляет два запроса к элементу потоковой передачи. Запросы не выполняются до сериализации элемента потоковой передачи.

XElement srcTree = new XElement("Root",
                       new XElement("Child", 1),
                       new XElement("Child", 2),
                       new XElement("Child", 3),
                       new XElement("Child", 4),
                       new XElement("Child", 5)
                   );

XStreamingElement dstTree = new XStreamingElement("NewRoot");

dstTree.Add(
    from el in srcTree.Elements()
    where (int)el <= 1
    select new XElement("Child", (int)el)
);

dstTree.Add(
    from el in srcTree.Elements()
    where (int)el >= 3
    select new XElement("DifferentChild", (int)el)
);

Console.WriteLine(dstTree);

Dim srcTree As XElement = _
    <Root>
        <Child>1</Child>
        <Child>2</Child>
        <Child>3</Child>
        <Child>4</Child>
        <Child>5</Child>
    </Root>

Dim dstTree As XStreamingElement = New XStreamingElement("NewRoot")

dstTree.Add( _
    From el In srcTree.Elements() _
    Where el.Value <= 1 _
    Select <Child><%= el.Value %></Child> _
)

dstTree.Add( _
    From el In srcTree.Elements() _
    Where el.Value >= 3 _
    Select <DifferentChild><%= el.Value %></DifferentChild> _
)

Console.WriteLine(dstTree)

В этом примере выводятся следующие данные:

<NewRoot>
  <Child>1</Child>
  <DifferentChild>3</DifferentChild>
  <DifferentChild>4</DifferentChild>
  <DifferentChild>5</DifferentChild>
</NewRoot>

Комментарии

Этот конструктор добавляет указанное содержимое и атрибуты в XStreamingElement. Хотя часто можно создать в одном операторе XStreamingElement , иногда удобнее добавлять содержимое в элемент потоковой передачи постепенно.

Запросы не выполняются итерация до сериализации XStreamingElement . Это отличается от использования запросов к содержимому XElementдля , где запросы выполняются итерации во время создания нового XElement.

Дополнительные сведения о допустимом содержимом, которое можно передать в эту функцию, см. в разделе Допустимое содержимое объектов XElement и XDocument.

См. также раздел

• Общие сведения о LINQ to XML

Add(Object[])

Исходный код:

XStreamingElement.cs

Добавляет указанное содержимое в качестве дочерних элементов в данный объект XStreamingElement.

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

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

member this.Add : obj[] -> unit

Public Sub Add (ParamArray content As Object())

Параметры

content

Object[]

Содержимое для добавления к потоковому элементу.

Примеры

В следующем примере создается новый XStreamingElementобъект . Затем он добавляет два запроса к элементу потоковой передачи. Запросы не выполняются до сериализации элемента потоковой передачи.

XElement srcTree = new XElement("Root",
                       new XElement("Child", 1),
                       new XElement("Child", 2),
                       new XElement("Child", 3),
                       new XElement("Child", 4),
                       new XElement("Child", 5)
                   );

XStreamingElement dstTree = new XStreamingElement("NewRoot");

dstTree.Add(
    from el in srcTree.Elements()
    where (int)el <= 1
    select new XElement("Child", (int)el)
);

dstTree.Add(
    from el in srcTree.Elements()
    where (int)el >= 3
    select new XElement("DifferentChild", (int)el)
);

Console.WriteLine(dstTree);

Dim srcTree As XElement = _
    <Root>
        <Child>1</Child>
        <Child>2</Child>
        <Child>3</Child>
        <Child>4</Child>
        <Child>5</Child>
    </Root>

Dim dstTree As XStreamingElement = New XStreamingElement("NewRoot")

dstTree.Add( _
    From el In srcTree.Elements() _
    Where el.Value <= 1 _
    Select <Child><%= el.Value %></Child> _
)

dstTree.Add( _
    From el In srcTree.Elements() _
    Where el.Value >= 3 _
    Select <DifferentChild><%= el.Value %></DifferentChild> _
)

Console.WriteLine(dstTree)

В этом примере выводятся следующие данные:

<NewRoot>
  <Child>1</Child>
  <DifferentChild>3</DifferentChild>
  <DifferentChild>4</DifferentChild>
  <DifferentChild>5</DifferentChild>
</NewRoot>

Комментарии

Этот конструктор добавляет указанное содержимое и атрибуты в XStreamingElement. Хотя часто можно создать в одном операторе XStreamingElement , иногда удобнее добавлять содержимое в элемент потоковой передачи постепенно.

Запросы не выполняются итерация до сериализации XStreamingElement . Это отличается от использования запросов к содержимому XElementдля , где запросы выполняются итерации во время создания нового XElement.

Дополнительные сведения о допустимом содержимом, которое можно передать в эту функцию, см. в разделе Допустимое содержимое объектов XElement и XDocument.

См. также раздел

• Общие сведения о LINQ to XML