Excelワークシートのコメントは、追加情報を追加したり、数式を説明したりするために使用されます。これらのコメントは、フォントサイズ、高さ、幅などを定義することによってもフォーマットできます。この記事では、C#を使用してExcelワークシートにコメントを追加する方法を学習します。さらに、この記事では、プログラムでフォーマットを適用し、コメントに画像を追加する方法についても説明します。
Excelでコメントを追加するC#API
Excelワークシートにコメントを追加するには、Aspose.Cells for .NETを使用します。これは、Excelファイルを最初から作成できる強力なスプレッドシート操作APIです。また、既存のExcelファイルをシームレスに変更および変換することもできます。 APIをダウンロードするか、NuGetを使用してインストールできます。
PM> Install-Package Aspose.Cells
C#でExcelワークシートにコメントを追加する
以下は、C#でExcelワークシートにコメントを追加する手順です。
- Workbookクラスを使用してExcelファイルをロードします。
- Workbook.Worksheetsコレクションから目的のWorksheetの参照を取得します。
- Worksheet.Comments.Add(string)メソッドを使用してワークシートにコメントを追加し、Commentオブジェクトでコメントの参照を取得します。
- Comment.Noteプロパティを使用してコメントのメモを設定します。
- Workbook.Save(string)メソッドを使用して、更新されたExcelファイルを保存します。
次のコードサンプルは、C#を使用してExcelワークシートにコメントを追加する方法を示しています。
// Workbookオブジェクトのインスタンス化
Workbook workbook = new Workbook("workbook.xlsx");
// シートインデックスを渡して最初のワークシートの参照を取得する
Worksheet worksheet = workbook.Worksheets[0];
// 「F5」セルにコメントを追加
int commentIndex = worksheet.Comments.Add("F5");
// 新しく追加されたコメントへのアクセス
Comment comment = worksheet.Comments[commentIndex];
// コメントメモの設定
comment.Note = "Hello Aspose!";
// Excelファイルを保存する
workbook.Save("output.xlsx");
C#を使用してExcelのコメントに画像を追加する
以下の手順に従って、Excelワークシートのコメントに画像を追加することもできます。
- Workbookクラスを使用してExcelファイルをロードします。
- Workbook.Worksheets[index].Commentsプロパティを使用して、目的のワークシートのCommentCollectionの参照を取得します。
- コレクションに新しいコメントを追加し、Commentオブジェクトでその参照を取得します。
- Comment.Noteプロパティを使用してコメントのメモを設定します。
- ファイルからビットマップオブジェクトに画像をロードします。
- ビットマップをMemoryStreamオブジェクトに保存します。
- Comment.CommentShape.Fill.ImageDataプロパティを使用して、コメントに画像を追加します。
- Workbook.Save(string)メソッドを使用して、更新されたExcelファイルを保存します。
次のコードサンプルは、C#を使用してExcelのコメントに画像を追加する方法を示しています。
// Workbookオブジェクトのインスタンス化
Workbook workbook = new Workbook("workbook.xlsx");
// 最初のシートでコメントコレクションの参照を取得する
CommentCollection comments = workbook.Worksheets[0].Comments;
// セルA1にコメントを追加する
int commentIndex = comments.Add(0, 0);
Comment comment = comments[commentIndex];
comment.Note = "First note.";
comment.Font.Name = "Times New Roman";
// ストリームへの画像の読み込み
Bitmap bmp = new Bitmap("logo.jpg");
MemoryStream ms = new MemoryStream();
bmp.Save(ms, System.Drawing.Imaging.ImageFormat.Png);
// コメントに関連付けられた形状に画像データを設定する
comment.CommentShape.Fill.ImageData = ms.ToArray();
// ブックの保存
workbook.Save("book1.xlsx");
C#を使用してExcelのコメントに書式を適用する
以下は、C#を使用してExcelのコメントに書式を適用する手順です。
- Workbookクラスを使用してExcelファイルをロードします。
- Workbook.Worksheetsコレクションから目的のWorksheetの参照を取得します。
- Worksheet.Comments.Add(string)メソッドを使用してワークシートにコメントを追加し、Commentオブジェクトでコメントの参照を取得します。
- Comment.Noteプロパティを使用してコメントのメモを設定します。
- コメントの必要なフォーマットオプションを設定します。
- Workbook.Save(string)メソッドを使用して、更新されたExcelファイルを保存します。
次のコードサンプルは、C#を使用してExcelでコメントの書式を設定する方法を示しています。
// Workbookオブジェクトのインスタンス化
Workbook workbook = new Workbook("workbook.xlsx");
// シートインデックスを渡して最初のワークシートの参照を取得する
Worksheet worksheet = workbook.Worksheets[0];
// 「F5」セルにコメントを追加
int commentIndex = worksheet.Comments.Add("F5");
// 新しく追加されたコメントへのアクセス
Comment comment = worksheet.Comments[commentIndex];
// コメントメモの設定
comment.Note = "Hello Aspose!";
// コメントのフォントサイズを14に設定する
comment.Font.Size = 14;
// コメントのフォントを太字に設定する
comment.Font.IsBold = true;
// フォントの高さを10に設定する
comment.HeightCM = 10;
// フォントの幅を2に設定する
comment.WidthCM = 2;
// Excelファイルを保存する
workbook.Save("output.xlsx");
無料ライセンスを取得する
一時ライセンスを使用すると、評価の制限なしにAspose.Cells for .NETを使用できます。
結論
この記事では、C#を使用してExcelワークシートにコメントを追加する方法を学習しました。さらに、プログラムでコメントに画像を追加する方法を見てきました。提供されたコードを.NET、.NET Core、またはXamarinベースのアプリケーションに簡単に統合できます。さらに、Aspose.Cells for .NETのドキュメントを調べることができます。ご不明な点がございましたら、フォーラムまでお気軽に投稿してください。