C# Generics（開発者向けの動作方法）

ジェネリッククラスの簡単な例

任意のタイプの値を格納するように設計されたBoxという名前のジェネリッククラスを考えてみましょう。

public class Box<T>
{
    private T data;

    public Box(T data)
    {
        this.data = data;
    }

    public T Data
    {
        get { return data; }
    }
}

public class Box<T>
{
    private T data;

    public Box(T data)
    {
        this.data = data;
    }

    public T Data
    {
        get { return data; }
    }
}

このクラスを使用するには、 T の実際の型を指定してインスタンスを作成します。

Box<int> integerBox = new Box<int>(123);
Box<string> stringBox = new Box<string>("Hello");

Box<int> integerBox = new Box<int>(123);
Box<string> stringBox = new Box<string>("Hello");

このコードは、単一のクラス (Box) が異なるデータ型 (int, string) を格納するために適応できる方法を説明し、ジェネリックスのコード再利用と型の安全性の強力さを示しています。

ジェネリックメソッドの例

任意の型の配列内の2つの要素を交換するメソッドを以下に示します。

public class Utility
{
    // Swaps two elements by reference using generics
    public static void Swap<T>(ref T lhs, ref T rhs)
    {
        T temp = lhs; // Store lhs in a temporary variable
        lhs = rhs;    // Assign rhs to lhs
        rhs = temp;   // Assign temp (original lhs) to rhs
    }
}

public class Utility
{
    // Swaps two elements by reference using generics
    public static void Swap<T>(ref T lhs, ref T rhs)
    {
        T temp = lhs; // Store lhs in a temporary variable
        lhs = rhs;    // Assign rhs to lhs
        rhs = temp;   // Assign temp (original lhs) to rhs
    }
}

上記のメソッドの使用法は次のようになります。

int a = 1, b = 2;
Utility.Swap<int>(ref a, ref b);

string first = "world", second = "hello";
Utility.Swap(ref first, ref second);

int a = 1, b = 2;
Utility.Swap<int>(ref a, ref b);

string first = "world", second = "hello";
Utility.Swap(ref first, ref second);

ジェネリックインターフェースの例

データアクセス操作のためのジェネリックリポジトリインターフェイスは、次のようになるかもしれません。

public interface IRepository<T>
{
    void Add(T item);
    T GetById(int id);
    IEnumerable<T> GetAll();
}

public interface IRepository<T>
{
    void Add(T item);
    T GetById(int id);
    IEnumerable<T> GetAll();
}

このインターフェースは、特定のデータ型を扱うために任意のクラスで実装でき、異なるタイプにわたって一貫したデータアクセスパターンを可能にします。

ジェネリックデリゲートの例

ジェネリックデリゲートは、型安全のコールバックを定義するために使用できます。

public delegate void Action<T>(T item);

public delegate void Action<T>(T item);

カスタムジェネリックタイプの例

操作の結果と成功フラグおよびオプションのメッセージをカプセル化するジェネリック Result クラスを考えてみましょう。

public class Result<T>
{
    public bool Success { get; private set; }
    public T Data { get; private set; }
    public string Message { get; private set; }

    public Result(bool success, T data, string message = "")
    {
        Success = success;
        Data = data;
        Message = message;
    }
}

public class Result<T>
{
    public bool Success { get; private set; }
    public T Data { get; private set; }
    public string Message { get; private set; }

    public Result(bool success, T data, string message = "")
    {
        Success = success;
        Data = data;
        Message = message;
    }
}

IronPDF と仮想キーワードを使用したコード例

ここでジェネリックスを使用する考え方は、任意の HTML 文字列から PDF を生成するための再利用可能なメソッドを作成することです。 このメソッドはジェネリックであり、必要に応じて異なるタイプのメタデータまたは設定を指定することができます。

まず、私たちの PDF 生成オプションを保持するシンプルなジェネリッククラスを定義しましょう。 このクラスはデモンストレーションの目的のために基本的なものですが、必要に応じてより多くのプロパティでそれを拡張できます。

public class PdfOptions<T>
{
    public T Metadata { get; set; }
    public string HtmlContent { get; set; }
}

public class PdfOptions<T>
{
    public T Metadata { get; set; }
    public string HtmlContent { get; set; }
}

次に、IronPDF を使用して PDF を生成するための静的メソッドを作成し、PdfOptions クラスを活用します。 このメソッドは、パラメーターとして PdfOptions のインスタンスを受け取り、ジェネリックスの実際の使用を示します。

using IronPdf; // Make sure to include the necessary namespace for IronPDF

public static class PdfGenerator
{
    // Generates a PDF from provided HTML content and options
    public static void GeneratePdf<T>(PdfOptions<T> options)
    {
        // Initialize the IronPDF HtmlToPdf renderer
        var renderer = new ChromePdfRenderer();

        // Optional: Apply any renderer options here, for example, setting the paper size
        renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;

        // Generate the PDF from HTML content
        var pdfDocument = renderer.RenderHtmlAsPdf(options.HtmlContent);

        // Optional: Here, you can use options.Metadata in some way, depending on your generic type T
        // For simplicity, we're just printing the metadata to console if it's of type string
        if (options.Metadata is string metadataString)
        {
            Console.WriteLine($"Metadata: {metadataString}");
        }

        // Save the PDF to a file
        var fileName = $"GeneratedPdf_{DateTime.Now.Ticks}.pdf";
        pdfDocument.SaveAs(fileName);
        Console.WriteLine($"PDF generated and saved as {fileName}");
    }
}

using IronPdf; // Make sure to include the necessary namespace for IronPDF

public static class PdfGenerator
{
    // Generates a PDF from provided HTML content and options
    public static void GeneratePdf<T>(PdfOptions<T> options)
    {
        // Initialize the IronPDF HtmlToPdf renderer
        var renderer = new ChromePdfRenderer();

        // Optional: Apply any renderer options here, for example, setting the paper size
        renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;

        // Generate the PDF from HTML content
        var pdfDocument = renderer.RenderHtmlAsPdf(options.HtmlContent);

        // Optional: Here, you can use options.Metadata in some way, depending on your generic type T
        // For simplicity, we're just printing the metadata to console if it's of type string
        if (options.Metadata is string metadataString)
        {
            Console.WriteLine($"Metadata: {metadataString}");
        }

        // Save the PDF to a file
        var fileName = $"GeneratedPdf_{DateTime.Now.Ticks}.pdf";
        pdfDocument.SaveAs(fileName);
        Console.WriteLine($"PDF generated and saved as {fileName}");
    }
}

最後に、PdfGenerator クラスを使用して PDF ドキュメントを生成しましょう。 この例において、Metadata プロパティはタイトルや関連と思われるその他の情報を含む文字列となるかもしれません。

class Program
{
    static void Main(string[] args)
    {
        // Set the license key for IronPDF if needed
        License.LicenseKey = "Your-License-Key-Here";

        // Create PDF options with HTML content and metadata
        var options = new PdfOptions<string>
        {
            HtmlContent = "<h1>Hello, World!</h1><p>This is a test PDF document generated from HTML.</p>",
            Metadata = "Test PDF Title"
        };

        // Generate the PDF using the specified options
        PdfGenerator.GeneratePdf(options);
    }
}

class Program
{
    static void Main(string[] args)
    {
        // Set the license key for IronPDF if needed
        License.LicenseKey = "Your-License-Key-Here";

        // Create PDF options with HTML content and metadata
        var options = new PdfOptions<string>
        {
            HtmlContent = "<h1>Hello, World!</h1><p>This is a test PDF document generated from HTML.</p>",
            Metadata = "Test PDF Title"
        };

        // Generate the PDF using the specified options
        PdfGenerator.GeneratePdf(options);
    }
}

この例は、IronPDF を C# ジェネリンクスと統合し、HTML コンテンツから PDF を生成する柔軟な方法を提供し、ジェネリック PdfOptions クラスを通じてカスタマイズ可能なメタデータや設定を可能にしています。 これに関しては、アプリケーションに必要なより洗練されたオプションやレンダラー設定を追加することで拡張することができます。