syncfusion-wpf-getting-started

Syncfusion を使い始めるための実装

Windows Presentation Foundation アプリケーションで Syncfusion® WPF コンポーネントをインストール、構成して使い始めるための完全ガイドです。このスキルでは、システム要件から最初のコントロールの追加まで、すべてを網羅しています。

このスキルを使用するタイミング

次の作業が必要な場合に、このスキルを使用してください。

• Syncfusion WPF コンポーネントをインストールする（Web インストーラー、オフラインインストーラー、NuGet パッケージ）
• Syncfusion WPF 開発のシステム要件を確認する
• WPF プロジェクトにSyncfusion コントロールを追加する（デザイナー、XAML、コードビハインド）
• Package Manager、CLI、Console を使用してNuGet パッケージを構成する
• Syncfusion を新しいバージョンにアップグレードする、またはトライアル版からライセンス版に移行する
• .resx ファイルを使用して多言語サポートのローカライズを設定する
• アラビア語、ヘブライ語、ウルドゥー語などの右から左（RTL）表示を設定する
• Syncfusion コントロールでMVVM パターンを実装する（コマンド、データバインディング、NotificationObject）
• インストールやセットアップの問題をトラブルシューティングする
• Syncfusion アセンブリ間の依存関係を把握する
• .NET Framework または .NET Core/.NET 8+ との互換性を設定する

このスキルは、Syncfusion WPF のすべてのセットアップおよび構成作業の出発点となります。

概要

Syncfusion® Essential® Studio for WPF は、最新の Windows デスクトップアプリケーションを構築するための包括的な UI コントロールスイートを提供します。使い始めるには、次の作業を行います。

1. システム要件を確認する（Windows OS、Visual Studio、.NET Framework/.NET）
2. インストール方法を選択する（Web インストーラー、オフラインインストーラー、NuGet）
3. コンポーネントをインストールまたはダウンロードする
4. WPF プロジェクトにコントロールを追加する
5. 参照、テーマ、ライセンスを構成する

セットアップ手順は、次のどちらを使用するかによって異なります。

• 完全インストーラー（すべてのコントロール、プロジェクトテンプレート、ドキュメントを含む）
• NuGet パッケージ（軽量で、コントロールごとにインストール）
• トライアル版（30 日間の評価用）またはライセンス版

ドキュメントとナビゲーションガイド

システム要件

📄 参照: references/system-requirements.md

次の項目を確認する必要がある場合は、このリファレンスを参照してください。

• 対応オペレーティングシステム（Windows XP から Windows 11 まで）
• ハードウェア要件（プロセッサー、RAM、ディスク容量）
• 開発環境（Visual Studio 2015/2017/2019/2022）
• .NET Framework のバージョン（4.0、4.6.2）と .NET のバージョン（8.0、9.0、10.0）
• 既存の開発環境との互換性

インストール方法

📄 参照: references/installation-methods.md

すべてのインストール方法を網羅したガイドです。

• Web インストーラー：Syncfusion.com からダウンロードしてインストールします（インストール中にインターネット接続が必要です）
• オフラインインストーラー：オフラインでインストールするための完全なパッケージをダウンロードします
• トライアル版とライセンス版：違いとそれぞれのダウンロード方法
• アカウントの設定とライセンスキーの生成
• インストールウィザードの手順
• トライアル版をインストールする際に必要なアンロックキー

プロジェクトへのコントロールの追加

📄 参照: references/adding-controls.md

Syncfusion コントロールを WPF アプリケーションに追加するすべての方法を説明します。

• デザイナーを使用：Visual Studio Toolbox からドラッグアンドドロップします
• XAML を使用：名前空間とコントロール宣言を手動で追加します
• コードビハインドを使用：C# または VB.NET でコントロールをプログラムから作成します
• プロジェクトテンプレートを使用：Syncfusion テンプレートで新しいプロジェクトを作成します
• アセンブリ参照の要件
• 名前空間の宣言

NuGet パッケージ管理

📄 参照: references/nuget-package-management.md

Syncfusion NuGet パッケージの利用に関する完全ガイドです。

• パッケージマネージャー UI：パッケージを視覚的に管理できます
• Dotnet CLI：dotnet add package を使用したコマンドラインでのインストール
• パッケージマネージャーコンソール：PowerShell ベースのパッケージコマンド
• nuget.org をパッケージソースとして設定する方法
• 特定のバージョンをインストールする方法
• パッケージを更新する方法
• フルインストーラーを使用しない場合の利用方法（NuGet のみのワークフロー）

アップグレードと移行

📄 参照: references/upgrading.md

Syncfusion を新しいバージョンにアップグレードする方法、またはライセンスを移行する方法です。

• Syncfusion Control Panel から最新バージョンにアップグレードする方法
• 新しいバージョンをダウンロードしてインストールする方法
• ボリュームリリースとサービスパックリリース
• トライアル版からライセンス版へのアップグレード（インストーラーまたは NuGet）
• ライセンスキーの登録
• バージョンの互換性に関する考慮事項

設定

📄 参照: references/configuration.md

フレームワークの互換性と基本的な設定について説明します。

• .NET Framework の互換性：異なるバージョンのフレームワークでの利用
• .NET Core/.NET 8+ の互換性：最新の .NET のサポート
• コントロールの依存関係：アセンブリ間の関係（一般的な 6 つの例）
• 右から左（RTL）：国際化アプリケーション向けの RTL サポート設定

ローカライズ

📄 参照: references/localization.md

Syncfusion WPF コントロールの多言語サポートを設定する方法です。

• アプリケーションカルチャの変更：CurrentUICulture の設定
• .resx ファイルの作成：翻訳用リソースファイルの設定
• 段階的なローカライズ：例を含む完全ガイド
• 一般的なカルチャコード：サポート対象の言語と地域
• 既定の文字列の編集：英語のテキストのカスタマイズ
• トラブルシューティング：ローカライズに関する問題の解決

パターンとプラクティス

📄 参照: references/patterns-and-practices.md

Syncfusion WPF 開発のための MVVM パターンとベストプラクティスです。

• MVVM の開始方法：基本的な MVVM 構造と設定
• MVVM コマンド：組み込みコマンド（TabControlExt など）の使用
• CommandParameter の使用方法：コマンドハンドラーへのデータの受け渡し
• コマンドターゲット：コマンドの対象要素の指定
• DataContext とデータバインディング：双方向バインディングと ItemsSource
• NotificationObject：INotifyPropertyChanged の実装
• MVVM の完全な例：SfDataGrid を使用した従業員管理
• テーマ管理：テーマと SfSkinManager の適用
• パフォーマンスのベストプラクティス：最適化のヒント

トラブルシューティング

📄 参照: references/troubleshooting.md

一般的なインストールと設定の問題を解決する方法です。

• インストールエラーとその解決方法
• ライセンス登録の問題
• アセンブリ参照の問題（「Could not load file or assembly」）
• NuGet パッケージのエラー
• バージョンの競合
• Visual Studio との統合に関する問題

クイックスタートの例

Syncfusion WPF コントロールを最も手早く使い始める方法は次のとおりです。

オプション 1：NuGet を使用する（クイックスタートにおすすめ）

# In Package Manager Console
Install-Package Syncfusion.SfGrid.WPF

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

オプション 2：フルインストーラーを使用する

1. Syncfusion.com からダウンロードしてインストールします
2. Visual Studio を開き → 新しい WPF プロジェクトを作成します
3. プロジェクトを右クリック → NuGet パッケージの管理 → 「Syncfusion.SfGrid.WPF」を参照します
4. または、ツールボックスからコントロールをドラッグします（インストール後、Syncfusion コントロールが表示されます）

ライセンス登録（トライアル版／NuGet の場合は必須）

// In App.xaml.cs or before InitializeComponent()
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR_LICENSE_KEY");

注: トライアルインストーラーまたは NuGet パッケージを使用する場合は、ライセンス登録が必要です。Syncfusion License & Downloads ページからライセンスキーを生成してください。

一般的なパターン

パターン 1：Web インストーラーを使用したインストール

使用する場面：インターネット接続が安定しており、すべての機能を備えた最新バージョンを使用したい場合。

1. Syncfusion.com のダウンロードページにアクセスします
2. WPF プラットフォームを選択します
3. Web インストーラーをダウンロードします
4. インストーラーを実行します（インストール中にインターネット接続が必要です）
5. ウィザードに従ってコンポーネントを選択します
6. Visual Studio を起動して、開発を開始します

パターン 2：NuGet を使用したインストール（インストーラーなし）

使用する場面：軽量なインストール、コントロール単位でのインストール、または CI/CD 環境での使用を希望する場合。

# Install specific controls as needed
Install-Package Syncfusion.SfGrid.WPF
Install-Package Syncfusion.SfChart.WPF
Install-Package Syncfusion.SfBusyIndicator.WPF

利点：

• フルインストーラーが不要です
• 必要なコントロールだけをインストールできます
• プロジェクトごとにバージョンを簡単に管理できます
• CI/CD パイプラインで快適に動作します

注：アプリケーションにライセンスキーを登録する必要があります。

パターン 3：Syncfusion テンプレートを使用した新規プロジェクトの作成

使用する場面：Syncfusion コンポーネントを使用して、新しい WPF アプリケーションを開始する場合。

1. フルインストーラーから Syncfusion WPF をインストールします
2. Visual Studio → ファイル → 新しいプロジェクト
3. 「Syncfusion WPF Application」を検索します
4. テンプレートを選択 → プロジェクトを構成します
5. Project Configuration Wizard でコントロール、テーマ、言語を選択します
6. 参照、XAML、ライセンス設定を含むプロジェクトが作成されます

パターン 4：デザイナーを使用したコントロールの追加

使用する場面：ビジュアル開発、迅速なプロトタイピング。

1. Syncfusion がインストールされていることを確認します（フルインストーラー）
2. Visual Studio で WPF プロジェクトを開きます
3. デザイナービューで MainWindow.xaml を開きます
4. ツールボックスを開きます（表示 → ツールボックス）
5. コントロール（例：「SfDataGrid」）を検索します
6. デザイナーにドラッグ＆ドロップします
7. Visual Studio が参照と名前空間を自動的に追加します

パターン 5：試用版からライセンス版へのアップグレード

使用する場面：試用期間が終了する場合、またはライセンスを購入した場合。

インストーラーを使用している場合：

1. ライセンスとダウンロードからライセンス版のインストーラーをダウンロードします
2. インストーラーを実行します（試用版をアンインストールする必要はありません）
3. ライセンス版が試用版に置き換わります

NuGet パッケージを使用している場合：

1. ライセンスとダウンロードからライセンスキーを生成します
2. コード内の試用版ライセンスキーを置き換えます：

// Replace trial key with licensed key
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR_LICENSED_KEY");

インストール方法の選択フローチャート

このフローチャートを使用して、インストール方法を選択してください：

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

特別なケース：

• CI/CD 環境：ライセンス登録を自動化した NuGet パッケージを使用します
• エンタープライズ環境へのデプロイ：インストールの一貫性を保つため、オフラインインストーラーを使用します
• 迅速なプロトタイピング：Web インストーラー、または必要なコントロールを指定した NuGet を使用します
• 学習・評価：試用版（Web インストーラーまたはオフラインインストーラー）を使用します

主な概念

アセンブリ参照

Syncfusion のコントロールは、複数のアセンブリに分かれて提供されています。一般的なアセンブリには、次のものがあります。

• Syncfusion.SfGrid.WPF.dll - データグリッドコントロール
• Syncfusion.SfChart.WPF.dll - チャートコントロール
• Syncfusion.SfShared.WPF.dll - 共通機能
• Syncfusion.SfInput.WPF.dll - 入力コントロール
• Syncfusion.Tools.WPF.dll - ツールコントロール（リボンなど）

各コントロールは、共通アセンブリに依存する場合があります。NuGet ではこれらが自動的に処理されますが、手動で参照を追加する場合は依存関係を理解する必要があります。

名前空間の宣言

XAML の標準的な名前空間宣言：

xmlns:syncfusion="http://schemas.syncfusion.com/wpf"

コードビハインドでは、個別の名前空間を使用します：

using Syncfusion.UI.Xaml.Grid;        // For SfDataGrid
using Syncfusion.UI.Xaml.Charts;      // For SfChart
using Syncfusion.Windows.Controls.Input; // For input controls

ライセンスキーの管理

ライセンスキーが必要な場合：

• 試用版インストーラーを使用する場合
• nuget.org の NuGet パッケージを使用する場合

ライセンスキーが不要な場合：

• インストールディレクトリのアセンブリ参照を使って、ライセンス版インストーラーを使用する場合

登録方法：

// In App.xaml.cs constructor, before InitializeComponent()
public App()
{
    Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR_LICENSE_KEY");
    InitializeComponent();
}

テーマの構成

Syncfusion では複数のテーマを提供しています。テーマを適用するには：

<Application.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <ResourceDictionary Source="/Syncfusion.Themes.MaterialLight.WPF;component/MSControl/SfDataGrid.xaml"/>
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</Application.Resources>

テーマの設定方法については、構成リファレンスを参照してください。

一般的なユースケース

ユースケース 1：Syncfusion を評価する新規開発者

目標：最小限のセットアップで Syncfusion WPF コントロールを試します。

手順：

1. システム要件を確認します
2. 試用版 Web インストーラーをダウンロードします
3. 既定のオプションでインストールします
4. Syncfusion WPF アプリケーション テンプレートを使用してプロジェクトを作成します
5. ツールボックスからコントロールを確認します

ユースケース 2：既存のプロジェクトに Syncfusion を追加する

目標：既存の WPF アプリケーションに特定の Syncfusion コントロールを追加します。

手順：

1. NuGet からコントロールをインストールします：

   Install-Package Syncfusion.SfGrid.WPF
   

2. App.xaml.cs でライセンスキーを登録します
3. XAML を使用してコントロールを追加します

ユースケース 3：エンタープライズへのデプロイ

目標：インターネット接続に依存せず、複数の開発者マシンに Syncfusion をデプロイします。

手順：

1. オフライン インストーラーをダウンロードします
2. インストーラーパッケージを社内で配布します
3. 各開発者マシンにインストールします
4. 登録用のライセンスキーを提供します

ユースケース 4：既存のプロジェクトをアップグレードする

目標：古い Syncfusion バージョンを使用しているプロジェクトを最新バージョンに更新します。

手順：

1. アップグレードガイドを確認します
2. アカウントのダウンロードページから最新バージョンをダウンロードします
3. NuGet パッケージを更新するか、新しいバージョンをインストールします
4. 互換性を損なう変更がないかテストします
5. 必要に応じてライセンスキーを更新します

ユースケース 5：ローカライズされたアプリケーション

目標：Syncfusion コントロールを使用する WPF アプリケーションで複数の言語をサポートします。

手順：

1. ローカライズリソースを設定します
2. 対象カルチャ用の .resx ファイルを作成します
3. 起動時にアプリケーションのカルチャを設定します
4. Syncfusion コントロールはローカライズされた文字列を自動的に使用します

次のステップ

セットアップの完了後：

1. ローカライズを設定する（多言語アプリを構築する場合）：

   • .resx の設定方法については、references/localization.md を参照してください

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. フレームワークの互換性を設定する：

   • .NET Framework と .NET Core/.NET の設定については、references/configuration.md を参照してください

関連リソース

• 公式ドキュメント：Syncfusion WPF ドキュメント
• アップグレードガイド：互換性を損なう変更と更新
• ライセンス：ライセンスキーの概要
• コンポーネントライブラリ：特定のコンポーネントの実装には、implementing-syncfusion-wpf-components スキルを使用してください