XContainer.AddFirst Metodo

Definizione

Aggiunge il contenuto specificato come primi figli di questo documento o elemento.

Overload

AddFirst(Object)

Aggiunge il contenuto specificato come primi figli di questo documento o elemento.

AddFirst(Object[])

Aggiunge il contenuto specificato come primi figli di questo documento o elemento.

Esempio

Nell'esempio seguente vengono creati due alberi XML e quindi viene utilizzato questo metodo per aggiungere i risultati di una query a uno di essi.

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

Nell'esempio viene prodotto l'output seguente:

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

Commenti

Questo metodo aggiunge il nuovo contenuto prima del contenuto esistente di XContainer.

Per informazioni dettagliate sul contenuto valido che può essere passato a questa funzione, vedere Contenuto valido di oggetti XElement e XDocument.

Questo metodo genererà gli Changed eventi e Changing .

AddFirst(Object)

Origine:
XContainer.cs
Origine:
XContainer.cs
Origine:
XContainer.cs

Aggiunge il contenuto specificato come primi figli di questo documento o elemento.

public void AddFirst (object content);
public void AddFirst (object? content);

Parametri

content
Object

Oggetto contenuto che include contenuto semplice o una raccolta di oggetti contenuto da aggiungere.

Esempio

Nell'esempio seguente vengono creati due alberi XML, che utilizza questo metodo per aggiungere un XElement oggetto come primo elemento a uno di essi. Aggiunge inoltre i risultati di una query LINQ all'albero XML.

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

Nell'esempio viene prodotto l'output seguente:

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

Commenti

Questo metodo aggiunge il nuovo contenuto prima del contenuto esistente di XContainer.

Per informazioni dettagliate sul contenuto valido che può essere passato a questa funzione, vedere Contenuto valido di oggetti XElement e XDocument.

Questo metodo genererà gli Changed eventi e Changing .

Vedi anche

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.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
.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

AddFirst(Object[])

Origine:
XContainer.cs
Origine:
XContainer.cs
Origine:
XContainer.cs

Aggiunge il contenuto specificato come primi figli di questo documento o elemento.

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

Parametri

content
Object[]

Elenco di parametri di oggetti contenuto.

Eccezioni

L'oggetto padre è null.

Esempio

Nell'esempio seguente vengono creati due alberi XML e viene utilizzato questo metodo per aggiungere un XElement oggetto come primo elemento a uno di essi. Aggiunge inoltre i risultati di una query LINQ all'albero XML.

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

Nell'esempio viene prodotto l'output seguente:

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

Commenti

Questo metodo aggiunge il nuovo contenuto prima del contenuto esistente di XContainer.

Per informazioni dettagliate sul contenuto valido che può essere passato a questa funzione, vedere Contenuto valido di oggetti XElement e XDocument.

Questo metodo genererà gli Changed eventi e Changing .

Vedi anche

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.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
.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