利用ガイド
この利用ガイドでは、DioDocs for Excelをトライアルしている方や導入したばかりの方を対象に、DioDocs for Excelの概要や導入方法、基本的な使い方を紹介します。
DioDocs for Excelを知る
DioDocs for ExcelはC#およびVB.NETのコードからExcelファイルを作成・編集を実装できるAPIライブラリです。
こちらの動画ではDioDocs for Excelの特長や主な機能、利用例や導入事例などを紹介します。
DioDocs for Excelをはじめる
DioDocs for Excelのはじめ方はとても簡単です。DioDocs for ExcelのライブラリはNuGetパッケージとして公開しており、インストールすればすぐに使いはじめることができます。
Visual Studioではじめる
Visual StudioのNuGetパッケージマネージャーを使用してDioDocs for Excelをインストールします。
クイックスタート
Visual Studio Codeではじめる
dotnet add packageコマンドを使用して「GrapeCity.DioDocs.Excel.ja」をインストールします。
クイックスタート
DioDocs for Excelの基本機能
DioDocs for ExcelはVBAやVSTOなどでExcelのオブジェクトモデルに慣れ親しんでいる方であれば、ほぼ同じ使用感で使えるように設計されています。
ワークブックの操作
ワークブックを新規に作成
Workbookクラスのコンストラクタを使用して、ワークブックの新しいインスタンスを作成できます。このワークブックには、デフォルトで空のワークシート「Sheet1」が含まれています。
// ワークブックを初期化しますWorkbook workbook = new Workbook();// 既定のワークシートを取得しますIWorksheet worksheet = workbook.Worksheets[0];
ワークブックを開く
WorkbookクラスのOpenメソッドを使用してExcelファイルを読み込むことができます。
Workbook workbook = new Workbook();// ワークブックを開きますworkbook.Open("test.xlsx");
ワークブックを保存
WorkbookクラスのSaveメソッドを使用してExcelファイルに保存できます。
// Excelファイルとして保存しますworkbook.Save("result.xlsx");
同じようにPDFファイルに保存することもできます。
// PDFファイルとして保存しますworkbook.Save("result.pdf");
ワークブックを保護
XlsxSaveOptionsクラスのPasswordプロパティを使用して、Excelファイルを保護するためのパスワードを設定できます。
// Excelファイルを保存し、パスワードで保護しますXlsxSaveOptions options = new XlsxSaveOptions();options.Password = "123456";workbook.Save("result.xlsx", options);
保護されているExcelファイルを開くには、XlsxOpenOptionsクラスのPasswordプロパティを使用してパスワードを設定できます。
// パスワードで保護されているExcelファイルを開きますXlsxOpenOptions options = new XlsxOpenOptions();options.Password = "123456";workbook.Open("result.xlsx", options);
また、Excelファイルがパスワードで保護されているかどうかを確認するには、WorkbookクラスのIsEncryptedFileメソッドを使用します。
// パスワードで保護されているか確認しますbool encrypted = workbook.IsEncryptedFile("result.xlsx");Console.WriteLine(encrypted);
ワークブックのドキュメントプロパティを設定
WorkbookクラスのBuiltInDocumentPropertiesプロパティを使用してExcelファイルのドキュメントプロパティを設定できます。
// 組み込みのドキュメントプロパティの値を設定しますworkbook.BuiltInDocumentProperties.Title = "4月分売上レポート";workbook.BuiltInDocumentProperties.Company = "グレープシティ";
ワークシートの操作
ワークシートを追加
IWorksheetsインターフェースのAddメソッドを使用して、新しいワークシートを追加できます。
// ワークシートを追加しますIWorksheet worksheet = workbook.Worksheets.Add();
ワークシートをコピー、移動
IWorksheetインターフェースのCopyメソッド、Moveメソッドを使用してワークシートをコピーおよび移動できます。
// ワークシートをコピーしますIWorksheet copy_worksheet = worksheet.Copy();copy_worksheet.Name = "Copy of " + worksheet.Name;// ワークシートを末尾に移動しますcopy_worksheet.Move();
ワークシートを表示、非表示
IWorksheetインターフェースのVisibleプロパティを使用して、ワークシートを表示または非表示にできます。
// 新しいシートを追加し、シートの表示を非表示に設定しますIWorksheet worksheet1 = workbook.Worksheets.Add();worksheet1.Visible = Visibility.Hidden;
ワークシートを画像として保存
IWorksheetインターフェースのToImageメソッドを使用して、PNG、JPEG、SVG、GIF形式で保存できます。
// ワークシートを画像として保存しますworksheet.ToImage("result.png");
ワークシートをPDFファイルとして保存
IWorksheetインターフェースのSaveメソッドを使用して、PDF形式で保存できます。
// ワークシートをPDFファイルとして保存しますworksheet.Save("result.pdf");
セルや範囲の操作
セルや範囲にデータを追加
IRangeインターフェースのValueプロパティを使用して、セルや範囲にデータを追加できます。
Workbook workbook = new Workbook();// 単一セルにデータを追加しますworkbook.Worksheets[0].Range["A1"].Value = "Hello World!";object[,] data = new object[,]{{"名前", "地域", "生年月日", "血液型", "体重", "身長"},{"伊達", "西地区", new DateTime(1968, 6, 8), "A", 67, 165},{"上杉", "北地区", new DateTime(1972, 7, 3), "B", 62, 134},{"最上", "西地区", new DateTime(1964, 3, 2), "O", 72, 180},{"片倉", "南地区", new DateTime(1972, 8, 8), "A", 66, 163},{"田村", "東地区", new DateTime(1986, 2, 2), "A", 76, 176},{"津軽", "北地区", new DateTime(1993, 2, 15), "AB", 68, 145}};// セル範囲にデータを追加しますworkbook.Worksheets[0].Range["C1:H7"].Value = data;
セルや範囲をコピー
IRangeインターフェースのCopyメソッドを使用して、ワークシート内のセルまたはセル範囲をコピーできます。
// セル範囲B3:D12のデータを、E5セルを起点とするセル範囲にコピーしますworksheet.Range["B3:D12"].Copy(worksheet.Range["E5"]);
数式を追加
IRangeインターフェースのFormulaプロパティを使用して、ワークシート内のセルに数式を設定できます。
worksheet.Range["B2"].Value = 10;worksheet.Range["B3"].Value = 20;worksheet.Range["B4"].Value = 30;worksheet.Range["B5"].Value = 40;// セル範囲B2:B5のデータをSUM関数で合計します。worksheet.Range["B6"].Formula = "=SUM(B2:B5)";
グラフを追加
IShapesインターフェースのAddChartメソッドを使用して、ワークシート内のセル範囲にグラフを追加できます。
worksheet.Range["A1:E6"].Value = new object[,]{{"品目", "Q1", "Q2", "Q3", "Q4"},{"リンゴ", 100, 290, 320, 410},{"みかん", 510, 360, 270, 480},{"メロン", 520, 850, 300, 670},{"スイカ", 220, 650, 650, 330},{"バナナ", 230, 690, 520, 460}};// グラフを追加IShape shape = worksheet.Shapes.AddChart(ChartType.ColumnClustered, worksheet.Range["B8:H19"]);shape.Chart.HasTitle = true;shape.Chart.ChartTitle.Text = "青果物の売上";shape.Chart.SeriesCollection.Add(worksheet.Range["A1:E6"], RowCol.Columns, true, true);
画像を追加
IShapesインターフェースのAddPictureメソッドを使用して、ワークシート内のセルに画像を追加できます。
// 画像を追加IShape picture = worksheet.Shapes.AddPicture("DioDocs.png", worksheet.Range["C2:H6"]);
図形を追加
IShapesインターフェースのAddShapeメソッドを使用して、ワークシート内のセルに図形を追加できます。
// 図形を追加IShape shape = worksheet.Shapes.AddShape(AutoShapeType.Rectangle, worksheet.Range["F5:I10"]);
テーブルを追加
ITablesインターフェースのAddメソッドを使用して、ワークシート内のセルにテーブルを追加できます。
worksheet.Range["A1:E6"].Value = new object[,]{{"品目", "Q1", "Q2", "Q3", "Q4"},{"リンゴ", 100, 290, 320, 410},{"みかん", 510, 360, 270, 480},{"メロン", 520, 850, 300, 670},{"スイカ", 220, 650, 650, 330},{"バナナ", 230, 690, 520, 460}};// テーブルを追加worksheet.Tables.Add(worksheet.Range["A1:E6"], true);
DioDocs for Excelをクラウドで使う
DioDocs for ExcelはAzureやAWS、Google Cloudで動作する .NETアプリケーションで利用できます。
Azure Functions
Azure FunctionsでDioDocs for Excelを使用したC#のクラスライブラリをベースにした関数を作成し、Excelファイルを出力する方法について紹介します。

AWS Lambda
AWS LambdaでDioDocs for Excelを使用したC#のLambda関数アプリケーションを作成し、Excelファイルを出力する方法について紹介します。

Cloud Functions
Cloud FunctionsでDioDocs for Excelを使用したC#の関数アプリケーションを作成し、Excelファイルを出力する方法について紹介します。

DioDocs for Excelをコンテナで使う
DioDocs for Excelはコンテナで動作する .NETアプリケーションで利用できます。
コンテナで開発する
コンテナを利用した .NET開発環境でDioDocs for Excelを使用したアプリケーションを作成し、Excel帳票をPDF出力する方法について紹介します。

コンテナで実行する
DioDocs for Excelを使用した.NETアプリケーションをコンテナ化して、各パブリッククラウドにデプロイする方法について紹介します。

さらに学ぶ
上記のほかにもDioDocs for Excelでは、利用をサポートするドキュメントやデモを豊富に用意しています。さらに、こちらの「クイックリンク一覧」を使えば多数あるドキュメントやデモからやりたいことに関する情報を効率良く探すことができます。
学習コンテンツ
オンラインデモ
各機能の動作を確認しながら学べるオンラインデモです。
製品ヘルプ
各機能を実装するクラスやメソッド、プロパティなどを参照できるヘルプです。
ナレッジベース
蓄積された情報からDioDocs for Excelを使うためのノウハウを検索できます。
技術サポート(E-mailサポート)
DioDocs for Excelのサブスクリプションライセンスをご契約中の方はメールによるテクニカルサポートサービスをご利用いただけます(回数無制限)。ご利用中に発生した技術的な不明点をこちらのフォーム(要ログイン)よりお知らせください。