XContainer.AddFirst Metod

Definition

Namnområde:: System.Xml.Linq

Sammansättningar:: System.Xml.Linq.dll, System.Xml.XDocument.dll

Sammansättningar:: netstandard.dll, System.Xml.XDocument.dll

Sammansättning:: System.Xml.XDocument.dll

Sammansättning:: System.Xml.Linq.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Lägger till det angivna innehållet som de första underordnade i det här dokumentet eller elementet.

Överlagringar

Name	Description
AddFirst(Object)	Lägger till det angivna innehållet som de första underordnade i det här dokumentet eller elementet.
AddFirst(Object[])	Lägger till det angivna innehållet som de första underordnade i det här dokumentet eller elementet.

Exempel

I följande exempel skapas två XML-träd och den här metoden används sedan för att lägga till resultatet av en fråga i ett av dem.

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("NewElement", "Content")
);
xmlTree.AddFirst(
    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>
                              <NewElement>Content</NewElement>
                          </Root>
xmlTree.AddFirst( _
    From el In srcTree.Elements _
    Where CInt(el) >= 3 _
    Select el)
Console.WriteLine(xmlTree)

Det här exemplet genererar följande utdata:

<Root>
  <Element3>3</Element3>
  <Element4>4</Element4>
  <Element5>5</Element5>
  <NewElement>Content</NewElement>
</Root>

Kommentarer

Den här metoden lägger till det nya innehållet före det befintliga innehållet i XContainer.

Mer information om giltigt innehåll som kan skickas till den här funktionen finns i Giltigt innehåll för XElement- och XDocument-objekt.

Den här metoden genererar Changed händelserna och Changing .

AddFirst(Object)

Källa:: XContainer.cs

Källa:: XContainer.cs

Källa:: XContainer.cs

Källa:: XContainer.cs

Källa:: XContainer.cs

Lägger till det angivna innehållet som de första underordnade i det här dokumentet eller elementet.

public:
 void AddFirst(System::Object ^ content);

public void AddFirst(object content);

public void AddFirst(object? content);

member this.AddFirst : obj -> unit

Public Sub AddFirst (content As Object)

Parametrar

content: Object

Ett innehållsobjekt som innehåller enkelt innehåll eller en samling innehållsobjekt som ska läggas till.

Exempel

I följande exempel skapas två XML-träd. Den här metoden används för att lägga till ett XElement objekt som det första elementet i ett av dem. Den lägger också till resultatet av en LINQ-fråga i XML-trädet.

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)
);
xmlTree.AddFirst(new XElement("NewChild", "new content"));
xmlTree.AddFirst(
    from el in srcTree.Elements()
    where (int)el > 3
    select el
);
// Even though Child9 does not exist in srcTree, the following statement will not
// throw an exception, and nothing will be added to xmlTree
xmlTree.AddFirst(srcTree.Element("Child9"));
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>

xmlTree.AddFirst(New XElement("NewChild", "new content"))
xmlTree.AddFirst( _
    From el In srcTree.Elements() _
    Where CInt(el) > 3 _
    Select el _
)
' Even though Child9 does not exist in srcTree, the following statement will not
' throw an exception, and nothing will be added to xmlTree
xmlTree.AddFirst(srcTree.<Child9>)
Console.WriteLine(xmlTree)

Det här exemplet genererar följande utdata:

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

Kommentarer

Den här metoden lägger till det nya innehållet före det befintliga innehållet i XContainer.

Mer information om giltigt innehåll som kan skickas till den här funktionen finns i Giltigt innehåll för XElement- och XDocument-objekt.

Den här metoden genererar Changed händelserna och Changing .

Se även

Gäller för

AddFirst(Object[])

Källa:: XContainer.cs

Källa:: XContainer.cs

Källa:: XContainer.cs

Källa:: XContainer.cs

Källa:: XContainer.cs

Lägger till det angivna innehållet som de första underordnade i det här dokumentet eller elementet.

public:
 void AddFirst(... cli::array <System::Object ^> ^ content);

public void AddFirst(params object[] content);

public void AddFirst(params object?[] content);

member this.AddFirst : obj[] -> unit

Public Sub AddFirst (ParamArray content As Object())

Parametrar

content: Object[]

En parameterlista över innehållsobjekt.

Undantag

InvalidOperationException

Den överordnade är null.

Exempel

I följande exempel skapas två XML-träd och den här metoden används för att lägga till ett XElement objekt som det första elementet i ett av dem. Den lägger också till resultatet av en LINQ-fråga i XML-trädet.

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)
);
xmlTree.AddFirst(new XElement("NewChild", "new content"));
xmlTree.AddFirst(
    from el in srcTree.Elements()
    where (int)el > 3
    select el
);
// Even though Child9 does not exist in srcTree, the following statement will not
// throw an exception, and nothing will be added to xmlTree.
xmlTree.AddFirst(srcTree.Element("Child9"));
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>

xmlTree.AddFirst(New XElement("NewChild", "new content"))
xmlTree.AddFirst( _
    From el In srcTree.Elements() _
    Where CInt(el) > 3 _
    Select el _
)
' Even though Child9 does not exist in srcTree, the following statement will not
' throw an exception, and nothing will be added to xmlTree.
xmlTree.AddFirst(srcTree.<Child9>)
Console.WriteLine(xmlTree)

Det här exemplet genererar följande utdata:

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

Kommentarer

Den här metoden lägger till det nya innehållet före det befintliga innehållet i XContainer.

Mer information om giltigt innehåll som kan skickas till den här funktionen finns i Giltigt innehåll för XElement- och XDocument-objekt.

Den här metoden genererar Changed händelserna och Changing .

Se även

Gäller för

Feedback

Var den här sidan till hjälp?