.NET 帮助

dotnetify.NET（开发者用法）

已更新:六月 22, 2025

DotNetify 是一个用 .NET 和 Blazor 制作的开源框架，旨在为 .NET 平台创建实时 Web 应用程序。通过利用SignalR在客户端和服务器之间进行实时交互的能力，它简化了动态和交互式Web应用程序的构建。 DotNetify 提供一种编程模型，可以将客户端视图与服务器端脚本数据同步，让开发人员能够快速轻松地设计丰富、响应迅速且高性能的在线界面。

相反，IronPDF PDF生成库是一个强大的.NET包，可以方便地以编程方式创建、编辑和操作PDF文档。它是生成动态、数据驱动文档（如报告、发票和表单）的绝佳选择，提供了一个直观的API用于将HTML文本转换为PDF。

通过将 DotNetify 与 IronPDF 集成，在 C# 应用程序中结合了实时 Web 交互性和强大的 PDF 生产能力。这种集成对于需要实时数据展示和根据最新数据动态创建和分发 PDF 文档的应用程序特别有利。开发人员可以通过无缝的文档生成和分发，利用 IronPDF 的多功能 PDF 生成能力和 DotNetify 的实时数据同步来创建满足复杂业务需求并增强用户体验的大型交互性在线应用程序。

什么是 DotNetify？

DotNetify 是一个开源框架，旨在简化使用 .NET 和 Blazor 创建交互式实时 Web 应用程序。开发人员可以通过利用 SignalR，创建动态和响应迅速的用户界面，使客户端和服务器之间的实时通信变得更加容易。 DotNetify 使用反应式编程方法，抽象了实时数据绑定和事件处理的复杂性，从而简化了复杂在线应用程序的创建，所需代码量最小。

dotnetify .NET（对于开发人员的工作原理）：图1

DotNetify 允许开发人员构建服务器端视图模型，立即将更改传播给客户端，确保用户界面始终反映应用程序的状态。该框架在选择客户端技术方面提供了灵活性，支持经典的 JavaScript 前端和 Blazor 前端。由于易用性和有效性，它是需要实时更新的应用程序的理想选择，例如仪表板、协作工具和实时数据流。

DotNetify 对复杂交互和数据流的实时处理显著增强了用户体验，从而实现了平滑的数据同步和即时反馈。总体而言，DotNetify 是一款有价值的工具，面向 .NET 开发人员，帮助他们快速高效地构建反应式的前沿实时在线应用程序。

DotNetify 的功能

C# 中的 DotNetify 提供了大量功能，简化了交互式实时在线应用程序的创建，包括：

实时通信：利用 SignalR 实现双向的实时客户端-服务器通信，提供交互式的用户界面和即时更新。
反应式编程模型：提供反应式编程模型，自动同步客户端视图和服务器端视图模型，以保持用户界面的最新信息。
服务器端视图模型：简化应用程序内的状态管理和数据流，容易创建可由客户端组件绑定到的服务器端视图模型。
Blazor 和 JavaScript 支持：支持经典JavaScript前端和Blazor前端，允许开发人员选择最适合其需求的客户端技术。
易于集成：无缝地将实时功能集成到新项目或现有项目中，并且与如WebSockets的前端UI组件框架配合良好，也可以与使用 React Native、Vue 和 Blazor 的项目混合使用。
可扩展性：继承 SignalR 的可扩展性特性，使应用程序能够有效地管理大量并发连接。
MVVM 架构：采用模型-视图-视图模型 (MVVM) 架构，帮助分离责任，保持代码有序整洁。
事件处理：通过简化事件处理和数据绑定，减少处理UI交互和状态更改所需的样板代码。
可扩展且可定制：提供可扩展点和钩子，用于行为定制和其他库或框架的必要集成。
强大基础设施：提供动态路由机制，可在后端完全定义，能够进行嵌套路由、基于令牌的身份认证等功能。
开源和社区驱动：作为一个开源项目，DotNetify 受益于社区参与和贡献，确保持续的升级和改进。

在C#中创建和配置 DotNetify

要建立一个简单的项目并开始在 C# 在线应用程序中配置 DotNetify，请按照以下步骤操作。本教程演示了如何使用 ASP.NET Core 和 Blazor 设置基本的 DotNetify 服务器和客户端。

设置新的 ASP.NET Core Blazor 服务器项目

打开 Visual Studio：启动 Visual Studio 并创建一个新项目。
创建 Blazor 服务器应用程序：从项目模板中选择 Blazor 服务器应用程序模板，然后单击“下一步”。
配置您的项目：为您的项目提供一个名称（例如，"DotNetifyWebApp"）并进行必要的配置更改。点击“创建”。

通过 NuGet 安装 DotNetify

管理 NuGet 包：在解决方案资源管理器中右键点击你的项目并选择"Manage NuGet Packages"。
搜索 DotNetify：安装 DotNetify 和 DotNetify.Blazor 包。

配置 DotNetify

要配置 DotNetify，打开 Startup.cs 并使用 ConfigureServices 和 Configure 方法。

using DotNetify;
using DotNetify.Blazor;

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddRazorPages();
        services.AddServerSideBlazor();
        services.AddSignalR();
        services.AddDotNetify();
    }

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        else
        {
            app.UseExceptionHandler("/Error");
            app.UseHsts();
        }

        app.UseHttpsRedirection();
        app.UseStaticFiles();
        app.UseRouting();
        app.UseEndpoints(endpoints =>
        {
            endpoints.MapBlazorHub();
            endpoints.MapFallbackToPage("/_Host");
            endpoints.MapHub<DotNetifyHub>("/dotnetify");
        });
    }
}

using DotNetify;
using DotNetify.Blazor;

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddRazorPages();
        services.AddServerSideBlazor();
        services.AddSignalR();
        services.AddDotNetify();
    }

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        else
        {
            app.UseExceptionHandler("/Error");
            app.UseHsts();
        }

        app.UseHttpsRedirection();
        app.UseStaticFiles();
        app.UseRouting();
        app.UseEndpoints(endpoints =>
        {
            endpoints.MapBlazorHub();
            endpoints.MapFallbackToPage("/_Host");
            endpoints.MapHub<DotNetifyHub>("/dotnetify");
        });
    }
}

Imports DotNetify
Imports DotNetify.Blazor

Public Class Startup
	Public Sub ConfigureServices(ByVal services As IServiceCollection)
		services.AddRazorPages()
		services.AddServerSideBlazor()
		services.AddSignalR()
		services.AddDotNetify()
	End Sub

	Public Sub Configure(ByVal app As IApplicationBuilder, ByVal env As IWebHostEnvironment)
		If env.IsDevelopment() Then
			app.UseDeveloperExceptionPage()
		Else
			app.UseExceptionHandler("/Error")
			app.UseHsts()
		End If

		app.UseHttpsRedirection()
		app.UseStaticFiles()
		app.UseRouting()
		app.UseEndpoints(Sub(endpoints)
			endpoints.MapBlazorHub()
			endpoints.MapFallbackToPage("/_Host")
			endpoints.MapHub(Of DotNetifyHub)("/dotnetify")
		End Sub)
	End Sub
End Class

$vbLabelText $csharpLabel

创建一个 ViewModel

在您的项目中创建一个新的类文件（例如，HelloWorldViewModel.cs）并设计一个基本的 ViewModel。

using DotNetify;

public class HelloWorldViewModel : BaseVM
{
    public string Greetings => "Hello, World!";
}

using DotNetify;

public class HelloWorldViewModel : BaseVM
{
    public string Greetings => "Hello, World!";
}

Imports DotNetify

Public Class HelloWorldViewModel
	Inherits BaseVM

	Public ReadOnly Property Greetings() As String
		Get
			Return "Hello, World!"
		End Get
	End Property
End Class

$vbLabelText $csharpLabel

注册 ViewModel

在注册 ViewModel 之前，打开 Program.cs。

using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

public class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseStartup<Startup>();
            })
            .ConfigureServices(services =>
            {
                services.AddTransient<HelloWorldViewModel>();
            });
}

using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

public class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseStartup<Startup>();
            })
            .ConfigureServices(services =>
            {
                services.AddTransient<HelloWorldViewModel>();
            });
}

Imports Microsoft.AspNetCore.Hosting
Imports Microsoft.Extensions.DependencyInjection
Imports Microsoft.Extensions.Hosting

Public Class Program
	Public Shared Sub Main(ByVal args() As String)
		CreateHostBuilder(args).Build().Run()
	End Sub

	Public Shared Function CreateHostBuilder(ByVal args() As String) As IHostBuilder
		Return Host.CreateDefaultBuilder(args).ConfigureWebHostDefaults(Sub(webBuilder)
				webBuilder.UseStartup(Of Startup)()
		End Sub).ConfigureServices(Sub(services)
				services.AddTransient(Of HelloWorldViewModel)()
		End Sub})
	End Function

$vbLabelText $csharpLabel

创建 Blazor 组件

在您的项目中添加一个新的 Blazor 组件（例如，HelloWorld.razor）并将其连接到 ViewModel。

@page "/"

@using DotNetify
@using DotNetify.Blazor
@inject IDotNetifyService DotNetify

<h3>@greetings</h3>

@code {
    private string greetings;

    protected override async Task OnInitializedAsync()
    {
        var vm = await DotNetify.ConnectAsync<HelloWorldViewModel>(this);
        greetings = vm.Greetings;
    }
}