SignalR em C# (Como funciona para desenvolvedores)

Configurando seu ambiente de desenvolvimento

Para começar, você precisará de:

• SDK do ASP.NET Core
• Visual Studio

Construindo o Hub SignalR

Em sua essência, o SignalR gira em torno de um hub SignalR, um ponto central para a interação entre o cliente e o servidor.

Crie um novo projeto ASP.NET Core. Agora, adicione uma nova classe e nomeie-a como ChatHub. Isso funcionará como nosso hub SignalR.

using Microsoft.AspNetCore.SignalR;
using System.Threading.Tasks;

// Define a SignalR Hub class named ChatHub
public class ChatHub : Hub
{
    // Asynchronous method to send messages
    public async Task SendMessage(string user, string message)
    {
        // Send a message to all connected clients
        await Clients.All.SendAsync("ReceiveMessage", user, message);
    }
}

using Microsoft.AspNetCore.SignalR;
using System.Threading.Tasks;

// Define a SignalR Hub class named ChatHub
public class ChatHub : Hub
{
    // Asynchronous method to send messages
    public async Task SendMessage(string user, string message)
    {
        // Send a message to all connected clients
        await Clients.All.SendAsync("ReceiveMessage", user, message);
    }
}

Imports Microsoft.AspNetCore.SignalR
Imports System.Threading.Tasks

' Define a SignalR Hub class named ChatHub
Public Class ChatHub
	Inherits Hub

	' Asynchronous method to send messages
	Public Async Function SendMessage(ByVal user As String, ByVal message As String) As Task
		' Send a message to all connected clients
		Await Clients.All.SendAsync("ReceiveMessage", user, message)
	End Function
End Class

Na classe Startup, vamos integrar nosso hub.

public class Startup
{
    // Configure services and add SignalR
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddSignalR(); // Add SignalR services
    }

    // Configure the app to use SignalR and map the hub
    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        // Setup endpoint to route to ChatHub
        app.UseEndpoints(endpoints =>
        {
            endpoints.MapHub<ChatHub>("/chatHub");
        });
    }
}

public class Startup
{
    // Configure services and add SignalR
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddSignalR(); // Add SignalR services
    }

    // Configure the app to use SignalR and map the hub
    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        // Setup endpoint to route to ChatHub
        app.UseEndpoints(endpoints =>
        {
            endpoints.MapHub<ChatHub>("/chatHub");
        });
    }
}

Public Class Startup
	' Configure services and add SignalR
	Public Sub ConfigureServices(ByVal services As IServiceCollection)
		services.AddSignalR() ' Add SignalR services
	End Sub

	' Configure the app to use SignalR and map the hub
	Public Sub Configure(ByVal app As IApplicationBuilder, ByVal env As IWebHostEnvironment)
		' Setup endpoint to route to ChatHub
		app.UseEndpoints(Sub(endpoints)
			endpoints.MapHub(Of ChatHub)("/chatHub")
		End Sub)
	End Sub
End Class

Utilizando a biblioteca cliente SignalR

A biblioteca cliente SignalR permite que seu código do lado do cliente se conecte e se comunique diretamente com o lado do servidor. Para o nosso exemplo, vamos usar JavaScript.

Primeiro, adicione a biblioteca cliente JavaScript do SignalR:

<script src="https://cdn.jsdelivr.net/npm/@microsoft/signalr@3.1.8/dist/browser/signalr.js"></script>

<script src="https://cdn.jsdelivr.net/npm/@microsoft/signalr@3.1.8/dist/browser/signalr.js"></script>

Agora você pode se conectar ao hub:

// Create a connection to the SignalR hub
const connection = new signalR.HubConnectionBuilder()
    .withUrl("/chatHub") // The hub URL
    .build();

// Start the connection
connection.start().catch(err => console.error(err.toString()));

// Setup a listener for receiving messages
connection.on("ReceiveMessage", (user, message) => {
    console.log(`${user} says: ${message}`);
});

// Create a connection to the SignalR hub
const connection = new signalR.HubConnectionBuilder()
    .withUrl("/chatHub") // The hub URL
    .build();

// Start the connection
connection.start().catch(err => console.error(err.toString()));

// Setup a listener for receiving messages
connection.on("ReceiveMessage", (user, message) => {
    console.log(`${user} says: ${message}`);
});

Este código simples do lado do cliente se conecta ao hub e fica à escuta de quaisquer mensagens transmitidas.

Envio de mensagens

Usando nossos trechos de código anteriores, tanto do lado do cliente quanto do servidor, o envio de mensagens é simples. Tanto o servidor quanto o cliente podem iniciar a comunicação.

Do lado do servidor:

// Send a message from the server to all connected clients
await Clients.All.SendAsync("ReceiveMessage", "Server", "Hello from server!");

// Send a message from the server to all connected clients
await Clients.All.SendAsync("ReceiveMessage", "Server", "Hello from server!");

' Send a message from the server to all connected clients
Await Clients.All.SendAsync("ReceiveMessage", "Server", "Hello from server!")

E do cliente:

// Send a message from the client to the server
connection.send("SendMessage", "Client", "Hello from client!")
    .catch(err => console.error(err.toString()));

// Send a message from the client to the server
connection.send("SendMessage", "Client", "Hello from client!")
    .catch(err => console.error(err.toString()));

Comunicação avançada em tempo real

O ASP.NET Core SignalR oferece recursos avançados de comunicação em tempo real:

1. Agrupamento de conexões: Segmentar os clientes conectados em grupos, enviando mensagens para segmentos específicos.
2. Gerenciamento de desconexões: Gerencie automaticamente as conexões e desconexões de clientes.
3. Protocolo Binário: Embora o SignalR utilize um protocolo baseado em texto por padrão, ele também suporta um protocolo binário.

SignalR com o serviço Azure SignalR

Para funcionalidades escaláveis ​​em tempo real, integre o serviço Azure SignalR . Este serviço totalmente gerenciado suporta um grande número de conexões simultâneas, tornando-o ideal para aplicativos de alta demanda.

Integrando o serviço Azure SignalR:

1. Instale o SDK do Azure SignalR .
2. Utilize o Azure Service Bus para suporte ao backplane.
3. Ajuste a classe Startup para usar o Azure SignalR.

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        // Add Azure SignalR services
        services.AddSignalR().AddAzureSignalR();
    }

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        // Use Azure SignalR and map hub with routes
        app.UseAzureSignalR(routes =>
        {
            routes.MapHub<ChatHub>("/chatHub");
        });
    }
}

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        // Add Azure SignalR services
        services.AddSignalR().AddAzureSignalR();
    }

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        // Use Azure SignalR and map hub with routes
        app.UseAzureSignalR(routes =>
        {
            routes.MapHub<ChatHub>("/chatHub");
        });
    }
}

Public Class Startup
	Public Sub ConfigureServices(ByVal services As IServiceCollection)
		' Add Azure SignalR services
		services.AddSignalR().AddAzureSignalR()
	End Sub

	Public Sub Configure(ByVal app As IApplicationBuilder, ByVal env As IWebHostEnvironment)
		' Use Azure SignalR and map hub with routes
		app.UseAzureSignalR(Sub(routes)
			routes.MapHub(Of ChatHub)("/chatHub")
		End Sub)
	End Sub
End Class

IronPDF

Saiba mais sobre os recursos do IronPDF, que permitem gerar, editar e ler arquivos PDF em seus aplicativos .NET . Imagine integrar o SignalR em um cenário onde uma equipe colabora em um documento em tempo real. À medida que as alterações são feitas, o documento pode ser convertido para PDF instantaneamente, com as atualizações sendo enviadas a todos os clientes conectados de forma transparente. A funcionalidade em tempo real do SignalR, combinada com os recursos do IronPDF, pode revolucionar as ferramentas de colaboração.

O IronPDF converte HTML, URLs e páginas da web completas em PDFs impressionantes, idênticos aos originais. É perfeito para salvar relatórios online, faturas ou qualquer informação da web que você queira guardar. Você está procurando converter HTML para PDF ? Experimente o IronPDF hoje mesmo!

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");
    }
}

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 Class

IronXL

Quando se trata de trabalhar com planilhas do Excel, o Explore IronXL Features é imbatível. No contexto empresarial, as planilhas desempenham um papel fundamental. A integração do SignalR com o IronXL significa que as equipes financeiras podem trabalhar em planilhas orçamentárias em tempo real, testemunhando as mudanças à medida que acontecem. Imagine um cenário em que os dados inseridos por diversos departamentos sejam reunidos em uma planilha centralizada do Excel, com atualizações em tempo real para todas as partes interessadas. Com essa combinação, a fusão da comunicação em tempo real com o gerenciamento dinâmico de planilhas torna-se realidade.

IronOCR

O reconhecimento óptico de caracteres (OCR) tornou-se um elemento essencial nas aplicações modernas. Veja o IronOCR em ação: ele permite que desenvolvedores .NET extraiam texto de imagens e documentos. Combinar isso com a funcionalidade em tempo real do SignalR pode ser revolucionário. Considere uma plataforma onde os usuários carregam imagens contendo dados textuais. O SignalR poderia ser usado para notificar os usuários em tempo real assim que o IronOCR processasse as imagens, tornando a extração de dados interativa e instantânea.

IronBarcode

O código de barras é essencial na gestão de estoque, sistemas de emissão de bilhetes e muito mais. Descubra como os recursos do IronBarcode simplificam a criação e a leitura de códigos de barras. Agora, imagine integrar isso com o SignalR em um sistema de gerenciamento de armazém. À medida que os itens são escaneados, o inventário é atualizado em tempo real, notificando os clientes conectados sobre os níveis de estoque e garantindo uma operação logística tranquila.