XContainer.AddFirst Método
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Adiciona o conteúdo especificado como os primeiros filhos desse documento ou elemento.
AddFirst(Object) |
Adiciona o conteúdo especificado como os primeiros filhos desse documento ou elemento. |
AddFirst(Object[]) |
Adiciona o conteúdo especificado como os primeiros filhos desse documento ou elemento. |
O exemplo a seguir cria duas árvores XML e usa esse método para adicionar os resultados de uma consulta a uma delas.
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)
Esse exemplo gera a saída a seguir:
<Root>
<Element3>3</Element3>
<Element4>4</Element4>
<Element5>5</Element5>
<NewElement>Content</NewElement>
</Root>
Esse método adiciona o novo conteúdo antes do conteúdo existente do XContainer.
Para obter detalhes sobre o conteúdo válido que pode ser passado para essa função, consulte Conteúdo válido de objetos XElement e XDocument.
Esse método gerará os ChangedChanging eventos e .
- Origem:
- XContainer.cs
- Origem:
- XContainer.cs
- Origem:
- XContainer.cs
Adiciona o conteúdo especificado como os primeiros filhos desse documento ou elemento.
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)
Parâmetros
- content
- Object
Um objeto de conteúdo que contém o conteúdo simples ou uma coleção de objetos de conteúdo a ser adicionada.
Exemplos
O exemplo a seguir cria duas árvores XML, usa esse método para adicionar um XElement objeto como o primeiro elemento a uma delas. Ele também adiciona os resultados de uma consulta LINQ à árvore 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);
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)
Esse exemplo gera a saída a seguir:
<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>
Comentários
Esse método adiciona o novo conteúdo antes do conteúdo existente do XContainer.
Para obter detalhes sobre o conteúdo válido que pode ser passado para essa função, consulte Conteúdo válido de objetos XElement e XDocument.
Esse método gerará os ChangedChanging eventos e .
Confira também
Aplica-se a
.NET 9 e outras versões
Produto | Versões |
---|---|
.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 |
- Origem:
- XContainer.cs
- Origem:
- XContainer.cs
- Origem:
- XContainer.cs
Adiciona o conteúdo especificado como os primeiros filhos desse documento ou elemento.
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())
Parâmetros
- content
- Object[]
Uma lista de parâmetros de objetos de conteúdo.
Exceções
O pai é null
.
Exemplos
O exemplo a seguir cria duas árvores XML e usa esse método para adicionar um XElement objeto como o primeiro elemento a uma delas. Ele também adiciona os resultados de uma consulta LINQ à árvore 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);
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)
Esse exemplo gera a saída a seguir:
<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>
Comentários
Esse método adiciona o novo conteúdo antes do conteúdo existente do XContainer.
Para obter detalhes sobre o conteúdo válido que pode ser passado para essa função, consulte Conteúdo válido de objetos XElement e XDocument.
Esse método gerará os ChangedChanging eventos e .
Confira também
Aplica-se a
.NET 9 e outras versões
Produto | Versões |
---|---|
.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 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: