Ícone de mensagem
Ir para o conteúdo do rodapé
  1. IronPDF
  2. Blog do IronPDF
  3. Ajuda do .NET
  4. Objeto anônimo em C#
AJUDA DO .NET

Objetos anônimos em C# (Como funciona para desenvolvedores)

Curtis Chau
Curtis Chau
Atualizado:

Introdução ao Objeto Anônimo

Em C#, os tipos anônimos fornecem um mecanismo para encapsular propriedades públicas somente leitura em um único objeto de tipo anônimo sem a necessidade de definir explicitamente uma declaração de classe formal. São úteis para criar estruturas de dados de uso único. Esses são tipos gerados pelo compilador que derivam diretamente de System.Object, encapsulando propriedades de objetos de forma eficiente e servindo como contêineres de dados leves e imutáveis. Esses tipos são classes seladas onde o compilador infere e gera automaticamente o nome do tipo, que permanece inacessível no nível do código-fonte. Também vamos descobrir o IronPDF como uma biblioteca PDF para projetos .NET .

Principais características

  • Os tipos anônimos têm capacidades estritamente limitadas:
  • As propriedades são implementadas automaticamente como públicas e somente leitura dentro da definição de propriedade de um tipo anônimo.
  • Os usuários não podem definir explicitamente métodos, eventos ou outros membros de classe, como os métodos Equals ou GetHashCode, dentro delas.
  • Não pode ser inicializado com valores nulos, funções anônimas ou tipos ponteiro, garantindo a integridade dos tipos anônimos.

Casos de uso comuns

Operações LINQ

Objetos de tipo de dados anônimos se destacam em expressões de consulta LINQ, particularmente em cláusulas select para objetos de tipo anônimo, onde retornam com eficiência subconjuntos de propriedades específicos de objetos maiores. Essa abordagem otimiza o uso da memória criando objetos temporários que contêm apenas os dados necessários.

Agrupamento de dados temporários

Elas servem como contêineres eficientes para estruturas de dados temporárias, quando a criação de uma classe formal seria excessiva. Isso é particularmente útil para transformações de dados de curta duração ou cálculos intermediários.

Encapsulamento de propriedade

O tipo de dados anônimo oferece uma maneira clara de agrupar propriedades de objetos relacionados usando propriedades somente leitura. O compilador garante a segurança de tipos, mantendo ao mesmo tempo uma sintaxe concisa para o acesso às propriedades.

Sintaxe e Estrutura

A criação de tipos anônimos segue um padrão específico usando a palavra-chave var juntamente com o operador new e a sintaxe de inicialização de objeto. O compilador gera automaticamente um nome de tipo que permanece inacessível no nível do código-fonte.

var person = new { FirstName = "Iron", LastName = "Dev", Age = 35 }; // public int age in this anonymous type
var person = new { FirstName = "Iron", LastName = "Dev", Age = 35 }; // public int age in this anonymous type
Private person = New With {
	Key .FirstName = "Iron",
	Key .LastName = "Dev",
	Key .Age = 35
}
$vbLabelText   $csharpLabel

Regras de inicialização de propriedades

O compilador impõe regras rígidas para a inicialização de propriedades em tipos anônimos. Todas as propriedades devem ser inicializadas durante a criação do objeto e não podem receber valores nulos ou ponteiros. Uma vez inicializadas, os valores das propriedades podem ser acessados ​​usando a notação de ponto padrão, mas não podem ser modificados após a inicialização devido à sua natureza somente leitura.

Inferência e Correspondência de Tipos

var person1 = new { Name = "Iron", Age = 30 };
var person2 = new { Name = "Dev", Age = 25 };
var person1 = new { Name = "Iron", Age = 30 };
var person2 = new { Name = "Dev", Age = 25 };
Dim person1 = New With {
	Key .Name = "Iron",
	Key .Age = 30
}
Dim person2 = New With {
	Key .Name = "Dev",
	Key .Age = 25
}
$vbLabelText   $csharpLabel

O compilador gera informações de tipo idênticas para tipos anônimos com nomes de propriedade, tipos e ordem correspondentes. Isso permite a compatibilidade de tipos entre instâncias, que podem ser usadas em coleções ou passadas como parâmetros de método dentro do mesmo assembly.

Tipos Anônimos Aninhados

Os tipos de dados anônimos suportam estruturas aninhadas complexas com propriedades de objeto do tipo anônimo. Isso é útil para a criação de representações hierárquicas de dados:

var student = new {
    Id = 1,
    PersonalInfo = new {
        Name = "James",
        Contact = new {
            Email = "james@email.com",
            Phone = "123-456-7890"
        }
    },
    Grades = new { Math = 95, Science = 88 }
};
var student = new {
    Id = 1,
    PersonalInfo = new {
        Name = "James",
        Contact = new {
            Email = "james@email.com",
            Phone = "123-456-7890"
        }
    },
    Grades = new { Math = 95, Science = 88 }
};
Dim student = New With {
	Key .Id = 1,
	Key .PersonalInfo = New With {
		Key .Name = "James",
		Key .Contact = New With {
			Key .Email = "james@email.com",
			Key .Phone = "123-456-7890"
		}
	},
	Key .Grades = New With {
		Key .Math = 95,
		Key .Science = 88
	}
}
$vbLabelText   $csharpLabel

Operações com Coleções

Os tipos anônimos se destacam em cenários que envolvem manipulação de coleções e transformação de dados:

var items = new[] {
    new { ProductId = 1, Name = "Laptop", Price = 1200.00m },
    new { ProductId = 2, Name = "Mouse", Price = 25.99m },
    new { ProductId = 3, Name = "Keyboard", Price = 45.50m }
};
var items = new[] {
    new { ProductId = 1, Name = "Laptop", Price = 1200.00m },
    new { ProductId = 2, Name = "Mouse", Price = 25.99m },
    new { ProductId = 3, Name = "Keyboard", Price = 45.50m }
};
Dim items = {
	New With {
		Key .ProductId = 1,
		Key .Name = "Laptop",
		Key .Price = 1200.00D
	},
	New With {
		Key .ProductId = 2,
		Key .Name = "Mouse",
		Key .Price = 25.99D
	},
	New With {
		Key .ProductId = 3,
		Key .Name = "Keyboard",
		Key .Price = 45.50D
	}
}
$vbLabelText   $csharpLabel

IronPDF: Biblioteca PDF em C

IronPDF é uma biblioteca poderosa para gerar, editar e gerenciar documentos PDF em aplicações .NET . Ao trabalhar com C#, os desenvolvedores frequentemente usam objetos anônimos para estruturas de dados leves e ad hoc, especialmente em cenários onde a criação de uma classe inteira não é necessária. Esses objetos anônimos podem ser utilizados perfeitamente com o IronPDF para criar documentos PDF dinamicamente . Isso ajuda a criar uma solução flexível para fluxos de trabalho rápidos de conversão de dados em PDF. Aqui está um exemplo para ilustrar como o IronPDF funciona com objetos anônimos:

Exemplo: Usando objetos anônimos para preencher um PDF

Imagine que você tem uma lista de dados de vendas que deseja exibir como uma tabela em um PDF. Em vez de criar uma classe formal, você pode usar um objeto anônimo para formatar rapidamente os dados para renderização.

using IronPdf;
using System;
using System.Linq;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key here
        License.LicenseKey = "Your-Licence-Key";

        // Sample data using anonymous objects
        var salesData = new[]
        {
            new { Product = "Laptop", Quantity = 2, Price = 1200.50 },
            new { Product = "Smartphone", Quantity = 5, Price = 800.00 },
            new { Product = "Headphones", Quantity = 10, Price = 150.75 }
        };

        // Create an HTML string dynamically using the anonymous object data
        var htmlContent = @"
        <html>
        <head><style>table {border-collapse: collapse;} th, td {border: 1px solid black; padding: 5px;}</style></head>
        <body>
        <h1>Sales Report</h1>
        <table>
            <thead>
                <tr>
                    <th>Product</th>
                    <th>Quantity</th>
                    <th>Price</th>
                </tr>
            </thead>
            <tbody>
                " +
            string.Join("", salesData.Select(item =>
                $"<tr><td>{item.Product}</td><td>{item.Quantity}</td><td>{item.Price:C}</td></tr>")) +
            @"
            </tbody>
        </table>
        </body>
        </html>";

        // Generate the PDF
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);

        // Save the PDF
        pdf.SaveAs("SalesReport.pdf");
        Console.WriteLine("PDF generated successfully!");
    }
}
using IronPdf;
using System;
using System.Linq;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key here
        License.LicenseKey = "Your-Licence-Key";

        // Sample data using anonymous objects
        var salesData = new[]
        {
            new { Product = "Laptop", Quantity = 2, Price = 1200.50 },
            new { Product = "Smartphone", Quantity = 5, Price = 800.00 },
            new { Product = "Headphones", Quantity = 10, Price = 150.75 }
        };

        // Create an HTML string dynamically using the anonymous object data
        var htmlContent = @"
        <html>
        <head><style>table {border-collapse: collapse;} th, td {border: 1px solid black; padding: 5px;}</style></head>
        <body>
        <h1>Sales Report</h1>
        <table>
            <thead>
                <tr>
                    <th>Product</th>
                    <th>Quantity</th>
                    <th>Price</th>
                </tr>
            </thead>
            <tbody>
                " +
            string.Join("", salesData.Select(item =>
                $"<tr><td>{item.Product}</td><td>{item.Quantity}</td><td>{item.Price:C}</td></tr>")) +
            @"
            </tbody>
        </table>
        </body>
        </html>";

        // Generate the PDF
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);

        // Save the PDF
        pdf.SaveAs("SalesReport.pdf");
        Console.WriteLine("PDF generated successfully!");
    }
}
Imports IronPdf
Imports System
Imports System.Linq

Friend Class Program
	Shared Sub Main()
		' Set your IronPDF license key here
		License.LicenseKey = "Your-Licence-Key"

		' Sample data using anonymous objects
		Dim salesData = {
			New With {
				Key .Product = "Laptop",
				Key .Quantity = 2,
				Key .Price = 1200.50
			},
			New With {
				Key .Product = "Smartphone",
				Key .Quantity = 5,
				Key .Price = 800.00
			},
			New With {
				Key .Product = "Headphones",
				Key .Quantity = 10,
				Key .Price = 150.75
			}
		}

		' Create an HTML string dynamically using the anonymous object data
		Dim htmlContent = "
        <html>
        <head><style>table {border-collapse: collapse;} th, td {border: 1px solid black; padding: 5px;}</style></head>
        <body>
        <h1>Sales Report</h1>
        <table>
            <thead>
                <tr>
                    <th>Product</th>
                    <th>Quantity</th>
                    <th>Price</th>
                </tr>
            </thead>
            <tbody>
                " & String.Join("", salesData.Select(Function(item) $"<tr><td>{item.Product}</td><td>{item.Quantity}</td><td>{item.Price:C}</td></tr>")) & "
            </tbody>
        </table>
        </body>
        </html>"

		' Generate the PDF
		Dim renderer = New ChromePdfRenderer()
		Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)

		' Save the PDF
		pdf.SaveAs("SalesReport.pdf")
		Console.WriteLine("PDF generated successfully!")
	End Sub
End Class
$vbLabelText   $csharpLabel

Objeto Anônimo em C# (Como funciona para desenvolvedores): Figura 1 - Saída do console do exemplo de código acima

Conclusão

Objeto Anônimo em C# (Como funciona para desenvolvedores): Figura 2 - Página de Licenciamento do IronPDF

Os tipos anônimos em C# oferecem uma maneira flexível e eficiente de criar estruturas de dados temporárias sem a necessidade de declarações formais de classe. São particularmente úteis ao trabalhar com consultas LINQ, transformações de dados e bibliotecas como o IronPDF. A combinação de tipos anônimos com os recursos de geração de PDF do IronPDF oferece uma solução poderosa para criar PDFs dinâmicos e orientados a dados com sobrecarga mínima de código.

O IronPDF permite que os desenvolvedores testem seus recursos por meio de um período de avaliação gratuito , facilitando a exploração de suas capacidades em seus aplicativos .NET . As licenças comerciais começam em $799 e concedem acesso ao conjunto completo de recursos, incluindo renderização de HTML para PDF de alto desempenho, edição de PDF e recursos de segurança.

Perguntas frequentes

O que são tipos anônimos em C#?

Em C#, os tipos anônimos fornecem um mecanismo para encapsular propriedades públicas somente leitura em um único objeto de tipo anônimo sem a necessidade de definir explicitamente uma declaração de classe formal. São tipos gerados pelo compilador, usados como contêineres de dados leves e imutáveis.

Como posso criar um tipo anônimo em C#?

Para criar um tipo anônimo em C#, você usa a palavra-chave var com o operador new e a sintaxe de inicialização de objeto. O compilador gera automaticamente o nome e a estrutura do tipo com base nas propriedades fornecidas.

Como os tipos anônimos funcionam com operações LINQ em C#?

Os tipos anônimos se destacam em expressões de consulta LINQ, particularmente em cláusulas select, ao retornar com eficiência subconjuntos de propriedades específicos de objetos maiores, otimizando o uso de memória.

É possível usar tipos anônimos em estruturas aninhadas?

Sim, tipos anônimos podem ser usados em estruturas aninhadas. Isso permite a criação de representações de dados hierárquicas, onde as propriedades de um tipo anônimo podem ser, elas próprias, objetos de tipo anônimo.

Como posso usar objetos anônimos para criar PDFs dinâmicos?

Objetos anônimos podem formatar dados rapidamente para renderização em PDFs dinâmicos. Ao combiná-los com uma biblioteca de PDF, como o IronPDF, você pode gerar PDFs de forma eficiente com o mínimo de código.

Quais são as limitações dos tipos anônimos em C#?

Os tipos anônimos são limitados a possuir propriedades públicas somente leitura e não podem ter métodos, eventos ou membros de classe definidos explicitamente. Eles também não podem ser inicializados com valores nulos ou tipos ponteiro.

Quais são os casos de uso comuns para tipos anônimos?

Os casos de uso comuns para tipos anônimos incluem agrupamento temporário de dados, encapsulamento de propriedades e operações de coleção, onde a criação de uma classe formal seria excessiva.

Como as bibliotecas de PDF podem aprimorar os fluxos de trabalho de dados para PDF em aplicativos .NET?

As bibliotecas de PDF oferecem ferramentas robustas para gerar, editar e gerenciar documentos PDF em aplicativos .NET, facilitando fluxos de trabalho eficientes de dados para PDF e aprimorando soluções orientadas a dados.

Curtis Chau
Curtis Chau
  Converse agora mesmo com a equipe de engenharia.
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 ...

Leia mais

Artigos relacionados

Teste grátis por 30 dias → Produto completo. Sem limites. Sem cartão. Teste gratuito

Equipe de suporte de ferro

Estamos online 24 horas por dia, 5 dias por semana.
Bater papo
E-mail
Liga para mim