syncfusion-wpf-getting-started

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Implementing Syncfusion Getting Started

Syncfusion入门实操

Complete guide for installing, configuring, and getting started with Syncfusion® WPF components in Windows Presentation Foundation applications. This skill covers everything from system requirements to adding your first control.
本指南是在Windows Presentation Foundation应用中安装、配置和入门Syncfusion® WPF组件的完整教程,涵盖了从系统要求验证到添加第一个控件的所有内容。

When to Use This Skill

何时使用本指南

Use this skill when you need to:
  • Install Syncfusion WPF components (web installer, offline installer, or NuGet packages)
  • Check system requirements for Syncfusion WPF development
  • Add Syncfusion controls to a WPF project (Designer, XAML, or code-behind)
  • Configure NuGet packages using Package Manager, CLI, or Console
  • Upgrade Syncfusion to a newer version or migrate from trial to licensed version
  • Set up localization for multi-language support with .resx files
  • Configure right-to-left (RTL) support for Arabic, Hebrew, Urdu, etc.
  • Implement MVVM patterns with Syncfusion controls (commands, data binding, NotificationObject)
  • Troubleshoot installation or setup issues
  • Understand dependencies between Syncfusion assemblies
  • Configure compatibility with .NET Framework or .NET Core/.NET 8+
This skill is your starting point for all Syncfusion WPF setup and configuration tasks.
当你需要以下帮助时,可使用本指南:
  • 安装Syncfusion WPF组件(在线安装程序、离线安装程序或NuGet包)
  • 检查Syncfusion WPF开发的系统要求
  • 向WPF项目中添加Syncfusion控件(通过设计器、XAML或代码后置)
  • 使用包管理器、CLI或控制台配置NuGet包
  • 将Syncfusion升级到新版本,或从试用版迁移到授权版
  • 使用.resx文件设置多语言支持的本地化
  • 为阿拉伯语、希伯来语、乌尔都语等配置从右到左(RTL)的显示支持
  • 结合Syncfusion控件实现MVVM模式(命令、数据绑定、NotificationObject)
  • 排查安装或设置问题
  • 了解Syncfusion程序集之间的依赖关系
  • 配置与.NET Framework或.NET Core/.NET 8+的兼容性
本指南是所有Syncfusion WPF安装和配置任务的起点。

Overview

概述

Syncfusion® Essential® Studio for WPF provides a comprehensive suite of UI controls for building modern Windows desktop applications. Getting started involves:
  1. Verifying system requirements (Windows OS, Visual Studio, .NET Framework/.NET)
  2. Choosing an installation method (Web Installer, Offline Installer, or NuGet)
  3. Installing or downloading the components
  4. Adding controls to your WPF project
  5. Configuring references, themes, and licensing
The setup process varies based on whether you're using:
  • Full installer (includes all controls, project templates, documentation)
  • NuGet packages (lightweight, control-by-control installation)
  • Trial version (30-day evaluation) or Licensed version
Syncfusion® Essential® Studio for WPF提供了一套全面的UI控件,用于构建现代Windows桌面应用。入门流程包括:
  1. 验证系统要求(Windows操作系统、Visual Studio、.NET Framework/.NET)
  2. 选择安装方式(在线安装程序、离线安装程序或NuGet)
  3. 安装或下载组件
  4. 向WPF项目中添加控件
  5. 配置引用、主题和授权
设置流程会因你使用的方式而异:
  • 完整安装程序(包含所有控件、项目模板、文档)
  • NuGet包(轻量级,按需安装单个控件)
  • 试用版(30天评估)或授权版

Documentation and Navigation Guide

文档与导航指南

System Requirements

系统要求

📄 Read: references/system-requirements.md
Check this reference when you need to verify:
  • Operating systems supported (Windows XP through Windows 11)
  • Hardware requirements (processor, RAM, disk space)
  • Development environment (Visual Studio 2015/2017/2019/2022)
  • .NET Framework versions (4.0, 4.6.2) and .NET versions (8.0, 9.0, 10.0)
  • Compatibility with your existing development setup
📄 阅读: references/system-requirements.md
当你需要验证以下内容时,查看此参考文档:
  • 支持的操作系统(Windows XP至Windows 11)
  • 硬件要求(处理器、内存、磁盘空间)
  • 开发环境(Visual Studio 2015/2017/2019/2022)
  • .NET Framework版本(4.0、4.6.2)和.NET版本(8.0、9.0、10.0)
  • 与现有开发环境的兼容性

Installation Methods

安装方式

📄 Read: references/installation-methods.md
Comprehensive guide for all installation approaches:
  • Web Installer: Download and install from Syncfusion.com (requires internet during installation)
  • Offline Installer: Download full package for offline installation
  • Trial vs Licensed: Differences and how to download each
  • Account setup and license key generation
  • Installation wizard walkthrough
  • Unlock key requirements for trial installations
📄 阅读: references/installation-methods.md
所有安装方式的全面指南:
  • 在线安装程序:从Syncfusion.com下载并安装(安装过程需要联网)
  • 离线安装程序:下载完整包以进行离线安装
  • 试用版 vs 授权版:两者的区别及下载方式
  • 账户设置和许可证密钥生成
  • 安装向导分步指引
  • 试用版安装所需的解锁密钥要求

Adding Controls to Projects

向项目中添加控件

📄 Read: references/adding-controls.md
Learn all methods for adding Syncfusion controls to your WPF application:
  • Using Designer: Drag-and-drop from Visual Studio Toolbox
  • Using XAML: Add namespace and control declarations manually
  • Using Code-Behind: Create controls programmatically in C# or VB.NET
  • Using Project Templates: Create new projects with Syncfusion templates
  • Assembly reference requirements
  • Namespace declarations
📄 阅读: references/adding-controls.md
了解向WPF应用中添加Syncfusion控件的所有方法:
  • 使用设计器:从Visual Studio工具箱拖放控件
  • 使用XAML:手动添加命名空间和控件声明
  • 使用代码后置:在C#或VB.NET中以编程方式创建控件
  • 使用项目模板:通过Syncfusion模板创建新项目
  • 程序集引用要求
  • 命名空间声明

NuGet Package Management

NuGet包管理

📄 Read: references/nuget-package-management.md
Complete guide to working with Syncfusion NuGet packages:
  • Package Manager UI: Visual interface for package management
  • Dotnet CLI: Command-line installation with
    dotnet add package
  • Package Manager Console: PowerShell-based package commands
  • Configuring nuget.org as a package source
  • Installing specific versions
  • Updating packages
  • Working without full installer (NuGet-only workflow)
📄 阅读: references/nuget-package-management.md
Syncfusion NuGet包的完整使用指南:
  • 包管理器UI:可视化的包管理界面
  • Dotnet CLI:使用
    dotnet add package
    命令行安装
  • 包管理器控制台:基于PowerShell的包管理命令
  • 配置nuget.org作为包源
  • 安装特定版本
  • 更新包
  • 无需完整安装程序的工作流(仅使用NuGet)

Upgrading and Migration

升级与迁移

📄 Read: references/upgrading.md
Upgrade Syncfusion to newer versions or migrate licensing:
  • Upgrading to latest version from Syncfusion Control Panel
  • Downloading and installing newer versions
  • Volume releases vs Service Pack releases
  • Upgrading from trial to licensed version (installer or NuGet)
  • License key registration
  • Version compatibility considerations
📄 阅读: references/upgrading.md
将Syncfusion升级到新版本或迁移授权:
  • 通过Syncfusion控制面板升级到最新版本
  • 下载并安装新版本
  • 正式版本与服务包版本的区别
  • 从试用版升级到授权版(安装程序或NuGet方式)
  • 许可证密钥注册
  • 版本兼容性注意事项

Configuration

配置

📄 Read: references/configuration.md
Framework compatibility and core configuration:
  • .NET Framework compatibility: Working with different framework versions
  • .NET Core/.NET 8+ compatibility: Modern .NET support
  • Control dependencies: Understanding assembly relationships (6 common examples)
  • Right-to-left (RTL): Configuring RTL support for international applications
📄 阅读: references/configuration.md
框架兼容性和核心配置:
  • .NET Framework兼容性:与不同框架版本的适配
  • .NET Core/.NET 8+兼容性:对现代.NET的支持
  • 控件依赖:了解程序集之间的关系(6个常见示例)
  • 从右到左(RTL):为国际化应用配置RTL支持

Localization

本地化

📄 Read: references/localization.md
Setting up multi-language support for Syncfusion WPF controls:
  • Changing application culture: Setting CurrentUICulture
  • Creating .resx files: Resource file setup for translations
  • Step-by-step localization: Complete guide with examples
  • Common culture codes: Supported languages and regions
  • Editing default strings: Customizing English text
  • Troubleshooting: Resolving localization issues
📄 阅读: references/localization.md
为Syncfusion WPF控件设置多语言支持:
  • 更改应用区域性:设置CurrentUICulture
  • 创建.resx文件:用于翻译的资源文件设置
  • 分步本地化:带示例的完整指南
  • 常见区域性代码:支持的语言和地区
  • 编辑默认字符串:自定义英文文本
  • 故障排除:解决本地化相关问题

Patterns and Practices

模式与实践

📄 Read: references/patterns-and-practices.md
MVVM patterns and best practices for Syncfusion WPF development:
  • Getting started with MVVM: Basic MVVM structure and setup
  • MVVM commands: Using built-in commands (TabControlExt, etc.)
  • CommandParameter usage: Passing data to command handlers
  • Command target: Specifying command target elements
  • DataContext and data binding: Two-way binding and ItemsSource
  • NotificationObject: INotifyPropertyChanged implementation
  • Complete MVVM example: Employee management with SfDataGrid
  • Theme management: Applying themes and SfSkinManager
  • Performance best practices: Optimization tips
📄 阅读: references/patterns-and-practices.md
Syncfusion WPF开发的MVVM模式与最佳实践:
  • MVVM入门:基本MVVM结构和设置
  • MVVM命令:使用内置命令(如TabControlExt等)
  • CommandParameter用法:向命令处理程序传递数据
  • Command目标:指定命令的目标元素
  • DataContext与数据绑定:双向绑定和ItemsSource
  • NotificationObject:INotifyPropertyChanged的实现
  • 完整MVVM示例:使用SfDataGrid的员工管理系统
  • 主题管理:应用主题和SfSkinManager
  • 性能最佳实践:优化技巧

Troubleshooting

故障排除

📄 Read: references/troubleshooting.md
Solutions for common installation and setup issues:
  • Installation errors and how to resolve them
  • License registration problems
  • Assembly reference issues ("Could not load file or assembly")
  • NuGet package errors
  • Version conflicts
  • Visual Studio integration issues
📄 阅读: references/troubleshooting.md
常见安装和设置问题的解决方案:
  • 安装错误及解决方法
  • 许可证注册问题
  • 程序集引用问题(“无法加载文件或程序集”)
  • NuGet包错误
  • 版本冲突
  • Visual Studio集成问题

Quick Start Example

快速入门示例

Here's the fastest way to get started with a Syncfusion WPF control:
以下是开始使用Syncfusion WPF控件的最快方式:

Option 1: Using NuGet (Recommended for Quick Start)

选项1:使用NuGet(推荐用于快速入门)

powershell
undefined
powershell
undefined

In Package Manager Console

在包管理器控制台中执行

Install-Package Syncfusion.SfGrid.WPF

```xml
<!-- In MainWindow.xaml -->
<Window x:Class="WpfApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:syncfusion="http://schemas.syncfusion.com/wpf"
        Title="Syncfusion WPF Demo" Height="450" Width="800">
    <Grid>
        <syncfusion:SfDataGrid x:Name="dataGrid" 
                               AutoGenerateColumns="True"
                               ItemsSource="{Binding Employees}"/>
    </Grid>
</Window>
Install-Package Syncfusion.SfGrid.WPF

```xml
<!-- 在MainWindow.xaml中 -->
<Window x:Class="WpfApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:syncfusion="http://schemas.syncfusion.com/wpf"
        Title="Syncfusion WPF Demo" Height="450" Width="800">
    <Grid>
        <syncfusion:SfDataGrid x:Name="dataGrid" 
                               AutoGenerateColumns="True"
                               ItemsSource="{Binding Employees}"/>
    </Grid>
</Window>

Option 2: Using Full Installer

选项2:使用完整安装程序

  1. Download and install from Syncfusion.com
  2. Open Visual Studio → Create new WPF project
  3. Right-click project → Manage NuGet Packages → Browse "Syncfusion.SfGrid.WPF"
  4. Or drag control from Toolbox (Syncfusion controls appear after installation)
  1. Syncfusion.com下载并安装
  2. 打开Visual Studio → 创建新的WPF项目
  3. 右键点击项目 → 管理NuGet包 → 搜索“Syncfusion.SfGrid.WPF”
  4. 或者从工具箱拖放控件(安装完成后Syncfusion控件会显示在工具箱中)

License Registration (Required for Trial/NuGet)

许可证注册(试用版/NuGet方式必需)

csharp
// In App.xaml.cs or before InitializeComponent()
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR_LICENSE_KEY");
Note: License registration is required if using trial installer or NuGet packages. Generate your license key from the Syncfusion License & Downloads page.
csharp
// 在App.xaml.cs中或InitializeComponent()之前
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR_LICENSE_KEY");
注意:如果使用试用版安装程序或NuGet包,必须注册许可证密钥。可从Syncfusion License & Downloads页面生成你的许可证密钥。

Common Patterns

常见模式

Pattern 1: Installing via Web Installer

模式1:通过在线安装程序安装

When to use: You have reliable internet and want the latest version with all features.
  1. Visit Syncfusion.com Downloads
  2. Select WPF platform
  3. Download the web installer
  4. Run installer (requires internet during installation)
  5. Follow wizard to select components
  6. Launch Visual Studio and start developing
适用场景:你有稳定的网络,并且需要带全部功能的最新版本。
  1. 访问Syncfusion.com Downloads
  2. 选择WPF平台
  3. 下载在线安装程序
  4. 运行安装程序(安装过程需要联网)
  5. 按照向导选择组件
  6. 启动Visual Studio并开始开发

Pattern 2: Installing via NuGet (No Installer)

模式2:通过NuGet安装(无需安装程序)

When to use: You want lightweight installation, control-by-control, or CI/CD environments.
powershell
undefined
适用场景:你需要轻量级安装、按需选择控件,或用于CI/CD环境。
powershell
undefined

Install specific controls as needed

根据需要安装特定控件

Install-Package Syncfusion.SfGrid.WPF Install-Package Syncfusion.SfChart.WPF Install-Package Syncfusion.SfBusyIndicator.WPF

**Advantages**:
- No full installer required
- Install only the controls you need
- Easy version management per project
- Works great in CI/CD pipelines

**Note**: You'll need to register a license key in your application.
Install-Package Syncfusion.SfGrid.WPF Install-Package Syncfusion.SfChart.WPF Install-Package Syncfusion.SfBusyIndicator.WPF

**优势**:
- 无需完整安装程序
- 仅安装你需要的控件
- 便于按项目管理版本
- 非常适合CI/CD流水线

**注意**:你需要在应用中注册许可证密钥。

Pattern 3: Creating a New Project with Syncfusion Template

模式3:使用Syncfusion模板创建新项目

When to use: Starting a new WPF application with Syncfusion components.
  1. Install Syncfusion WPF from full installer
  2. Visual Studio → File → New Project
  3. Search for "Syncfusion WPF Application"
  4. Select template → Configure project
  5. Choose controls, theme, and language in Project Configuration Wizard
  6. Project created with references, XAML, and licensing setup
适用场景:开始一个包含Syncfusion组件的新WPF应用。
  1. 通过完整安装程序安装Syncfusion WPF
  2. 打开Visual Studio → 文件 → 新建项目
  3. 搜索“Syncfusion WPF Application”
  4. 选择模板 → 配置项目
  5. 在项目配置向导中选择控件、主题和语言
  6. 创建的项目已包含引用、XAML和授权设置

Pattern 4: Adding Control via Designer

模式4:通过设计器添加控件

When to use: Visual development, quick prototyping.
  1. Ensure Syncfusion is installed (full installer)
  2. Open your WPF project in Visual Studio
  3. Open MainWindow.xaml in Designer view
  4. Open Toolbox (View → Toolbox)
  5. Search for control (e.g., "SfDataGrid")
  6. Drag and drop onto the designer
  7. Visual Studio automatically adds references and namespace
适用场景:可视化开发、快速原型制作。
  1. 确保已安装Syncfusion(完整安装程序)
  2. 在Visual Studio中打开你的WPF项目
  3. 在设计器视图中打开MainWindow.xaml
  4. 打开工具箱(视图 → 工具箱)
  5. 搜索控件(例如“SfDataGrid”)
  6. 将控件拖放到设计器上
  7. Visual Studio会自动添加引用和命名空间

Pattern 5: Upgrading from Trial to Licensed

模式5:从试用版升级到授权版

When to use: Your trial period is ending or you've purchased a license.
If using installer:
  1. Download licensed installer from License & Downloads
  2. Run installer (no need to uninstall trial)
  3. Licensed version replaces trial
If using NuGet packages:
  1. Generate license key from License & Downloads
  2. Replace trial license key in your code:
csharp
// Replace trial key with licensed key
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR_LICENSED_KEY");
适用场景:你的试用期限即将结束,或者你已购买了授权。
如果使用安装程序
  1. License & Downloads下载授权版安装程序
  2. 运行安装程序(无需卸载试用版)
  3. 授权版会替换试用版
如果使用NuGet包
  1. License & Downloads生成许可证密钥
  2. 在代码中替换试用版许可证密钥:
csharp
// 用授权密钥替换试用密钥
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR_LICENSED_KEY");

Installation Workflow Decision Tree

安装工作流决策树

Use this decision tree to choose your installation approach:
Do you need all Syncfusion WPF controls?
├─ YES → Do you have reliable internet?
│   ├─ YES → Use Web Installer
│   └─ NO → Use Offline Installer
└─ NO → Do you need only a few specific controls?
    └─ YES → Use NuGet Packages
        ├─ Package Manager UI (visual approach)
        ├─ Package Manager Console (PowerShell commands)
        └─ Dotnet CLI (command-line for .NET Core/.NET 8+)
Special cases:
  • CI/CD environments: Use NuGet packages with automated license registration
  • Enterprise deployments: Use Offline Installer for consistent installations
  • Rapid prototyping: Use Web Installer or NuGet with specific controls
  • Learning/evaluation: Use Trial version (web or offline installer)
使用此决策树选择你的安装方式:
你是否需要所有Syncfusion WPF控件?
├─ 是 → 你有稳定的网络吗?
│   ├─ 是 → 使用在线安装程序
│   └─ 否 → 使用离线安装程序
└─ 否 → 你只需要少数特定控件吗?
    └─ 是 → 使用NuGet包
        ├─ 包管理器UI(可视化方式)
        ├─ 包管理器控制台(PowerShell命令)
        └─ Dotnet CLI(适用于.NET Core/.NET 8+的命令行)
特殊场景
  • CI/CD环境:使用NuGet包并自动注册许可证
  • 企业部署:使用离线安装程序以确保一致的安装
  • 快速原型制作:使用在线安装程序或NuGet安装特定控件
  • 学习/评估:使用试用版(在线或离线安装程序)

Key Concepts

核心概念

Assembly References

程序集引用

Syncfusion controls are distributed across multiple assemblies. Common assemblies include:
  • Syncfusion.SfGrid.WPF.dll
    - Data Grid controls
  • Syncfusion.SfChart.WPF.dll
    - Charting controls
  • Syncfusion.SfShared.WPF.dll
    - Shared functionality
  • Syncfusion.SfInput.WPF.dll
    - Input controls
  • Syncfusion.Tools.WPF.dll
    - Tool controls (Ribbon, etc.)
Each control may have dependencies on shared assemblies. NuGet handles these automatically; manual references require dependency understanding.
Syncfusion控件分布在多个程序集中。常见的程序集包括:
  • Syncfusion.SfGrid.WPF.dll
    - 数据网格控件
  • Syncfusion.SfChart.WPF.dll
    - 图表控件
  • Syncfusion.SfShared.WPF.dll
    - 共享功能
  • Syncfusion.SfInput.WPF.dll
    - 输入控件
  • Syncfusion.Tools.WPF.dll
    - 工具控件(如Ribbon等)
每个控件可能依赖于共享程序集。NuGet会自动处理这些依赖;手动引用则需要了解依赖关系。

Namespace Declarations

命名空间声明

Standard namespace declaration for XAML:
xml
xmlns:syncfusion="http://schemas.syncfusion.com/wpf"
For code-behind, use specific namespaces:
csharp
using Syncfusion.UI.Xaml.Grid;        // For SfDataGrid
using Syncfusion.UI.Xaml.Charts;      // For SfChart
using Syncfusion.Windows.Controls.Input; // For input controls
XAML中的标准命名空间声明:
xml
xmlns:syncfusion="http://schemas.syncfusion.com/wpf"
在代码后置中,使用特定的命名空间:
csharp
using Syncfusion.UI.Xaml.Grid;        // 用于SfDataGrid
using Syncfusion.UI.Xaml.Charts;      // 用于SfChart
using Syncfusion.Windows.Controls.Input; // 用于输入控件

License Key Management

许可证密钥管理

When license key is required:
  • Using trial installer
  • Using NuGet packages from nuget.org
When license key is NOT required:
  • Using licensed installer with assembly references from installation directory
How to register:
csharp
// In App.xaml.cs constructor, before InitializeComponent()
public App()
{
    Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR_LICENSE_KEY");
    InitializeComponent();
}
需要许可证密钥的场景
  • 使用试用版安装程序
  • 使用nuget.org的NuGet包
不需要许可证密钥的场景
  • 使用授权版安装程序,且引用安装目录中的程序集
注册方法
csharp
// 在App.xaml.cs构造函数中,在InitializeComponent()之前
public App()
{
    Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR_LICENSE_KEY");
    InitializeComponent();
}

Theme Configuration

主题配置

Syncfusion provides multiple themes. To apply a theme:
xml
<!-- In App.xaml -->
<Application.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <ResourceDictionary Source="/Syncfusion.Themes.MaterialLight.WPF;component/MSControl/SfDataGrid.xaml"/>
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</Application.Resources>
See the configuration reference for complete theme setup.
Syncfusion提供多种主题。应用主题的方法:
xml
<!-- 在App.xaml中 -->
<Application.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <ResourceDictionary Source="/Syncfusion.Themes.MaterialLight.WPF;component/MSControl/SfDataGrid.xaml"/>
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</Application.Resources>
完整的主题设置请查看配置参考文档。

Common Use Cases

常见用例

Use Case 1: New Developer Evaluating Syncfusion

用例1:新开发者评估Syncfusion

Goal: Try Syncfusion WPF controls with minimal setup.
Approach:
  1. Check system requirements
  2. Download trial web installer
  3. Install with default options
  4. Create project using Syncfusion WPF Application template
  5. Explore controls from Toolbox
目标:通过最少的设置试用Syncfusion WPF控件。
方法
  1. 查看系统要求
  2. 下载试用版在线安装程序
  3. 使用默认选项安装
  4. 使用Syncfusion WPF应用模板创建项目
  5. 从工具箱探索控件

Use Case 2: Adding Syncfusion to Existing Project

用例2:向现有项目中添加Syncfusion

Goal: Add specific Syncfusion controls to an existing WPF application.
Approach:
  1. Install control via NuGet:
    powershell
    Install-Package Syncfusion.SfGrid.WPF
  2. Register license key in App.xaml.cs
  3. Add control using XAML
目标:向现有WPF应用中添加特定的Syncfusion控件。
方法
  1. 通过NuGet安装控件:
    powershell
    Install-Package Syncfusion.SfGrid.WPF
  2. 在App.xaml.cs中注册许可证密钥
  3. 通过XAML添加控件

Use Case 3: Enterprise Deployment

用例3:企业部署

Goal: Deploy Syncfusion to multiple developer machines without internet dependency.
Approach:
  1. Download offline installer
  2. Distribute installer package internally
  3. Install on each developer machine
  4. Provide license keys for registration
目标:在没有网络依赖的情况下向多台开发者机器部署Syncfusion。
方法
  1. 下载离线安装程序
  2. 在内部分发安装程序包
  3. 在每台开发者机器上安装
  4. 提供许可证密钥用于注册

Use Case 4: Upgrading Existing Project

用例4:升级现有项目

Goal: Update project from older Syncfusion version to latest.
Approach:
  1. Review Upgrade Guide
  2. Download latest version from account downloads
  3. Update NuGet packages or install new version
  4. Test for breaking changes
  5. Update license key if needed
目标:将项目从旧版Syncfusion更新到最新版。
方法
  1. 查看升级指南
  2. 账户下载页面下载最新版本
  3. 更新NuGet包或安装新版本
  4. 测试是否存在破坏性变更
  5. 如有需要更新许可证密钥

Use Case 5: Localized Application

用例5:本地化应用

Goal: Support multiple languages in WPF application with Syncfusion controls.
Approach:
  1. Set up localization resources
  2. Create .resx files for target cultures
  3. Set application culture at startup
  4. Syncfusion controls automatically use localized strings
目标:在WPF应用中为Syncfusion控件提供多语言支持。
方法
  1. 设置本地化资源
  2. 为目标区域性创建.resx文件
  3. 在启动时设置应用区域性
  4. Syncfusion控件会自动使用本地化字符串

Next Steps

后续步骤

After completing setup:
  1. Set up localization (if building international apps):
    • See references/localization.md for complete .resx setup guide
  2. Learn MVVM patterns with Syncfusion controls:
    • See references/patterns-and-practices.md for commands, data binding, and best practices
  3. Explore component-specific skills:
    • For charting: See implementing-syncfusion-wpf-components → Charts
    • For data grids: See implementing-syncfusion-wpf-components → Data Grids
    • For editors: See implementing-syncfusion-wpf-components → Editors
  4. Configure framework compatibility:
    • See references/configuration.md for .NET Framework and .NET Core/.NET setup
完成设置后:
  1. 设置本地化(如果构建国际化应用):
    • 查看references/localization.md获取完整的.resx设置指南
  2. 学习结合Syncfusion控件的MVVM模式
    • 查看references/patterns-and-practices.md了解命令、数据绑定和最佳实践
  3. 探索组件特定技能
    • 图表相关:查看implementing-syncfusion-wpf-components → Charts
    • 数据网格相关:查看implementing-syncfusion-wpf-components → Data Grids
    • 编辑器相关:查看implementing-syncfusion-wpf-components → Editors
  4. 配置框架兼容性
    • 查看references/configuration.md了解.NET Framework和.NET Core/.NET的设置

Related Resources

相关资源