IRONSOFTWAREHOME
ENTWICKLER-UPDATES

C# Diskriminierte Union (Wie es für Entwickler funktioniert)

Jacob Mellor, Chief Technology Officer @ Team Iron
Jacob Mellor
Updated: 28. Juli 2025

Diskriminierte Vereinigungen, auch bekannt als markierte Vereinigungen oder Summen-Typen, sind ein kraftvolles Werkzeug, um Daten zu modellieren, die unterschiedliche Formen annehmen können, aber mit gut definierten und begrenzten möglichen Fällen. Obwohl C# keine nativen diskriminierten Vereinigungen wie einige andere Sprachen (z.B. F# oder Rust) hat, können Sie diskriminierte Vereinigungen mit verschiedenen Techniken in der Sprache simulieren. In diesem Tutorial werden wir uns mit diskriminierten Vereinigungen befassen, wie man sie in C# implementiert und ihrem praktischen Anwendungsfall mit der IronPDF-Bibliothek.

Was ist eine Discriminated Union?

Einfach ausgedrückt ist eine diskriminierte Vereinigung ein Typ, der eine von mehreren vordefinierten Formen oder Werten annehmen kann. Sie bietet eine Möglichkeit, eine typsichere Struktur zu erstellen, die verschiedene Typen oder Werte kapselt und sicherstellt, dass zur Kompilierungszeit nur gültige Fälle behandelt werden.

Stellen Sie sich ein Szenario vor, in dem Sie das Ergebnis eines Vorgangs darstellen möchten. Der Vorgang kann entweder erfolgreich sein und einige Daten zurückgeben oder fehlschlagen und eine Fehlermeldung zurückgeben. Eine diskriminierte Vereinigung würde es Ihnen ermöglichen, diese beiden möglichen Ergebnisse in einem einzigen Typ darzustellen.

Example: Simulating Discriminated Union in C#

Hier ist ein Beispiel, wie Sie eine diskriminierte Vereinigung in C# mit einer Klassenstruktur simulieren können:

// Define an abstract base class representing the operation result.
public abstract class OperationResult<t>
{
    // Private constructor to ensure the class cannot be instantiated directly.
    private OperationResult() { }

    // Nested class representing a successful operation result.
    public sealed class Success : OperationResult<t>
    {
        public T Value { get; }
        
        public Success(T value) => Value = value;

        public override string ToString() => $"Success: {Value}";
    }

    // Nested class representing a failed operation result.
    public sealed class Failure : OperationResult<t>
    {
        public string Error { get; }
        
        public Failure(string error) => Error = error;

        public override string ToString() => $"Failure: {Error}";
    }

    // Factory method to create a successful operation result.
    public static OperationResult<t> CreateSuccess(T value) => new Success(value);

    // Factory method to create a failed operation result.
    public static OperationResult<t> CreateFailure(string error) => new Failure(error);
}
C#

In diesem Beispiel ist OperationResult<t> eine abstrakte Klasse, die unseren diskriminierten Unionstyp repräsentiert. Es kann entweder ein Success mit einem Wert vom Typ T oder ein Failure mit einer Fehlermeldung sein. Der private Konstruktor stellt sicher, dass Instanzen einer solchen Klasse nur durch die vordefinierten Fälle erstellt werden können.

Verwendung von Pattern Matching mit diskriminierten Unions

C# bietet leistungsstarke Mustererkennungsfähigkeiten, die gut mit diskriminierten Vereinigungen funktionieren. Lassen Sie uns unser OperationResult<t>-Beispiel mit einer Methode erweitern, die verschiedene Fälle mittels eines Switch-Ausdrucks behandelt.

// Method to handle the result using pattern matching.
public string HandleResult(OperationResult<int> result) =>
    result switch
    {
        OperationResult<int>.Success success => $"Operation succeeded with value: {success.Value}",
        OperationResult<int>.Failure failure => $"Operation failed with error: {failure.Error}",
        _ => throw new InvalidOperationException("Unexpected result type")
    };

Der Switch-Ausdruck hier behandelt sowohl den Success- als auch den Failure-Fall des OperationResult<int>. Dies stellt sicher, dass alle möglichen Fälle zur Kompilierungszeit abgedeckt sind, bietet Typsicherheit und reduziert das Risiko von Laufzeitfehlern.

Erweiterungsmethoden für diskriminierte Unions

Sie können die Funktionalität von diskriminierten Vereinigungen mit Erweiterungsmethoden erweitern. Erstellen wir beispielsweise eine Erweiterungsmethode für unser OperationResult<t>, um festzustellen, ob das Ergebnis ein Erfolg ist:

// Static class to hold extension methods for OperationResult<t>.
public static class OperationResultExtensions
{
    // Extension method to check if the operation result indicates success. 
    public static bool IsSuccess<t>(this OperationResult<t> result) =>
        result is OperationResult<t>.Success;
}

Diese statische Methode überprüft, ob das Ergebnis eine Instanz des Success-Falls ist.

Native Support for Discriminated Unions in C#

C# bietet keine native Unterstützung für diskriminierte Vereinigungen wie einige andere Sprachen, aber es gibt laufende Diskussionen in der Community über die Einführung einer solchen Funktion. Natürliche diskriminierte Vereinigungen würden es erleichtern, Vereinigungs-Typen zu definieren und mit ihnen zu arbeiten, ohne auf Klassenhierarchien angewiesen zu sein.

Compiler-Fehler und Typsicherheit

Einer der Hauptvorteile von diskriminierten Vereinigungen ist die von ihnen bereitgestellte Typsicherheit. Da alle möglichen Fälle zur Kompilierungszeit bekannt sind, kann der Compiler durchsetzen, dass alle Fälle behandelt werden. Dies führt zu weniger Laufzeitfehlern und macht den Code weniger fehleranfällig.

Wenn Sie beispielsweise vergessen, einen bestimmten Fall in einer Switch-Anweisung zu behandeln, erzeugt der Compiler einen Fehler und fordert Sie auf, den fehlenden Fall zu adressieren. Dies ist besonders nützlich, wenn man mit komplexen Datenstrukturen arbeitet, die mehrere mögliche Fälle haben.

Using IronPDF with Discriminated Unions in C#

C# Diskriminierte Union (Wie es für Entwickler funktioniert): Abbildung 1 - IronPDF

IronPDF ist eine C# PDF-Bibliothek, die Entwicklern dabei hilft, PDF-Dateien aus HTML zu erstellen und es ihnen ermöglicht, PDF-Dateien ohne Probleme zu ändern. Wenn Sie mit PDFs in C# arbeiten, können Sie IronPDF mit diskriminierten Vereinigungen integrieren, um mit verschiedenen Szenarien bei der Erzeugung oder Verarbeitung von PDF-Dateien umzugehen. Zum Beispiel könnten Sie einen Prozess haben, der entweder erfolgreich ein PDF erstellt oder auf einen Fehler stößt. Diskriminierte Vereinigungen ermöglichen es Ihnen, diesen Prozess klar zu modellieren. Erstellen wir ein einfaches Beispiel, bei dem wir ein PDF mit IronPDF generieren und das Ergebnis als diskriminierte Vereinigung zurückgeben.

// Using directives for necessary namespaces.
using IronPdf;
using System;

// Define an abstract base class representing the PDF generation result.
public abstract class PdfResult
{
    // Private constructor to ensure the class cannot be instantiated directly.
    private PdfResult() { }

    // Nested class representing a successful PDF generation result.
    public sealed class Success : PdfResult
    {
        public PdfDocument Pdf { get; }
        
        public Success(PdfDocument pdf) => Pdf = pdf;

        public override string ToString() => "PDF generation succeeded";
    }

    // Nested class representing a failed PDF generation result.
    public sealed class Failure : PdfResult
    {
        public string ErrorMessage { get; }
        
        public Failure(string errorMessage) => ErrorMessage = errorMessage;

        public override string ToString() => $"PDF generation failed: {ErrorMessage}";
    }

    // Factory method to create a successful PDF result.
    public static PdfResult CreateSuccess(PdfDocument pdf) => new Success(pdf);

    // Factory method to create a failed PDF result.
    public static PdfResult CreateFailure(string errorMessage) => new Failure(errorMessage);
}

// Class to generate PDFs using IronPDF.
public class PdfGenerator
{
    // Method to generate a PDF from HTML content and return the result as a PdfResult.
    public PdfResult GeneratePdf(string htmlContent)
    {
        try
        {
            // Create a new ChromePdfRenderer instance.
            var renderer = new ChromePdfRenderer();

            // Attempt to render the HTML content as a PDF.
            var pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Return a success result with the generated PDF.
            return PdfResult.CreateSuccess(pdf);
        }
        catch (Exception ex)
        {
            // Return a failure result with the error message if an exception occurs.
            return PdfResult.CreateFailure(ex.Message);
        }
    }
}

Die PdfResult-Klasse repräsentiert eine diskriminierte Union mit zwei Fällen: Success und Failure. Der Success-Fall enthält einen PdfDocument, während der Failure-Fall eine Fehlermeldung hält. Die GeneratePdf-Methode nimmt einen HTML-String, versucht ein PDF mit IronPDF zu generieren und gibt das Ergebnis als PdfResult zurück. Wenn die PDF-Erstellung erfolgreich ist, gibt sie den Success-Fall mit dem erstellten PDF zurück. Wenn eine Ausnahme auftritt, gibt sie den Failure-Fall mit der Fehlermeldung zurück.

Abschluss

Diskriminierte Vereinigungen in C# bieten eine kraftvolle und flexible Möglichkeit, Daten mit mehreren möglichen Fällen zu modellieren. Obwohl C# keine Unterstützung für diskriminierte Vereinigungen bietet, können Sie sie mit Klassenhierarchien, Mustererkennung und anderen Techniken simulieren. Der resultierende Code ist typsicherer, weniger fehleranfällig und einfacher zu warten.

IronPDF bietet eine kostenlose Testversion, um Ihnen ein Gefühl für die Software zu geben, ohne dass Vorabkosten anfallen. Sie können alle Funktionen erkunden und sehen, wie sie mit Ihren Anforderungen übereinstimmen. Nach Ihrer Testphase sind Lizenzen ab $999 erhältlich.

Jacob Mellor, Chief Technology Officer @ Team Iron
Chief Technology Officer

Jacob Mellor ist Chief Technology Officer bei Iron Software und ein visionärer Ingenieur, der Pionierarbeit in der C# PDF-Technologie leistet. Als der ursprüngliche Entwickler hinter der Kern-Codebasis von Iron Software hat er die Produktarchitektur des Unternehmens seit seiner Gründung geprägt und es zusammen mit CEO Cameron Rimington in ein Unternehmen mit mehr als 50 Mitarbeitern verwandelt, das die NASA, Tesla und globale Regierungsbehörden beliefert.

...
Weiterlesen

Verwandte Artikel

Key in blue circle

Holen Sie sich sofort Ihren kostenlosen 30-Tage-Testschlüssel.

Your trial license will be sent to your email address

Keine Einschränkungen. 100 % freigeschaltet. Keine Kreditkarte.

OR
bullet_checkedIhr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.Keine Einschränkungen. 100 % freigeschaltet. Keine Kreditkarte.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
Buchen Sie Ihre kostenlose Live-Demo
Booking Badge

Von Millionen von Ingenieur*innen weltweit vertraut

Kundenlogos von Iron Software
Erhalten Sie Ihre unverbindliche Beratung
Füllen Sie das Formular unten aus oder senden Sie eine E-Mail an sales@ironsoftware.com
Ihre Daten werden immer vertraulich behandelt.
Von Millionen von Ingenieur*innen weltweit vertraut
Kundenlogos von Iron Software
Erhalten Sie sofort Ihren kostenlosen 30-Tage-Testschlüssel.
Ihr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.
C# NuGet-Bibliothek für PDF
Installation mit NuGet

Version: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. Rechtsklick auf Referenzen, NuGet-Pakete verwalten
  2. Wählen Sie Durchsuchen und suchen Sie nach 'IronPDF'
  3. Paket auswählen und installieren
C# PDF DLL
Download DLL

Version: 2026.9

oder laden Sie den Windows-Installer hier herunter.

  1. Laden Sie IronPDF herunter und entpacken Sie es in ein Verzeichnis wie ~/Libs innerhalb Ihres Lösungsverzeichnisses
  2. Im Visual Studio-Projektmappen-Explorer klicken Sie mit der rechten Maustaste auf Referenzen. Wählen Sie Durchsuchen, "IronPDF.dll"

Lizenzen ab 749 $