ユーザー定義の数値による表示形式のカスタマイズ

導入

Excel ファイルで作業する場合、データをより意味のあるユーザー フレンドリな方法で表示するために、セルのカスタム書式設定が必要になることがよくあります。レポート用の Excel ファイルを作成しているとします。必要なのは生の数字だけではありません。日付、パーセンテージ、通貨を洗練されたプロフェッショナルな外観にしたいですよね。そこでカスタム表示形式が役立ちます。このチュートリアルでは、Aspose.Cells for .NET を詳しく調べ、ユーザー定義の設定を使用して数字の表示形式をカスタマイズする方法を説明します。

前提条件

始める前に、このチュートリアルに従うために必要なものがすべて揃っていることを確認してください。必要なものは次のとおりです。

  • Aspose.Cells for .NET がインストールされています。ここからダウンロード.
  • C# および .NET フレームワークに関する基本的な知識。
  • Aspose.Cellsの有効なライセンス。お持ちでない場合は、無料トライアルまたはリクエスト一時ライセンス.
  • Visual Studio のような IDE。
  • .NET Framework 4.0 以上。 何か足りないものがあっても心配しないでください。いつでもこれらのリンクにアクセスして必要なファイルをダウンロードしたり、Aspose サポート フォーラム.

名前空間のインポート

コードに進む前に、必要なすべての Aspose.Cells 機能にアクセスするために必要な名前空間をインポートする必要があります。

using System.IO;
using Aspose.Cells;
using System;

これら 2 つの名前空間は、このチュートリアルの中心的なツールになります。それでは、楽しい部分に進みましょう。

ステップ1: プロジェクトディレクトリの設定

まず、ファイルを保存する場所が必要ですね。出力 Excel ファイルを保存するためのディレクトリを作成しましょう。この手順では、何かを保存する前にディレクトリが存在することも確認します。

//ドキュメント ディレクトリへのパス。
string dataDir = "Your Document Directory";
//ディレクトリがまだ存在しない場合は作成します。
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);
  • 私たちは定義していますdataDir出力される Excel ファイルが保存されるパスを格納する変数。
  • 次に、ディレクトリが存在するかどうかを確認します。System.IO.Directory.Exists().
  • ディレクトリが存在しない場合は、以下を使用して作成されます。System.IO.Directory.CreateDirectory().

ステップ2: 新しいワークブックを作成し、ワークシートを追加する

ディレクトリができたので、新しい Excel ブックを作成し、そこにワークシートを追加しましょう。

//ワークブックオブジェクトのインスタンス化
Workbook workbook = new Workbook();
// Excel オブジェクトに新しいワークシートを追加する
int i = workbook.Worksheets.Add();
//新しく追加されたワークシートの参照をシートインデックスを渡して取得する
Worksheet worksheet = workbook.Worksheets[i];
  • まず、新しいWorkbookオブジェクト。これは Excel ファイルと考えてください。
  • このワークブックに新しいワークシートを追加するには、Add()メソッドを実行し、インデックスを変数に格納するi.
  • このワークシートは、workbook.Worksheets[i].

ステップ3: セルに日付を追加し、その形式をカスタマイズする

さて、現在の日付をセルに挿入し、カスタム形式で表示してみましょう。デフォルトの日付形式の代わりに、次のようなカスタム形式を設定します。d-mmm-yy.

//現在のシステム日付を「A1」セルに追加する
worksheet.Cells["A1"].PutValue(DateTime.Now);
//A1セルのスタイルを取得する
Style style = worksheet.Cells["A1"].GetStyle();
//日付を「d-mmm-yy」として表示するようにカスタム表示形式を設定する
style.Custom = "d-mmm-yy";
//A1セルにスタイルを適用する
worksheet.Cells["A1"].SetStyle(style);
  • 現在のシステム日付をセルに追加しますA1使用してPutValue(DateTime.Now).
  • セルの現在のスタイルを取得しますA1使用してGetStyle().
  • セルのスタイルを変更するには、style.Custom = "d-mmm-yy"は、日付を日、月（省略）、年を表示するようにフォーマットします。
  • 最後に、新しいスタイルをセルに適用します。SetStyle().

ステップ 4: セルをパーセンテージとして書式設定する

次に、数字を操作してみましょう。別のセルに数値を追加します。A2、パーセンテージとしてフォーマットします。

//「A2」セルに数値を追加する
worksheet.Cells["A2"].PutValue(20);
//A2セルのスタイルを取得する
style = worksheet.Cells["A2"].GetStyle();
//値をパーセンテージで表示するためのカスタム表示形式を設定する
style.Custom = "0.0%";
//A2セルにスタイルを適用する
worksheet.Cells["A2"].SetStyle(style);
  • 私たちは価値を付加します20セルにA2.
  • セルのスタイルを取得しますA2カスタムフォーマットを次のように設定します0.0%値をパーセンテージ（例：20%）で表示します。
  • 最後に、セルにスタイルを適用します。SetStyle().

ステップ 5: セルを通貨として書式設定する

セルに別の値を追加してみましょうA3、通貨として表示するように書式設定します。より興味深いものにするために、正の値をポンドで通貨として表示し、負の値をドルで通貨として表示する形式を使用します。

// 「A3」セルに数値を追加する
worksheet.Cells["A3"].PutValue(2546);
//A3セルのスタイルを取得する
style = worksheet.Cells["A3"].GetStyle();
//値を通貨として表示するためのカスタム表示形式を設定する
style.Custom = "£#,##0;[Red]$-#,##0";
//A3セルにスタイルを適用する
worksheet.Cells["A3"].SetStyle(style);
  • 私たちは価値を付加します2546セルにA3.
  • カスタムフォーマットを設定します£#,##0;[Red]$-#,##0正の値はポンド記号で表示され、負の値はドル記号で赤く表示されます。
  • セルにスタイルを適用するには、SetStyle().

ステップ6: ワークブックを保存する

最後の手順は、ワークブックを Excel ファイルとして保存することです。このチュートリアルでは、Excel 97-2003 形式を使用します。

// Excelファイルの保存
workbook.Save(dataDir + "book1.out.xls", SaveFormat.Excel97To2003);
  • のSave()メソッドは、指定されたディレクトリにワークブックを保存します。
  • 私たちは選ぶSaveFormat.Excel97To2003古いバージョンの Excel との互換性を確保するためです。

結論

これで完了です。Excel ファイルを作成し、Aspose.Cells for .NET を使用して特定のセルにカスタムの日付、パーセンテージ、通貨の書式を追加して、ファイルを保存しました。カスタム書式設定により、Excel ファイルの読みやすさとプロフェッショナルさが格段に向上します。データの外観をさらに細かく制御するには、条件付き書式設定など、Aspose.Cells のその他の書式設定オプションも忘れずに確認してください。

よくある質問

Aspose.Cells でより複雑な書式設定オプションを適用するにはどうすればよいですか?

フォントの色、境界線、背景色などのさまざまな書式設定スタイルをカスタム数値書式と組み合わせることができます。

セル範囲にカスタム数値書式を適用できますか?

はい、Aspose.Cellsでは、Range.SetStyle()方法。

他にどのようなファイル形式でワークブックを保存できますか?

Aspose.CellsはXLSX、CSV、PDFなど多くの形式をサポートしています。SaveFormatのSave()方法。

負の数を別の形式でフォーマットすることはできますか?

もちろんです! カスタム数値形式を使用して、負の数値を異なる色や記号で表示できます。

Aspose.Cells for .NET は無料ですか?

Aspose.Cellsは無料トライアルを提供していますが、フル機能を使用するには有効なライセンスが必要です。一時ライセンスはこちら.

Excel の組み込み数値書式をプログラムで使用する