Прочитать на английском

Поделиться через


XNode.AddBeforeSelf Метод

Определение

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

Перегрузки

AddBeforeSelf(Object)

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

AddBeforeSelf(Object[])

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

Примеры

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

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)  
);  
XElement child1 = xmlTree.Element("Child1");  
child1.AddBeforeSelf(  
    from el in srcTree.Elements()  
    where (int)el > 3  
    select el  
);  
Console.WriteLine(xmlTree);  

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

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

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

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

Параметры

content
Object

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

Исключения

Родительским объектом является null.

Примеры

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

C#
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);  

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

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

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

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

.NET 10 и другие версии
Продукт Версии
.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

AddBeforeSelf(Object[])

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

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

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

Параметры

content
Object[]

Список параметров объектов содержимого.

Исключения

Родительским объектом является null.

Примеры

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

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)  
);  
XElement child1 = xmlTree.Element("Child1");  
child1.AddBeforeSelf(  
    from el in srcTree.Elements()  
    where (int)el > 3  
    select el  
);  
Console.WriteLine(xmlTree);  

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

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

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

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

.NET 10 и другие версии
Продукт Версии
.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