syncfusion-winforms-common

Syncfusion Windows Forms コンポーネントの実装

デスクトップアプリケーションに Syncfusion® Essential Studio® Windows Forms（WinForms）コントロールを実装するための包括的なガイドです。このスキルでは、初期設定とインストールから、ローカライズや .NET との互換性まで、あらゆる内容を扱います。

このスキルを使用する場面

次のような場合に、このスキルを使用してください。

• Windows Forms アプリケーションに Syncfusion WinForms コントロールを追加する
• WinForms アプリケーションの ライセンスキーを登録、管理する
• インストーラーまたは NuGet を使用して Syncfusion WinForms を インストール、アップグレードする
• Syncfusion WinForms コントロールを使用する .NET Core / .NET 5-9 プロジェクトを設定する
• Syncfusion WinForms コントロールの 高 DPI サポートを有効にする
• さまざまなカルチャに合わせて Syncfusion WinForms コントロールを ローカライズする
• インストール、ライセンス、または実行時のエラーを トラブルシューティングする

ライブラリの概要

Windows Forms 向け Syncfusion® Essential Studio® は、グリッド、チャート、スケジューラー、エディター、ナビゲーション、レイアウト、入力コントロールなど、リッチな Windows デスクトップアプリケーションを構築するための包括的な UI コントロールスイートを提供します。すべてのコントロールは WinForms アプリケーション向けに設計されており、.NET Framework 4.6.2 以降および .NET 6.0–9.0 をサポートしています。

---

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

はじめに

📄 参照： references/getting-started.md

• デザイナーを使用したコントロールの追加（ツールボックスからドラッグ＆ドロップ）
• コードを使用したコントロールの追加（C# / VB）
• プロジェクトテンプレートと項目テンプレートの使用
• コントロールに必要なアセンブリ参照
• コントロールの依存関係の確認（コントロールごとのアセンブリと NuGet）

ローカライズ

📄 参照： references/localization.md

• ILocalizationProvider インターフェイスの使用
• 多言語サポートのためのサテライトアセンブリの使用
• .resx ファイルを使用したローカライズ
• 実行時のアプリケーションカルチャの変更
• デフォルトのカルチャ文字列の編集

高 DPI サポート

📄 参照： references/high-dpi-support.md

• DPI 認識の概要（DPI 対応アプリと DPI 非対応アプリ）
• DPI 互換性テストマトリックス
• app.manifest による DPI 認識の有効化
• AutoScaleDimensions と AutoScaleMode の設定
• グリッドコントロールの DpiAware プロパティの有効化
• ImageListAdv による DPI スケーリングに応じた画像の自動切り替え

システム要件

📄 参照： references/system-requirements.md

• サポートされている Windows OS のバージョン
• ハードウェア要件（プロセッサー、RAM、ディスク）
• サポートされている Visual Studio のバージョン
• サポートされている .NET Framework と .NET のバージョン

.NET との互換性

📄 参照： references/dotnet-compatibility.md

• .NET Core / .NET 5-9 を使用した WinForms アプリの作成
• .NET Core プロジェクトへの Syncfusion コントロールの追加（アセンブリ / NuGet）
• .NET Framework と .NET Core のバージョン互換性マトリックス
• Syncfusion のリリースごとの .NET バージョンサポート

アップグレード

📄 参照： references/upgrading.md

• コントロールパネル / Web サイトインストーラーを使用したアップグレード
• Visual Studio 拡張機能を使用したアップグレード
• パッケージマネージャー UI を使用した NuGet パッケージのアップグレード
• パッケージマネージャーコンソールを使用した NuGet パッケージのアップグレード
• .NET CLI を使用した NuGet パッケージのアップグレード
• 試用版からライセンス版へのアップグレード

インストール

📄 参照： references/installation.md

• オフラインインストーラーのダウンロード（試用版およびライセンス版）
• UI ウィザードを使用したインストール（手順ごとの説明）
• サイレントインストール／コマンドラインによるインストールとアンインストール
• パッケージマネージャー UI を使用した NuGet パッケージのインストール
• .NET CLI を使用した NuGet パッケージのインストール
• パッケージマネージャーコンソールを使用した NuGet パッケージのインストール
• よくあるインストールエラーと解決方法

---

クイックスタート

1. NuGet を使用したインストール

# Package Manager Console
Install-Package Syncfusion.Shared.Base

# .NET CLI
dotnet add package Syncfusion.Shared.Base

2. ライセンスキーの登録

Syncfusion コントロールを初期化する前に、ライセンスを登録してください。

// Program.cs — in static void Main(), before Application.Run()
static void Main()
{
    string licenseKey = ConfigurationManager.AppSettings["SyncfusionLicenseKey"];
    
    if (string.IsNullOrEmpty(licenseKey))
    {
        MessageBox.Show("Syncfusion license key not configured!", "Configuration Error");
        return;
    }
    
    SyncfusionLicenseProvider.RegisterLicense(licenseKey);

    Application.EnableVisualStyles();
    Application.SetCompatibleTextRenderingDefault(false);
    Application.Run(new Form1());
}

3. コードによるコントロールの追加

using Syncfusion.Windows.Forms.Tools;

// Create and configure the control
TextBoxExt textBox = new TextBoxExt();
textBox.Location = new System.Drawing.Point(100, 100);
textBox.Size = new System.Drawing.Size(200, 25);

// Add to form
this.Controls.Add(textBox);

---

一般的なパターン

高 DPI の有効化

app.manifest 内：

<application xmlns="urn:schemas-microsoft-com:asm.v3">
  <windowsSettings>
    <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true</dpiAware>
  </windowsSettings>
</application>

コード内（グリッドコントロールの場合）：

gridControl1.DpiAware = true;

実行時にコントロールをローカライズする

// Set culture before InitializeComponent()
Thread.CurrentThread.CurrentCulture = new System.Globalization.CultureInfo("de-DE");
Thread.CurrentThread.CurrentUICulture = new System.Globalization.CultureInfo("de-DE");

---

主要なアセンブリ

アセンブリ	対象となるコントロール
Syncfusion.Shared.Base	ButtonAdv、ほとんどの共通コントロール
Syncfusion.Tools.Windows	ComboBoxAdv、DockingManager、TabControlAdv、およびほとんどの Tools コントロール
Syncfusion.Grid.Windows	GridControl、GridGroupingControl
Syncfusion.Chart.Windows	Chart コントロール
Syncfusion.SfDataGrid.WinForms	SfDataGrid

コントロールごとの依存関係を確認するには、references/getting-started.mdを参照してください。

---

主なユースケース

• 業務フォーム： Syncfusion WinForms ツールを使用して、入力コントロール、エディター、検証機能を追加します
• データ量の多い UI： 高 DPI をサポートする GridControl または SfDataGrid を使用します
• 多言語アプリ： ローカライズには .resx ファイルまたは ILocalizationProvider を使用します
• CI/CD パイプライン： LicenseKeyValidator を使用して、ライセンスキーを自動的に検証します