XNode.AddBeforeSelf Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Xml.Linq

Zestawy:: System.Xml.Linq.dll, System.Xml.XDocument.dll

Zestawy:: netstandard.dll, System.Xml.XDocument.dll

Zestaw:: System.Xml.XDocument.dll

Zestaw:: System.Xml.Linq.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Dodaje określoną zawartość bezpośrednio przed tym węzłem.

Przeciążenia

AddBeforeSelf(Object)	Dodaje określoną zawartość bezpośrednio przed tym węzłem.
AddBeforeSelf(Object[])	Dodaje określoną zawartość bezpośrednio przed tym węzłem.

Przykłady

W poniższym przykładzie użyto zapytania LINQ, aby utworzyć element IEnumerable<T>XElement, który następnie przekazuje do tej metody. Spowoduje to dodanie wyników zapytania do drzewa w żądanej lokalizacji.

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:

XML

<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 przekazać do tej metody, zobacz Prawidłowa zawartość elementów XElement i XDocument Objects.

Ta metoda spowoduje wywołanie zdarzeń Changed i Changing .

Obiekt XContainer przechowuje swoje notatki podrzędne jako połączoną ze singly listą XNode obiektów. Oznacza to, że AddBeforeSelf metoda musi przechodzić przez listę bezpośrednich węzłów podrzędnych w kontenerze nadrzędnym. W związku z tym użycie tej metody może mieć wpływ na wydajność.

AddBeforeSelf(Object)

Źródło:: XNode.cs

Źródło:: XNode.cs

Źródło:: XNode.cs

Dodaje określoną zawartość bezpośrednio przed tym węzłem.

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)

Parametry

content: Object

Obiekt zawartości zawierający prostą zawartość lub kolekcję obiektów zawartości do dodania przed tym węzłem.

Wyjątki

InvalidOperationException

Elementem nadrzędnym jest null.

Przykłady

W poniższym przykładzie użyto tej metody, aby dodać element do drzewa.

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:

XML

<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 przekazać do tej metody, zobacz Prawidłowa zawartość elementów XElement i XDocument Objects.

Ta metoda spowoduje wywołanie zdarzeń Changed i Changing .

Obiekt XContainer przechowuje węzły podrzędne jako połączoną ze sobą listę XNode obiektów. Oznacza to, że AddBeforeSelf metoda musi przechodzić przez listę bezpośrednich węzłów podrzędnych w kontenerze nadrzędnym. W związku z tym użycie tej metody może mieć wpływ na wydajność.

Zobacz też

LINQ to XML — przegląd

Dotyczy

.NET 10 i inne wersje

Produkt	Wersje
.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[])

Źródło:: XNode.cs

Źródło:: XNode.cs

Źródło:: XNode.cs

Dodaje określoną zawartość bezpośrednio przed tym węzłem.

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())

Parametry

content: Object[]

Lista parametrów obiektów zawartości.

Wyjątki

InvalidOperationException

Elementem nadrzędnym jest null.

Przykłady

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:

XML

<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 przekazać do tej metody, zobacz Prawidłowa zawartość elementów XElement i XDocument Objects.

Ta metoda spowoduje wywołanie zdarzeń Changed i Changing .

Zobacz też

LINQ to XML — przegląd

Dotyczy

.NET 10 i inne wersje

Produkt	Wersje
.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

Udostępnij za pośrednictwem

XNode.AddBeforeSelf Metoda

Definicja

Przeciążenia

Przykłady

Uwagi

AddBeforeSelf(Object)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

AddBeforeSelf(Object[])

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Dodatkowe zasoby