XNode.AddBeforeSelf Метод

  • Ссылка

Определение

Пространство имен:
System.Xml.Linq
Сборка:
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)

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

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[])

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

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 метод должен пройти по списку прямых дочерних узлов в родительском контейнере. Поэтому использование этой функции может повлиять на производительность.

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

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