IRONSOFTWAREHOME
ATUALIZAÇÕES DO DESENVOLVEDOR

Listas em C# (Como funciona para desenvolvedores)

Curtis Chau
Curtis Chau
Updated: 28 de junho de 2026

Listas são estruturas de dados versáteis e dinâmicas usadas para armazenar e manipular coleções de dados em C#. Eles fazem parte do namespace System.Collections.Generic, que fornece uma variedade de classes de coleção poderosas, seguras por tipo, e objetos fortemente tipados. Este tutorial para iniciantes irá guiá-lo pelos conceitos básicos do uso de listas em C#, incluindo como criar/adicionar elementos, acessar índices específicos ou primeiras ocorrências, modificar elementos específicos e remover elementos, além de alguns casos de uso comuns.

Criando listas

Para começar a usar a classe List, você primeiro precisa incluir o namespace System.Collections.Generic em seu código:

using System.Collections.Generic;

Após adicionar o namespace genérico, crie um novo objeto List especificando o tipo de dado de todos os elementos que você deseja armazenar entre colchetes angulares (< >). Aqui está um exemplo de como criar uma lista de números inteiros:

List<int> numbers = new List<int>();

Você também pode inicializar uma lista com alguns valores iniciais ou defini-la pela coleção especificada, como neste exemplo:

List<string> fruits = new List<string> { "apple", "banana", "cherry" };

Também podemos especificar a capacidade inicial padrão da lista. A capacidade inicial especificada é a capacidade máxima padrão da lista.

Métodos de lista

Adicionando o número de elementos a uma lista

Para adicionar elementos à sua lista, use o método Add():

numbers.Add(1);     // Adds first element
numbers.Add(2);
numbers.Add(3);

Você também pode adicionar uma gama de elementos de uma coleção especificada à lista usando o método AddRange:

List<int> moreNumbers = new List<int> { 4, 5, 6 };
numbers.AddRange(moreNumbers);

Acessando elementos de lista

Você pode acessar elementos individuais de uma lista usando um índice, assim como acontece com arrays:

string firstFruit = fruits[0];          // "apple"
string secondFruit = fruits[1];         // "banana"

Lembre-se de que as listas são indexadas a partir de zero, portanto, o primeiro elemento tem índice 0. O exemplo acima armazenará o elemento na string se ele existir.

Modificando elementos da lista

Para modificar um elemento em uma lista, basta atribuir um novo valor ao elemento no índice desejado, levando em consideração o índice baseado em zero:

fruits[1] = "blueberry";

Agora, o segundo elemento na lista de frutas é "mirtilo" em vez de "banana".

Removendo elementos de uma lista

Para remover um elemento de uma lista, você pode usar o método Remove, que remove a primeira ocorrência de um elemento especificado:

fruits.Remove("apple");

Alternativamente, você pode usar o método RemoveAt para remover um elemento no índice especificado:

fruits.RemoveAt(0);

Para remover todos os elementos de uma lista, use o método Clear:

fruits.Clear();

Encontrando elementos em uma lista

Você pode usar o método Contains() para verificar se uma lista contém um elemento específico:

bool containsApple = fruits.Contains("apple");  // true

Para encontrar o índice da primeira ocorrência de um elemento, use o método IndexOf:

int appleIndex = fruits.IndexOf("apple");  // 0

Se o elemento não for encontrado, IndexOf retorna -1.

Percorrendo uma lista

Para iterar pelos elementos em uma lista, você pode usar um loop foreach:

foreach (string fruit in fruits)
{
    Console.WriteLine(fruit);
}

Alternativamente, você pode usar um loop for com a propriedade Count, que retorna o número de elementos na lista:

for (int i = 0; i < fruits.Count; i++)
{
    Console.WriteLine(fruits[i]);
}

Ordenando uma lista

Para classificar uma lista em ordem crescente, use o método Sort:

List<int> unsortedNumbers = new List<int> { 5, 2, 8, 1, 4 };
unsortedNumbers.Sort();

// Now, unsortedNumbers is { 1, 2, 4, 5, 8 }

Para classificar uma lista em ordem decrescente, você pode usar o método Sort com uma comparação personalizada:

unsortedNumbers.Sort((a, b) => b.CompareTo(a));

// Now, unsortedNumbers is { 8, 5, 4, 2, 1 }

Para classificações mais complexas, você pode implementar uma classe customizada IComparer ou usar LINQ (Language Integrated Query). O algoritmo de busca binária funciona em listas ordenadas.

Usando LINQ com Listas

O LINQ permite realizar consultas e transformações poderosas em coleções, incluindo listas. Para usar LINQ, primeiro você precisa incluir o namespace System.Linq em seu código:

using System.Linq;

Aqui estão alguns exemplos de consultas LINQ em uma lista:

Filtrar uma lista

List<int> evenNumbers = numbers.Where(x => x % 2 == 0).ToList();

Mapeamento (transformação) de elementos em uma lista

List<string> fruitNamesUpperCase = fruits.Select(x => x.ToUpper()).ToList();

Encontrando os valores mínimo e máximo em uma lista

int minValue = numbers.Min();
int maxValue = numbers.Max();

Converter uma lista em um array

Para converter uma lista em um array, você pode usar o método ToArray:

int[] numbersArray = numbers.ToArray();

Exportando dados de lista para um PDF usando o IronPDF

Nesta seção, demonstraremos como exportar os dados de uma lista para um arquivo PDF usando a biblioteca IronPDF . Isso pode ser útil quando você deseja gerar um relatório ou uma versão para impressão dos seus dados.

Primeiro, baixe e instale o pacote NuGet IronPDF em seu projeto:

PM > Install-Package IronPdf

Em seguida, inclua o namespace IronPdf em seu código:

using IronPdf;

Agora, vamos criar uma função simples que converte um List de strings em uma tabela HTML e, em seguida, a exporta para um arquivo PDF:

using System.Collections.Generic;
using System.Text;
using IronPdf;

void ExportListToPdf(List<string> data, string pdfFilePath)
{
    // Create an HTML table from the list data
    StringBuilder htmlBuilder = new StringBuilder();
    htmlBuilder.Append("<table><tr><th>Item</th></tr>");

    foreach (string item in data)
    {
        htmlBuilder.Append($"<tr><td>{item}</td></tr>");
    }

    htmlBuilder.Append("</table>");

    // Convert the HTML table to a PDF using IronPDF
    var renderer = new ChromePdfRenderer();
    PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlBuilder.ToString());

    // Save the PDF to the specified file path
    pdf.SaveAs(pdfFilePath);
}

Para usar essa função, basta chamá-la com sua lista e o caminho do arquivo PDF desejado:

List<string> fruits = new List<string> { "apple", "banana", "cherry" };
ExportListToPdf(fruits, "Fruits.pdf");

Isso irá gerar um arquivo PDF chamado "Fruits.pdf" contendo uma tabela com a lista de frutas, convertendo HTML para PDF com o IronPDF . Você pode modificar a função ExportListToPdf para atender às suas necessidades, como adicionar estilo personalizado à tabela HTML ou conteúdo adicional ao PDF.

C# List (Como Funciona Para Desenvolvedores) Figura 1 - HTML para PDF

Conclusão

Neste tutorial para iniciantes, abordamos os conceitos básicos de listas em C# e demonstramos como integrar o IronPDF para exportar dados de listas para um arquivo PDF. Ao incorporar o IronPDF em seus projetos, você pode gerar facilmente relatórios, faturas ou outros documentos imprimíveis a partir de seus projetos em C#.

O IronPDF oferece um período de teste gratuito , permitindo que você experimente suas funcionalidades antes de efetuar a compra.

Curtis Chau
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

...
Leia mais

Artigos relacionados

Key in blue circle

Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.

Your trial license will be sent to your email address

Sem limitações. 100% desbloqueado. Sem cartão de crédito.

bullet_checkedNão é necessário cartão de crédito nem criação de conta.Sem limitações. 100% desbloqueado. Sem cartão de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Agende sua demonstração ao vivo gratuita.
Booking Badge

Aprovado por milhões de engenheiros em todo o mundo.

Logotipos dos clientes da Iron Software
Agende sua consulta sem compromisso.
Preencha o formulário abaixo ou envie um e-mail para sales@ironsoftware.com
Os seus dados serão sempre mantidos em sigilo.
Aprovado por milhões de engenheiros em todo o mundo.
Logotipos dos clientes da Iron Software
Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.