XNode.AddBeforeSelf Metoda

Definicja

Dodaje określoną zawartość bezpośrednio przed tym węzłem.Adds the specified content immediately before this node.

Przeciążenia

AddBeforeSelf(Object)

Dodaje określoną zawartość bezpośrednio przed tym węzłem.Adds the specified content immediately before this node.

AddBeforeSelf(Object[])

Dodaje określoną zawartość bezpośrednio przed tym węzłem.Adds the specified content immediately before this node.

Przykłady

Poniższy przykład używa zapytania LINQ do utworzenia IEnumerable<T> XElementelementu, który następnie przekazuje do tej metody.The following example uses a LINQ query to create an IEnumerable<T> of XElement, which it then passes to this method. Spowoduje to dodanie wyników zapytania do drzewa w żądanej lokalizacji.This adds the results of a query to the tree in the desired location.

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)  

Ten przykład generuje następujące wyniki:This example produces the following output:

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

Uwagi

Aby uzyskać szczegółowe informacje o prawidłowej zawartości, którą można przesłać do tej metody, zobacz prawidłową zawartość obiektów XElement i XDocument.For details about the valid content that can be passed to this method, see Valid Content of XElement and XDocument Objects.

Ta metoda spowoduje podnoszenie Changed poziomu Changing i zdarzeń.This method will raise the Changed and Changing events.

Zapisuje notatki podrzędne jako pojedynczo połączoną XNode listę obiektów. XContainerThe XContainer stores its child notes as a singly-linked list of XNode objects. Oznacza to, że AddBeforeSelf Metoda musi przejść na listę bezpośrednich węzłów podrzędnych w kontenerze nadrzędnym.This means that the AddBeforeSelf method must traverse the list of direct child nodes under the parent container. W związku z tym ta metoda może mieć wpływ na wydajność.Therefore, using this method might affect your performance.

AddBeforeSelf(Object)

Dodaje określoną zawartość bezpośrednio przed tym węzłem.Adds the specified content immediately before this node.

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

Parametry

content
Object

Obiekt zawartości, który zawiera prostą zawartość lub kolekcję obiektów zawartości, które mają zostać dodane przed tym węzłem.A content object that contains simple content or a collection of content objects to be added before this node.

Wyjątki

Element nadrzędny to null.The parent is null.

Przykłady

Poniższy przykład używa tej metody, aby dodać element do drzewa.The following example uses this method to add an element into the tree.

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)  

Ten przykład generuje następujące wyniki:This example produces the following output:

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

Uwagi

Aby uzyskać szczegółowe informacje o prawidłowej zawartości, którą można przesłać do tej metody, zobacz prawidłową zawartość obiektów XElement i XDocument.For details about the valid content that can be passed to this method, see Valid Content of XElement and XDocument Objects.

Ta metoda spowoduje podnoszenie Changed poziomu Changing i zdarzeń.This method will raise the Changed and the Changing events.

Przechowuje węzły podrzędne jako pojedynczo połączoną XNode listę obiektów. XContainerThe XContainer stores its child nodes as a singly-linked list of XNode objects. Oznacza to, że AddBeforeSelf Metoda musi przejść na listę bezpośrednich węzłów podrzędnych w kontenerze nadrzędnym.This means that the AddBeforeSelf method must traverse the list of direct child nodes under the parent container. W związku z tym ta metoda może mieć wpływ na wydajność.Therefore, using this method might affect your performance.

Zobacz też

AddBeforeSelf(Object[])

Dodaje określoną zawartość bezpośrednio przed tym węzłem.Adds the specified content immediately before this node.

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

Parametry

content
Object[]

Lista parametrów obiektów zawartości.A parameter list of content objects.

Wyjątki

Element nadrzędny to null.The parent is null.

Przykłady

Poniższy przykład używa zapytania LINQ do utworzenia IEnumerable<T> XElementelementu, który następnie przekazuje do tej metody.The following example uses a LINQ query to create an IEnumerable<T> of XElement, which it then passes to this method. Spowoduje to dodanie wyników zapytania do drzewa w żądanej lokalizacji.This adds the results of a query to the tree in the desired location.

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)  

Ten przykład generuje następujące wyniki:This example produces the following output:

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

Uwagi

Aby uzyskać szczegółowe informacje o prawidłowej zawartości, którą można przesłać do tej metody, zobacz prawidłową zawartość obiektów XElement i XDocument.For details about the valid content that can be passed to this method, see Valid Content of XElement and XDocument Objects.

Ta metoda spowoduje podnoszenie Changed poziomu Changing i zdarzeń.This method will raise the Changed and the Changing events.

Przechowuje węzły podrzędne jako pojedynczo połączoną XNode listę obiektów. XContainerThe XContainer stores its child nodes as a singly-linked list of XNode objects. Oznacza to, że AddBeforeSelf Metoda musi przejść na listę bezpośrednich węzłów podrzędnych w kontenerze nadrzędnym.This means that the AddBeforeSelf method must traverse the list of direct child nodes under the parent container. Z tego względu korzystanie z tej funkcji może mieć wpływ na wydajność.Therefore, using this function might affect your performance.

Zobacz też

Dotyczy