XNode.AddBeforeSelf Метод

Определение

Пространство имен:
System.Xml.Linq
Сборки:
System.Xml.Linq.dll, System.Xml.XDocument.dll
Сборки:
netstandard.dll, System.Xml.XDocument.dll
Сборка:
System.Xml.XDocument.dll
Сборка:
System.Xml.Linq.dll
Сборка:
netstandard.dll

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

Перегрузки

Имя Описание
AddBeforeSelf(Object)

Добавляет указанное содержимое непосредственно перед этим узлом.
AddBeforeSelf(Object[])

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

Примеры

В следующем примере используется запрос LINQ для создания объекта IEnumerable<T>XElement, который затем передается этому методу. Это добавляет результаты запроса в дерево в нужном расположении.

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)
);
XElement child1 = xmlTree.Element("Child1");
child1.AddBeforeSelf(
    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>
            <Child1>1</Child1>
            <Child2>2</Child2>
            <Child3>3</Child3>
            <Child4>4</Child4>
            <Child5>5</Child5>
        </Root>

Dim child1 As XElement = xmlTree.<Child1>(0)
child1.AddBeforeSelf( _
From el In srcTree.Elements() _
Where CInt(el) > 3 _
Select el)

Console.WriteLine(xmlTree)

В примере получается следующий вывод.

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

Комментарии

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

Этот метод вызовет Changed и Changing события.

Дочерние XContainer заметки хранятся в виде последовательно связанного XNode списка объектов. Это означает, что AddBeforeSelf метод должен пройти по списку прямых дочерних узлов в родительском контейнере. Поэтому использование этого метода может повлиять на производительность.

AddBeforeSelf(Object)

Исходный код:
XNode.cs
Исходный код:
XNode.cs
Исходный код:
XNode.cs
Исходный код:
XNode.cs
Исходный код:
XNode.cs

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

public:
 void AddBeforeSelf(System::Object ^ content);
public void AddBeforeSelf(object content);
public void AddBeforeSelf(object? content);
member this.AddBeforeSelf : obj -> unit
Public Sub AddBeforeSelf (content As Object)

Параметры

content
Object

Объект содержимого, содержащий простое содержимое или коллекцию объектов контента, добавляемых перед этим узлом.

Исключения

InvalidOperationException

Родительский объект .null

Примеры

В следующем примере этот метод используется для добавления элемента в дерево.

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)
);
XElement child1 = xmlTree.Element("Child1");
child1.AddBeforeSelf(
    new XElement("NewChild", 10)
);
Console.WriteLine(xmlTree);

Dim xmlTree As XElement = _
        <Root>
            <Child1>1</Child1>
            <Child2>2</Child2>
            <Child3>3</Child3>
            <Child4>4</Child4>
            <Child5>5</Child5>
        </Root>

Dim child1 As XElement = xmlTree.<Child1>(0)
child1.AddBeforeSelf(New XElement("NewChild", 10))
Console.WriteLine(xmlTree)

В примере получается следующий вывод.

<Root>
  <NewChild>10</NewChild>
  <Child1>1</Child1>
  <Child2>2</Child2>
  <Child3>3</Child3>
  <Child4>4</Child4>
  <Child5>5</Child5>
</Root>

Комментарии

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

Этот метод вызовет Changed события и Changing события.

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

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

Применяется к

AddBeforeSelf(Object[])

Исходный код:
XNode.cs
Исходный код:
XNode.cs
Исходный код:
XNode.cs
Исходный код:
XNode.cs
Исходный код:
XNode.cs

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

public:
 void AddBeforeSelf(... cli::array <System::Object ^> ^ content);
public void AddBeforeSelf(params object[] content);
public void AddBeforeSelf(params object?[] content);
member this.AddBeforeSelf : obj[] -> unit
Public Sub AddBeforeSelf (ParamArray content As Object())

Параметры

content
Object[]

Список параметров объектов контента.

Исключения

InvalidOperationException

Родительский объект .null

Примеры

В следующем примере используется запрос LINQ для создания объекта IEnumerable<T>XElement, который затем передается этому методу. Это добавляет результаты запроса в дерево в нужном расположении.

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)
);
XElement child1 = xmlTree.Element("Child1");
child1.AddBeforeSelf(
    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>
            <Child1>1</Child1>
            <Child2>2</Child2>
            <Child3>3</Child3>
            <Child4>4</Child4>
            <Child5>5</Child5>
        </Root>

Dim child1 As XElement = xmlTree.<Child1>(0)
child1.AddBeforeSelf( _
    From el In srcTree.Elements() _
    Where CInt(el) > 3 _
    Select el)

Console.WriteLine(xmlTree)

В примере получается следующий вывод.

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

Комментарии

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

Этот метод вызовет Changed события и Changing события.

Хранит XContainer дочерние узлы в виде последовательно связанного XNode списка объектов. Это означает, что AddBeforeSelf метод должен пройти по списку прямых дочерних узлов в родительском контейнере. Поэтому использование этой функции может повлиять на производительность.

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

Применяется к