SignalR C#（開發者的工作原理）

設定您的開發環境

要開始，您需要：

• ASP.NET Core SDK
• Visual Studio

構建SignalR Hub

SignalR的核心在於SignalR hub，這是一個讓客戶端和伺服器交互的中心點。

建立一個新的ASP.NET Core專案。 現在，新增一個新類並將其命名為ChatHub。 這將作為我們的SignalR hub。

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

在Startup類中，讓我們整合我們的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");
        });
    }
}

使用SignalR客戶端程式庫

SignalR客戶端程式庫讓您的客戶端代碼能直接與伺服器端連接和通訊。對於我們的示例，讓我們使用JavaScript。

首先，添加SignalR JavaScript客戶端程式庫：

<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>

現在，您可以連接到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}`);
});

這個簡單的客戶端代碼連接到hub並監聽任何廣播的訊息。

發送訊息

使用我們先前的客戶端和伺服器端代碼片段，發送訊息很簡單。 伺服器和客戶端都可以發起通訊。

從伺服器端：

// 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 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()));

進階即時通訊

ASP.NET Core SignalR提供了進階的即時通訊功能：

1. 分組連接：將連接的客戶端分段，向特定段廣播訊息。
2. 處理斷線：自動管理客戶端連接和斷線。
3. 二進制協議：雖然SignalR默認使用基於文本的協議，它也支援二進制協議。

與Azure SignalR Service配合使用

為了獲得可擴展的即時功能，整合Azure SignalR Service。 這個完全托管的服務支援大規模同時連接，非常適合高需求的應用程式。

整合Azure SignalR Service：

1. 安裝Azure SignalR SDK。
2. 使用Azure服務匯流排做為後端支援。
3. 調整Startup類以使用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");
        });
    }
}

IronPDF

了解更多IronPDF功能讓您可以在.NET應用程式中生成、編輯和閱讀PDF文件。 設想一個情景，團隊在實時協作處理文檔。隨著變更的發生，文件可以即時轉換為PDF，並將更新推送至所有連接的客戶端，實現無縫協作。 SignalR的即時功能和IronPDF的功能將可協作工具革新。

IronPDF將HTML、URL和完整的網頁轉換成驚艷的PDF，保留原樣。 這非常適合保存在線報告、發票或任何您想保留的基於網頁的信息。您正在尋找將HTML轉換為PDF嗎？ 今天就試試IronPDF！

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

IronXL

當涉及處理Excel電子表格時，探索IronXL功能是冠軍。 在商業環境中，電子表在中扮演著至關重要的角色。 結合SignalR和IronXL，財務團隊可以在預算表上實時工作，隨時目擊變更發生。 想像一個情況，來自各部門的數據條目流入集中Excel表，對所有利益相關者進行實時更新。 這種即時通訊和動態電子表管理的結合成為現實。

IronOCR

光學字符識別（OCR）已成為現代應用的主流。 看看IronOCR的實際應用賦予.NET開發人員從圖像和文件中提取文本的能力。 將這與SignalR的即時功能結合起來，可以改變遊戲規則。 考慮一個平台，您用戶上傳包含文字信息的圖像。 SignalR可以用於在IronOCR處理圖像後即時通知用戶，使數據提取變得互動且即時。

IronBarcode

條碼在庫存管理、票務系統中非常重要。 探索 IronBarcode 功能簡化了條碼的創建和讀取。 現在，想像將此功能與SignalR整合到倉庫管理系統中。 隨著物品被掃描，庫存實時更新，通知連接的客戶端庫存水平，確保流暢的物流。