信息圖標
跳過到頁腳內容
  1. IronPdf
  2. IronPdf 部落格
  3. .NET 幫助
  4. Signalr C#
.NET HELP

Signalr C# (How it Works For Developers)

Jacob Mellor，技術長 @ Team Iron
Jacob Mellor
更新:

現代網路的發展依賴互動性和即時回饋。 建立響應式應用程式時，即時 Web 功能不可或缺。而這正是 SignalR 的優勢。 ASP.NET Core SignalR是一個函式庫，它可以讓你的應用程式添加即時 Web 功能比你想像的要簡單得多。

在本教程中，我們將踏上探索 SignalR 基礎知識和細微差別的旅程。 讓我們開始吧！

ASP.NET Core 中的 SignalR 簡介

ASP.NET Core SignalR 提供了一個 API，用於使用 WebSocket 和其他技術（如伺服器發送事件）建立即時 Web 功能。 它不僅限於 ASP.NET Core。 您可以將 SignalR 與各種用戶端（如瀏覽器或行動應用程式）一起使用，確保連線的用戶端能夠立即更新。

建構開發環境

首先，你需要：

建構 SignalR Hub

SignalR 的核心是 SignalR hub，它是客戶端和伺服器互動的中心點。

建立一個新的 ASP.NET Core 專案。 現在，新增一個類別並將其命名為ChatHub 。 這將作為我們的 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);
    }
}
$vbLabelText   $csharpLabel

在Startup課程中，讓我們整合我們的中心。

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

客戶端實現

SignalR 功能多樣。雖然本教學重點介紹ASP.NET Core 和 JavaScript 用戶端程式庫，但 SignalR 支援從 .NET 到 Java 的各種客戶端。

使用 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>
HTML

現在您可以連接到中心樞紐：

// 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}`);
});
JAVASCRIPT

這段簡單的客戶端程式碼連接到中心伺服器，並監聽任何廣播的訊息。

即時功能演示

發送訊息

利用我們之前提供的客戶端和服務端程式碼片段，發送訊息非常簡單。 伺服器和客戶端都可以發起通訊。

伺服器端：

// 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!");
$vbLabelText   $csharpLabel

客戶回饋：

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

高級即時通信

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

1.連線分組：將連線的客戶端分成群組，向特定群組廣播訊息。 2.處理斷開連線：自動管理客戶端連線和斷開連線。 3.二進位協定：雖然 SignalR 預設使用基於文字的協議，但它也支援二進位協定。

使用 Azure SignalR 服務

為了實現可擴充的即時功能，請整合Azure SignalR 服務。 這項完全託管的服務支援大量並發連接，使其成為高需求應用程式的理想選擇。

整合 Azure SignalR 服務：

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

Iron Suite 使用進階 .NET 工具增強 SignalR 功能

雖然 ASP.NET Core SignalR 為即時 Web 功能提供了出色的基礎，但開發人員經常會尋找工具來增強整體體驗和功能。 這時， Iron 軟體套件庫就派上用場了。

Iron Suite 是一套高級 .NET 庫，旨在增強您的 ASP.NET Core 應用程序，包括那些使用 SignalR 的應用程式。 此套件中的每款產品都提供獨特的功能，確保更豐富的應用體驗。 讓我們深入了解這些產品：

IronPDF

SignalR C#（開發者使用方法）圖 1

了解更多關於 IronPDF 的功能，它允許您在 .NET 應用程式中產生、編輯和讀取 PDF 文件。 想像一下，如果將 SignalR 整合到團隊即時協作處理文件的場景中，當文件發生變更時，可以立即將其轉換為 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");
    }
}
$vbLabelText   $csharpLabel

IronXL

SignalR C#（開發者使用方法）圖 2

說到使用 Excel 電子表格， Explore IronXL Features堪稱佼佼者。 在商業環境中，電子表格發揮著至關重要的作用。 將 SignalR 與 IronXL 結合使用，意味著財務團隊可以即時處理預算表，並即時查看變更。 想像一下這樣的場景：來自各部門的資料輸入都匯集到一個集中的 Excel 表格中，所有利害關係人都能即時查看更新。 透過這種結合，即時通訊和動態電子表格管理的融合成為現實。

IronOCR

SignalR C#（開發者使用方法）圖 3

光學字元辨識（OCR）已成為現代應用中的必備技術。 觀看 IronOCR 的實際應用，了解如何幫助 .NET 開發人員從圖像和文件中提取文字。 將此功能與 SignalR 的即時功能結合，可能會帶來顛覆性的改變。 設想這樣一個平台，用戶可以在上面上傳包含文字資料的圖片。 SignalR 可用於在 IronOCR 處理影像後即時通知用戶，使資料擷取具有互動性和即時性。

IronBarcode

SignalR C#（開發者使用方法）圖 4

條碼技術在庫存管理、票務系統等領域發揮不可或缺的作用。 探索 IronBarcode 的功能，簡化條碼的建立和讀取。 現在，想想如何將此功能與 SignalR 整合到倉庫管理系統中。 掃描商品後，庫存會即時更新，通知已連接的客戶庫存水平，確保物流運作順暢。

結論

SignalR C#（開發者使用方法）圖 5

ASP.NET Core SignalR 與 Iron Suite 的強大工具結合，預計將為開發人員和最終用戶帶來更好的體驗。 即時網路功能不僅關乎溝通，更是一種變革性工具，當與 Iron Suite 等合適的資源結合使用時，可以重新定義互動式應用程式。

值得注意的是Iron Suite提供的價值主張。每個產品授權的起價為$799 ，為開發者提供一套高級功能。 但是，如果您不確定是否要立即購買，每款產品都慷慨地提供了Iron Software Products 的免費試用版。 這樣你就可以在做決定之前先試用各項功能。

如果您正在考慮整合多個工具，那麼有個好消息：您只需支付兩個產品的價格，即可購買整個 Iron Suite，享受更多價值！ 這不僅確保您物有所值，而且還為您提供一套全面的工具包，以徹底更改您的 ASP.NET Core SignalR 應用程式。

常見問題解答

什麼是 SignalR，它如何增強網路應用程式？

SignalR 是 ASP.NET Core 中的一個函式庫，可為應用程式增加即時網頁功能，實現伺服器與用戶端的即時通訊。透過實時更新與回饋，可產生互動且反應迅速的 Web 應用程式。

如何在 C# 應用程式中設定 SignalR？

要在 C# 應用程式中設定 SignalR，您需要安裝 ASP.NET Core SDK 並使用 Visual Studio 進行開發。在 Startup 類別中加入 SignalR 服務，並將 hub 對應到端點，以建立伺服器與用戶端的通訊。

SignalR Hub 在即時通訊中扮演什麼角色？

SignalR Hub 是一個中央元件，可促進伺服器與連接的用戶端之間的通訊。它可以實時傳送和接收訊息，是 SignalR 功能的關鍵部分。

如何在 SignalR 中處理即時訊息傳送？

SignalR 中的即時訊息傳輸可透過建立伺服器端樞紐和用戶端腳本來管理。用戶端的 JavaScript 會建立與 hub 的連線，並使用 connection.on 和 connection.send 等方法處理訊息的傳送和接收。

SignalR 有哪些進階功能？

SignalR 提供先進的功能，例如將連線群組以分割通訊、優雅處理用戶端斷線，以及支援二進位通訊協定以增強即時通訊能力。

Azure SignalR 服務如何協助擴充應用程式？

Azure SignalR 服務可支援大量同時連線，讓應用程式得以擴充。它涉及安裝 Azure SignalR SDK 並配置 Startup 類別，以利用 Azure 的基礎架構進行可擴充的即時通訊。

如何使用 IronPDF 在 SignalR 應用程式中產生 PDF？

IronPDF 可以用在 SignalR 應用程式中，透過轉換 HTML 內容來產生 PDF 文件。IronPDF 的 RenderHtmlAsPdf 方法允許無縫生成 PDF，可以與 SignalR 中的實時更新集成。

IronXL 能為 SignalR 應用程式帶來哪些好處？

IronXL 透過啟用 Excel 檔案操作來增強 SignalR 應用程式。它允許您在應用程式中建立、讀取和修改 Excel 文件，在實時功能之外提供額外的資料處理能力。

IronOCR 可以整合到 SignalR 應用程式中進行文字辨識嗎？

是的，IronOCR 可以整合到 SignalR 應用程式中執行光學字元識別 (OCR)。這可從影像中即時擷取文字，增強應用程式的動態文字辨識能力。

在 SignalR 應用程式中使用 IronBarcode 的潛力為何？

IronBarcode 可在 SignalR 應用程式中使用，以即時產生和讀取條碼。此功能有利於需要動態條碼處理和即時資料處理的應用程式。

Jacob Mellor，技術長 @ Team Iron
Jacob Mellor
  立即與工程團隊聊天
首席技術長

Jacob Mellor 是 Iron Software 的首席技術長，也是開創 C# PDF 技術的有遠見的工程師。作為 Iron Software 核心程式碼庫背後的原始開發人員，他從公司成立之初就塑造了公司的產品架構，與首席執行官 Cameron Rimington 一起將公司轉型為一家 50 多人的公司，為 NASA、Tesla 和全球政府機構提供服務。

Jacob 持有曼徹斯特大學土木工程一級榮譽工程學士學位 (BEng)（1998-2001 年）。

Jacob 於 1999 年在倫敦開設了他的第一家軟體公司，並於 2005 年創建了他的第一個 .NET 元件，之後，他專門解決微軟生態系統中的複雜問題。

他的旗艦產品 IronPDF & Iron Suite for .NET 函式庫在全球的 NuGet 安裝量已超過 3000 萬次，他的基礎程式碼持續為全球使用的開發人員工具提供動力。Jacob 擁有 25 年的商業經驗和 41 年的編碼專業知識，他一直專注於推動企業級 C#、Java 和 Python PDF 技術的創新，同時指導下一代的技術領導者。

相關文章

30 天試用→完整產品。無限制。無需信用卡。 開始免費試用