A ordenação é uma operação fundamental em qualquer linguagem de programação, e o método OrderBy do C# é uma ferramenta poderosa para organizar elementos em coleções. Seja trabalhando com arrays, listas ou outras estruturas enumeráveis, entender como usar o OrderBy pode melhorar muito a legibilidade e a funcionalidade do seu código.
Mais adiante neste artigo, apresentaremos a biblioteca IronPDF da Iron Software e como podemos usar o método OrderBy do LINQ com o IronPDF para gerar PDFs formatados e classificados.
O método OrderBy é parte da biblioteca LINQ (Language-Integrated Query) em C# e é especificamente projetado para ordenar elementos em ordem crescente; Como essa é a forma padrão de classificar dados, não há necessidade de uma palavra-chave ascendente.
Em C#, existem duas maneiras de aplicar esse método: por meio da sintaxe de método ou da sintaxe de consulta. Usaremos a sintaxe do método, pois é simples:
var sortedCollection = collection.OrderBy(item => item.OrderByProperty);Dim sortedCollection = collection.OrderBy(Function(item) item.OrderByProperty)Aqui, o collection é a coleção fonte IEnumerable que você deseja ordenar, e OrderByProperty é a propriedade ou expressão pela qual você deseja ordenar os elementos. A expressão lambda dentro do OrderBy especifica o critério de ordenação.
Para ordenar em ordem decrescente, você pode usar o método OrderByDescending usando a sintaxe baseada em método:
var sortedCollectionDesc = collection.OrderByDescending(item => item.OrderByProperty);Dim sortedCollectionDesc = collection.OrderByDescending(Function(item) item.OrderByProperty)Em cenários do mundo real, muitas vezes é necessário classificar uma coleção com base em vários critérios. OrderBy permite isso encadeando múltiplos ThenBy ou chamadas de ThenByDescending:
var multiSortedCollection = collection
.OrderBy(item => item.OrderByProperty1)
.ThenByDescending(item => item.OrderByProperty2);Dim multiSortedCollection = collection.OrderBy(Function(item) item.OrderByProperty1).ThenByDescending(Function(item) item.OrderByProperty2)Neste exemplo, a coleção é primeiro ordenada por OrderByProperty1 em ordem crescente. Depois, para elementos com o mesmo valor de OrderByProperty1, é ordenada por OrderByProperty2 em ordem decrescente.
Para requisitos de classificação mais complexos, você pode usar comparadores personalizados. O método OrderBy permite que você passe uma implementação de IComparer<t>, como mostrado no exemplo a seguir:
var customSortedCollection = collection.OrderBy(item => item.Property, new CustomComparer());Dim customSortedCollection = collection.OrderBy(Function(item) item.Property, New CustomComparer())Aqui, CustomComparer é uma classe que implementa a interface IComparer<t>, fornecendo lógica personalizada para comparar elementos.
using System;
using System.Linq;
using System.Collections.Generic;
class Program
{
static void Main()
{
List<int> numbers = new List<int> { 5, 2, 8, 1, 7 };
var sortedNumbers = numbers.OrderBy(num => num);
Console.WriteLine("Sorted Numbers:");
foreach (var number in sortedNumbers)
{
Console.WriteLine(number);
}
}
}Imports System
Imports System.Linq
Imports System.Collections.Generic
Friend Class Program
Shared Sub Main()
Dim numbers As New List(Of Integer) From {5, 2, 8, 1, 7}
Dim sortedNumbers = numbers.OrderBy(Function(num) num)
Console.WriteLine("Sorted Numbers:")
For Each number In sortedNumbers
Console.WriteLine(number)
Next number
End Sub
End ClassNeste exemplo, uma lista de inteiros é ordenada em ordem crescente usando OrderBy.
using System;
using System.Linq;
using System.Collections.Generic;
class Program
{
static void Main()
{
List<string> names = new List<string> { "Alice", "Charlie", "Bob", "David" };
var sortedNames = names.OrderBy(name => name);
Console.WriteLine("Sorted Names:");
foreach (var name in sortedNames)
{
Console.WriteLine(name);
}
}
}Imports System
Imports System.Linq
Imports System.Collections.Generic
Friend Class Program
Shared Sub Main()
Dim names As New List(Of String) From {"Alice", "Charlie", "Bob", "David"}
Dim sortedNames = names.OrderBy(Function(name) name)
Console.WriteLine("Sorted Names:")
For Each name In sortedNames
Console.WriteLine(name)
Next name
End Sub
End ClassEste exemplo demonstra como ordenar uma lista de strings em ordem alfabética crescente.
using System;
using System.Linq;
using System.Collections.Generic;
class Person
{
public string FirstName { get; set; }
public string LastName { get; set; }
public int Age { get; set; }
}
class Program
{
static void Main()
{
List<Person> people = new List<Person>
{
new Person { FirstName = "John", LastName = "Doe", Age = 30 },
new Person { FirstName = "Alice", LastName = "Smith", Age = 25 },
new Person { FirstName = "Bob", LastName = "Johnson", Age = 35 }
};
var sortedPeople = people.OrderBy(person => person.Age);
Console.WriteLine("Sorted People by Age:");
foreach (var person in sortedPeople)
{
Console.WriteLine($"{person.FirstName} {person.LastName}, Age: {person.Age}");
}
}
}Imports System
Imports System.Linq
Imports System.Collections.Generic
Friend Class Person
Public Property FirstName() As String
Public Property LastName() As String
Public Property Age() As Integer
End Class
Friend Class Program
Shared Sub Main()
Dim people As New List(Of Person) From {
New Person With {
.FirstName = "John",
.LastName = "Doe",
.Age = 30
},
New Person With {
.FirstName = "Alice",
.LastName = "Smith",
.Age = 25
},
New Person With {
.FirstName = "Bob",
.LastName = "Johnson",
.Age = 35
}
}
Dim sortedPeople = people.OrderBy(Function(person) person.Age)
Console.WriteLine("Sorted People by Age:")
For Each person In sortedPeople
Console.WriteLine($"{person.FirstName} {person.LastName}, Age: {person.Age}")
Next person
End Sub
End ClassNeste exemplo, uma lista de objetos Person personalizados é ordenada com base na propriedade Age em ordem crescente.
A seguinte saída é visível no console:
Ao lidar com propriedades de string, convém garantir a ordenação sem distinção entre maiúsculas e minúsculas:
var sortedPeopleByName = people.OrderBy(person => person.LastName, StringComparer.OrdinalIgnoreCase);Dim sortedPeopleByName = people.OrderBy(Function(person) person.LastName, StringComparer.OrdinalIgnoreCase)Este exemplo usa o StringComparer.OrdinalIgnoreCase para realizar uma ordenação sem distinção entre maiúsculas e minúsculas com base na propriedade LastName.
Embora o LINQ ofereça uma maneira concisa de classificar coleções, é essencial considerar as implicações de desempenho, especialmente para conjuntos de dados grandes. Para cenários críticos de desempenho, você pode explorar alternativas como ordenação in-place usando o método List<t>.Sort.
Descubra as funcionalidades do IronPDF dentro da biblioteca C# PDF da Iron Software , que ajuda a ler e gerar documentos PDF. Ele consegue converter facilmente documentos formatados com informações de estilo para PDF. O IronPDF pode gerar PDFs a partir de strings HTML, ou pode baixar o HTML de uma URL e então gerar os PDFs.
O IronPDF se destaca na conversão de HTML para PDF , preservando todos os layouts e estilos. Ele pode gerar PDFs a partir de diversos conteúdos da web, como relatórios, faturas e documentação. A ferramenta funciona com arquivos HTML, URLs e strings HTML para criar arquivos PDF.
using IronPdf;
class Program
{
static void Main(string[] args)
{
var renderer = new ChromePdfRenderer();
// 1. Convert HTML String to PDF
var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");
// 2. Convert HTML File to PDF
var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");
// 3. Convert URL to PDF
var url = "http://ironpdf.com"; // Specify the URL
var pdfFromUrl = renderer.RenderUrlAsPdf(url);
pdfFromUrl.SaveAs("URLToPDF.pdf");
}
}Imports IronPdf
Friend Class Program
Shared Sub Main(ByVal args() As String)
Dim renderer = New ChromePdfRenderer()
' 1. Convert HTML String to PDF
Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")
' 2. Convert HTML File to PDF
Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")
' 3. Convert URL to PDF
Dim url = "http://ironpdf.com" ' Specify the URL
Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
pdfFromUrl.SaveAs("URLToPDF.pdf")
End Sub
End ClassO IronPDF pode ser instalado usando o console do gerenciador de pacotes NuGet ou o gerenciador de pacotes do Visual Studio.
Você também pode instalar o IronPDF usando o Gerenciador de Pacotes NuGet pesquisando "IronPDF" na barra de pesquisa.
Abaixo está o código para gerar um relatório em PDF usando uma string HTML e o gerador IronPDF :
// See https://aka.ms/new-console-template for more information
using IronPdf;
using System;
using System.Collections.Generic;
using System.Linq;
class Person
{
public string FirstName { get; set; }
public string LastName { get; set; }
public int Age { get; set; }
}
class Program
{
static void Main()
{
List<Person> people = new List<Person>
{
new Person { FirstName = "John", LastName = "Doe", Age = 30 },
new Person { FirstName = "Alice", LastName = "Smith", Age = 25 },
new Person { FirstName = "Bob", LastName = "Johnson", Age = 35 }
};
// Sort people by age
var sortedPeople = people.OrderBy(person => person.Age);
string name = "Sam";
var count = people.Count;
// Generate an HTML string
string content = $@"<!DOCTYPE html>
<html>
<body>
<h1>Hello, {name}!</h1>
<p>You have {count} people sorted by Age.</p>
" + string.Join("\n", sortedPeople.Select(person => $"{person.FirstName} {person.LastName}, Age: {person.Age}"))
+ @"
</body>
</html>";
// Create a new PDF document and save it
var pdfDocument = new ChromePdfRenderer();
pdfDocument.RenderHtmlAsPdf(content).SaveAs("personByAge.pdf");
}
}' See https://aka.ms/new-console-template for more information
Imports IronPdf
Imports System
Imports System.Collections.Generic
Imports System.Linq
Class Person
Public Property FirstName As String
Public Property LastName As String
Public Property Age As Integer
End Class
Class Program
Shared Sub Main()
Dim people As New List(Of Person) From {
New Person With {.FirstName = "John", .LastName = "Doe", .Age = 30},
New Person With {.FirstName = "Alice", .LastName = "Smith", .Age = 25},
New Person With {.FirstName = "Bob", .LastName = "Johnson", .Age = 35}
}
' Sort people by age
Dim sortedPeople = people.OrderBy(Function(person) person.Age)
Dim name As String = "Sam"
Dim count = people.Count
' Generate an HTML string
Dim content As String = $"<!DOCTYPE html>
<html>
<body>
<h1>Hello, {name}!</h1>
<p>You have {count} people sorted by Age.</p>
" & String.Join(vbLf, sortedPeople.Select(Function(person) $"{person.FirstName} {person.LastName}, Age: {person.Age}")) & "
</body>
</html>"
' Create a new PDF document and save it
Dim pdfDocument As New ChromePdfRenderer()
pdfDocument.RenderHtmlAsPdf(content).SaveAs("personByAge.pdf")
End Sub
End ClassAqui, estamos primeiro gerando uma string HTML de sortedPeople que é ordenada em ordem crescente com toda a formatação necessária para os relatórios. Em seguida, usamos o IronPDF para gerar um documento PDF. Usamos o método RenderHtmlAsPdf para converter a string HTML em um documento PDF.
O seguinte resultado está disponível no PDF:
Uma chave de avaliação pode ser obtida em Licença de Avaliação do IronPDF . Essa chave precisa ser inserida no arquivo appsettings.json.
"IronPdf.LicenseKey": "your license key"Forneça seu e-mail para obter uma licença de avaliação.
O método OrderBy em C# é uma ferramenta versátil para classificar coleções com base em diversos critérios. Quer você esteja classificando em ordem crescente ou decrescente, por um ou vários critérios, ou usando comparadores personalizados, dominar o OrderBy pode melhorar significativamente a clareza e a eficiência do seu código.
Em conjunto com a biblioteca IronPDF para geração de documentos PDF , forma uma ótima combinação para gerar uma coleção bem formatada e organizada em formato de documento.
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.
IronPDF faz parte do IRON SUITE.
10 produtos de API .NET para seus documentos de escritório
Quando você precisa que seu PDF tenha a aparência de HTML, rapidamente.
