Ação em C# (Como funciona para desenvolvedores)

O que é um Delegado Func?

O delegado Func representa um método que pode ter um valor de retorno. O último parâmetro de tipo especifica o tipo de retorno, e os tipos precedentes especificam os parâmetros de entrada.

Por exemplo, um Func<int, int, string> recebe dois parâmetros inteiros e retorna uma mensagem em formato de texto.

Exemplo de um Delegado de Ação

Um delegado de ação, um tipo de delegado predefinido, é usado quando você deseja executar um método que não retorna um valor especificamente, concentrando-se, em vez disso, em operações. Eis um exemplo básico:

Action<string> display = message => Console.WriteLine(message);
display("Hello, World!");

Action<string> display = message => Console.WriteLine(message);
display("Hello, World!");

Dim display As Action(Of String) = Sub(message) Console.WriteLine(message)
display("Hello, World!")

Este código define um delegado Action, ilustrando o uso de um método anônimo, que recebe um único parâmetro de string e o imprime no console. O símbolo => é usado para definir uma expressão lambda, que é uma maneira concisa de escrever métodos anônimos.

Exemplo de um Delegado Func

Um delegado Func , que retorna um valor, pode ser usado da seguinte forma:

Func<int, int, int> add = (x, y) => x + y;
int result = add(5, 3);
Console.WriteLine(result);

Func<int, int, int> add = (x, y) => x + y;
int result = add(5, 3);
Console.WriteLine(result);

Dim add As Func(Of Integer, Integer, Integer) = Function(x, y) x + y
Dim result As Integer = add(5, 3)
Console.WriteLine(result)

Este exemplo cria um delegado Func que recebe dois parâmetros inteiros e retorna a soma deles. A soma será exibida no console da seguinte forma:

Métodos anônimos

Em C#, os métodos anônimos oferecem uma maneira de definir métodos embutidos sem um nome. Eles são frequentemente usados ​​com delegados para criar instâncias de delegados diretamente.

Expressões Lambda

Expressões lambda são uma forma abreviada de escrever métodos anônimos. Elas permitem que você escreva menos código, obtendo o mesmo resultado.

Delegado Genérico

Um delegado genérico pode funcionar com qualquer tipo de dado. Func e Action são exemplos de delegates genéricos, que oferecem mais flexibilidade ao permitir que você especifique os tipos de entrada e saída em tempo de execução.

Instância de Delegado

Uma instância de delegado é criada com a palavra-chave new ou simplesmente atribuindo um método que corresponda à assinatura do delegado.

Espaço de nomes do sistema

O namespace System no .NET contém tipos internos como Func e Action , que fazem parte da biblioteca de classes base.

Exemplo: Processamento assíncrono de arquivos

Considere uma aplicação que precisa processar um arquivo grande. O uso de um delegado Action em conjunto com padrões de programação assíncrona, como Task, pode melhorar significativamente o desempenho da aplicação:

public async Task ProcessFileAsync(string filePath, Action<string> onComplete)
{
    // Asynchronously read file content
    string fileContent = await File.ReadAllTextAsync(filePath);
    // Process the file content here (omitted for brevity)

    // Once processing is complete, invoke the onComplete callback
    onComplete?.Invoke("File processing completed successfully.");
}

public async Task ProcessFileAsync(string filePath, Action<string> onComplete)
{
    // Asynchronously read file content
    string fileContent = await File.ReadAllTextAsync(filePath);
    // Process the file content here (omitted for brevity)

    // Once processing is complete, invoke the onComplete callback
    onComplete?.Invoke("File processing completed successfully.");
}

Public Async Function ProcessFileAsync(ByVal filePath As String, ByVal onComplete As Action(Of String)) As Task
	' Asynchronously read file content
	Dim fileContent As String = Await File.ReadAllTextAsync(filePath)
	' Process the file content here (omitted for brevity)

	' Once processing is complete, invoke the onComplete callback
	If onComplete IsNot Nothing Then
		onComplete.Invoke("File processing completed successfully.")
	End If
End Function

Neste exemplo, File.ReadAllTextAsync é usado para ler o conteúdo do arquivo sem bloquear a thread principal. Após o processamento do arquivo, um delegado de ação chamado onComplete é invocado para notificar o chamador de que a operação foi concluída, permitindo ações adicionais, como atualizar a interface do usuário ou registrar os resultados.

Instalando o IronPDF

Para incorporar o IronPDF em seus projetos .NET , você pode usar o NuGet, que é o método mais simples. Basta abrir o Console do Gerenciador de Pacotes no Visual Studio e executar o seguinte comando:

Install-Package IronPdf

Este comando baixa e instala o pacote IronPDF , configurando seu projeto para começar a usar o IronPDF para geração e manipulação de PDFs.

Exemplo de código com Action Delegate

Aqui está um exemplo simples que demonstra como usar o IronPDF em conjunto com um delegado de ação para executar uma tarefa de geração de PDF:

using IronPdf;
using System;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // Define an Action delegate that takes HTML content as a string
        Action<string> generatePdf = html =>
        {
            // Render the HTML as a PDF
            var pdf = renderer.RenderHtmlAsPdf(html);

            // Save the PDF to a file
            pdf.SaveAs("example.pdf");
        };

        // Generate the PDF with the provided HTML
        generatePdf("<p>Hello, world!</p>");
        Console.WriteLine("PDF generated successfully.");
    }
}

using IronPdf;
using System;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // Define an Action delegate that takes HTML content as a string
        Action<string> generatePdf = html =>
        {
            // Render the HTML as a PDF
            var pdf = renderer.RenderHtmlAsPdf(html);

            // Save the PDF to a file
            pdf.SaveAs("example.pdf");
        };

        // Generate the PDF with the provided HTML
        generatePdf("<p>Hello, world!</p>");
        Console.WriteLine("PDF generated successfully.");
    }
}

Imports IronPdf
Imports System

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' Define an Action delegate that takes HTML content as a string
		Dim generatePdf As Action(Of String) = Sub(html)
			' Render the HTML as a PDF
			Dim pdf = renderer.RenderHtmlAsPdf(html)

			' Save the PDF to a file
			pdf.SaveAs("example.pdf")
		End Sub

		' Generate the PDF with the provided HTML
		generatePdf("<p>Hello, world!</p>")
		Console.WriteLine("PDF generated successfully.")
	End Sub
End Class

Este exemplo define um delegado de ação que recebe uma string de HTML e usa o IronPDF para renderizá-la em um documento PDF. O PDF gerado é então salvo no sistema de arquivos. Essa abordagem demonstra como os delegates podem ser usados ​​para encapsular a lógica de geração de PDFs, tornando seu código mais modular e flexível.

Licenciamento

A IronPDF oferece diversas opções de licenciamento para desenvolvedores , desde licenças individuais até contratos corporativos. O preço dessas licenças começa em $799.