C#で既存のスプレッドシートを読み込む方法

どのファイル形式を読み込むことができますか?

:path=/static-assets/excel/content-code-examples/how-to/load-spreadsheet-load-spreadsheet.cs

using IronXL;

// Supported for XLSX, XLS, XLSM, XLTX, CSV and TSV
WorkBook workBook = WorkBook.Load("sample.xlsx");

複数のファイル形式を読み込める柔軟性があるため、従来のExcelファイル（XLS）、最新のExcelワークブック（XLSX）、マクロ対応ワークブック（XLSM）、テンプレートファイル（XLTX）を扱うことができます。 この互換性により、最新のExcel機能をサポートしながら、古いシステムからのスムーズな移行を保証します。 新しいスプレッドシートの作成の詳細については、包括的なガイドをご覧ください。

パスワードで保護されたファイルをどのように扱えばよいですか?

機密データを扱う場合、パスワード保護が必要になることがよくあります。 IronXLはパスワードで保護されたワークブックを、パスワードをパラメータとして与えることで簡単にロードすることができます：

// Load password-protected Excel file
WorkBook protectedWorkBook = WorkBook.Load("protected.xlsx", "myPassword123");

// Work with the workbook normally
WorkSheet sheet = protectedWorkBook.DefaultWorkSheet;
sheet["B2"].Value = "Updated secure data";

// Save with password protection
protectedWorkBook.SaveAs("updated_protected.xlsx");

// Load password-protected Excel file
WorkBook protectedWorkBook = WorkBook.Load("protected.xlsx", "myPassword123");

// Work with the workbook normally
WorkSheet sheet = protectedWorkBook.DefaultWorkSheet;
sheet["B2"].Value = "Updated secure data";

// Save with password protection
protectedWorkBook.SaveAs("updated_protected.xlsx");

バイト配列やストリームからの読み込みについてはどうですか?

最近のアプリケーションでは、ファイルは、Webアップロード、API応答、データベースBLOBなど、さまざまなソースから来ることがよくあります。 IronXLはこれらのシナリオをエレガントに処理します：

// Loading from byte array
byte[] excelBytes = File.ReadAllBytes("sample.xlsx");
WorkBook workBookFromBytes = WorkBook.FromByteArray(excelBytes);

// Loading from stream
using (FileStream stream = new FileStream("sample.xlsx", FileMode.Open))
{
    WorkBook workBookFromStream = WorkBook.FromStream(stream);

    // Process the workbook
    var sheet = workBookFromStream.DefaultWorkSheet;
    Console.WriteLine($"Sheet has {sheet.RowCount} rows");
}

// Loading from MemoryStream (common in web applications)
using (MemoryStream memStream = new MemoryStream(excelBytes))
{
    WorkBook workBookFromMemory = WorkBook.FromStream(memStream);
}

// Loading from byte array
byte[] excelBytes = File.ReadAllBytes("sample.xlsx");
WorkBook workBookFromBytes = WorkBook.FromByteArray(excelBytes);

// Loading from stream
using (FileStream stream = new FileStream("sample.xlsx", FileMode.Open))
{
    WorkBook workBookFromStream = WorkBook.FromStream(stream);

    // Process the workbook
    var sheet = workBookFromStream.DefaultWorkSheet;
    Console.WriteLine($"Sheet has {sheet.RowCount} rows");
}

// Loading from MemoryStream (common in web applications)
using (MemoryStream memStream = new MemoryStream(excelBytes))
{
    WorkBook workBookFromMemory = WorkBook.FromStream(memStream);
}

どのような場合に LoadCSV は Load よりも優れていますか?

LoadCSV メソッドは、CSV 解析の制御を強化し、カスタム区切り文字を指定したり、異なるエンコーディングを処理したり、大きな CSV ファイルを処理したりする必要がある場合に最適です。 国際的なデータ形式を扱う場合や、CSVファイルでセミコロンやパイプのような非標準の区切り文字を使用する場合に特に役立ちます。

LoadCSVはどのように特殊文字を処理しますか?

:path=/static-assets/excel/content-code-examples/how-to/load-spreadsheet-load-csv.cs

using IronXL;

// Load CSV file
WorkBook workBook = WorkBook.LoadCSV("sample.csv");

LoadCSVメソッドは、UTF-8、UTF-16、ASCIIを含むさまざまなエンコーディングを自動的に処理し、特殊文字、アクセント記号付きの文字、国際記号が正しく保持されるようにします。 これは、多言語データや科学的な表記法を扱う場合に非常に重要です。 完全なCSVワークフロー管理のために、.NETでCSVファイルを書くの詳細をご覧ください。

なぜDataSetをExcelに変換するのですか?

DataSetオブジェクトをExcel形式に変換することは、レポート作成、データエクスポート、ユーザーフレンドリーなデータプレゼンテーションの作成に不可欠です。 ビジネスユーザーは、データ分析にExcel形式を好むことが多く、自動化されたレポートでは、データベースの結果をスプレッドシート形式に変換する必要が頻繁にあります。 この変換により、条件付き書式設定、チャート作成、数式アプリケーションなど、生のDataSetオブジェクトでは利用できない機能が可能になります。

Excelでデータセットのリレーションシップはどうなるのですか

複数の関連テーブルを持つデータセットを読み込むと、IronXLはデータセット内のデータテーブルごとに別々のワークシートを作成します。 一貫したキー値によってテーブルの関係が保持されるため、エクスポートされたExcelファイルで作業する際、ユーザーはデータの整合性を維持できます。このため、参照整合性を維持しながら複雑なデータベーススキーマをエクスポートするのに理想的です。

データセットから複数のテーブルをロードできますか?

:path=/static-assets/excel/content-code-examples/how-to/load-spreadsheet-load-dataset.cs

using IronXL;
using System.Data;

// Create dataset
DataSet dataSet = new DataSet();

// Create workbook
WorkBook workBook = WorkBook.Create();

// Load DataSet
WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);

データベース統合を含むより高度なシナリオについては、Excel to SQL via System.Data.DataSet のガイドを参照してください。

様々なデータソースをExcel形式にロードできるIronXLは.NET開発者にとって貴重なツールです。 レポーティングシステム、データ移行ツール、ビジネスインテリジェンスアプリケーションのいずれを構築する場合でも、ロード機能は強力なスプレッドシート操作の基盤となります。 より多くの例や高度なテクニックについては、総合チュートリアルセクションをご覧ください。