スマートマーカー Aspose.Cells で汎用リストを使用する

導入

動的なレポートやデータ駆動型アプリケーションの作成は、今日のテクノロジー業界では欠かせないスキルです。.NET や Excel ファイルで作業している場合、Excel スプレッドシートをプログラムで操作するために特別に設計された強力なライブラリである Aspose.Cells について聞いたことがあるでしょう。この包括的なガイドでは、Aspose.Cells でスマートマーカー付きの汎用リストを利用する方法を順を追って説明し、アプリケーションでのデータ処理を最適化するためのステップバイステップのアプローチを提供します。

前提条件

コードに進む前に、必要なものを簡単に確認しましょう。

C#の基礎知識

C# の基礎知識と、クラスおよびオブジェクトの操作方法を理解している必要があります。オブジェクト指向プログラミングに精通している場合は、すでに正しい方向に進んでいます。

Aspose.Cells for .NET がインストールされている

.NETプロジェクトにAspose.Cellsがインストールされていることを確認してください。ライブラリは以下からダウンロードできます。Aspose ウェブサイト.

Visual Studio 環境

マシンに Visual Studio をセットアップしておくことは非常に重要です。これは、C# コードを記述する最も一般的な開発環境です。

テンプレートファイル

このチュートリアルでは、事前に設定できるシンプルな Excel テンプレートを使用します。デモには空白のワークブックのみが必要です。

パッケージのインポート

基本的なものは揃ったので、まずは必要なパッケージをインポートしましょう。目安としては、次の名前空間を含めるのがよいでしょう。

using System.IO;
using Aspose.Cells;
using System;
using System.Drawing;
using System.Collections.Generic;

これらの名前空間は、Excel ファイルの操作やセルのスタイル設定に必要な機能を提供します。

ステップ1: クラスを定義する

まずは最初に！PersonそしてTeacherクラス。方法は次のとおりです。

Personクラスを定義する

のPersonクラスは名前や年齢などの基本的な属性を保持します。

public class Person
{
    int _age;
    string _name;
    
    public int Age
    {
        get { return _age; }
        set { _age = value; }
    }
    
    public string Name
    {
        get { return _name; }
        set { _name = value; }
    }
    
    public Person(string name, int age)
    {
        _age = age;
        _name = name;
    }
}

教師クラスを定義する

次はTeacherクラスは、Personクラス。このクラスは、学生のリストをさらにカプセル化します。

public class Teacher : Person
{
    private IList<Person> m_students;
    public IList<Person> Students
    {
        get { return m_students; }
        set { m_students = value; }
    }
    
    public Teacher(string name, int age) : base(name, age)
    {
        m_students = new List<Person>();
    }
}

ステップ 2: ワークブックを初期化してデザイナーを作成する

クラスの準備ができたので、次はワークブックを初期化します。

string dataDir = "Your Document Directory"; //ドキュメントディレクトリを指定する
Workbook workbook = new Workbook(); //新しいワークブックインスタンス
Worksheet worksheet = workbook.Worksheets[0];

ステップ3: ワークシートにスマートマーカーを設定する

Excel ワークシートにスマートマーカーを設定し、動的な値が配置される場所を示します。

worksheet.Cells["A1"].PutValue("Teacher Name");
worksheet.Cells["A2"].PutValue("&=Teacher.Name");
worksheet.Cells["B1"].PutValue("Teacher Age");
worksheet.Cells["B2"].PutValue("&=Teacher.Age");
worksheet.Cells["C1"].PutValue("Student Name");
worksheet.Cells["C2"].PutValue("&=Teacher.Students.Name");
worksheet.Cells["D1"].PutValue("Student Age");
worksheet.Cells["D2"].PutValue("&=Teacher.Students.Age");

ステップ4: プレゼンテーションを強化するためにスタイルを適用する

優れたレポートは視覚的に魅力的である必要があります。ヘッダーにスタイルを適用してみましょう。

Range range = worksheet.Cells.CreateRange("A1:D1");
Style style = workbook.CreateStyle();
style.Font.IsBold = true;
style.ForegroundColor = Color.Yellow;
style.Pattern = BackgroundType.Solid;
StyleFlag flag = new StyleFlag();
flag.All = true;
range.ApplyStyle(style, flag);

ステップ5: 教師と生徒のインスタンスを作成する

さて、インスタンスを作成しましょうTeacherそしてPersonクラスを作成してデータを入力します。

System.Collections.Generic.List<Teacher> list = new System.Collections.Generic.List<Teacher>();
//最初の教師オブジェクトを作成する
Teacher h1 = new Teacher("Mark John", 30);
h1.Students = new List<Person>
{
    new Person("Chen Zhao", 14),
    new Person("Jamima Winfrey", 18),
    new Person("Reham Smith", 15)
};
//2番目の教師オブジェクトを作成する
Teacher h2 = new Teacher("Masood Shankar", 40);
h2.Students = new List<Person>
{
    new Person("Karishma Jathool", 16),
    new Person("Angela Rose", 13),
    new Person("Hina Khanna", 15)
};
//リストに追加
list.Add(h1);
list.Add(h2);

ステップ6: デザイナーのデータソースを設定する

ここで、準備したワークシートにデータをリンクする必要があります。

WorkbookDesigner designer = new WorkbookDesigner();
designer.Workbook = workbook;
designer.SetDataSource("Teacher", list);

ステップ7: マーカーを処理する

次のステップは、先ほど配置したすべてのスマートマーカーを処理することです。

designer.Process();

ステップ 8: 列を自動調整してワークブックを保存する

すべてがプロフェッショナルに見えるように、列を自動調整してワークブックを保存しましょう。

worksheet.AutoFitColumns();
designer.Workbook.Save(dataDir + "output.xlsx"); //指定したディレクトリに保存する

結論

これで完了です。Aspose.Cells for .NET の汎用リストとスマートマーカーの機能を活用して、Excel ワークシートを動的に作成しました。このスキルにより、複雑なレポートを簡単に作成し、データ駆動型の機能をアプリケーションに組み込むことができます。学校のレポート、ビジネス分析、その他の動的コンテンツを生成する場合でも、このガイドのテクニックはワークフローを大幅に効率化するのに役立ちます。

よくある質問

Aspose.Cells とは何ですか?

Aspose.Cells は、Microsoft Excel をインストールしなくても Excel ファイルを作成および管理するための .NET ライブラリです。

Aspose.Cells を他のファイル形式で使用できますか?

はい！Aspose は PDF、Word、その他の形式用のライブラリを提供しており、多目的にドキュメント管理を行うことができます。

Aspose.Cells を使用するにはライセンスが必要ですか?

まずは無料トライアルから始めましょうここただし、実稼働環境で使用する場合は有料ライセンスが必要です。

スマートマーカーとは何ですか?

スマートマーカーは Excel テンプレート内のプレースホルダーであり、Aspose.Cells によって処理されるときに実際のデータに置き換えられます。

Aspose.Cells は大規模なデータセットに適していますか?

もちろんです! Aspose.Cells はパフォーマンスが最適化されており、大規模なデータセットを効率的に処理できます。

スマートマーカーフィールド Aspose.Cells で数式パラメータを使用するスマートマーカーで HTML プロパティを使用する Aspose.Cells .NET