C# Casting (Wie es für Entwickler funktioniert)

Implizites vs. explizites Casting

In C# kann Casting grundsätzlich in zwei Typen unterteilt werden: implizite Konvertierung und explizite Konvertierung.

• Implizite Konvertierung: Dies tritt auf, wenn eine Konvertierung automatisch vom Compiler durchgeführt wird. Es ist sicher und führt nicht zu Datenverlust. Zum Beispiel ist die Konvertierung eines kleineren Datentyps (wie einer Ganzzahlvariablen) in einen größeren Typ (wie eine double-Variable) implizit:

  int myInt = 10; // Integer variable
  double myDouble = myInt; // Implicit casting from int to double

  int myInt = 10; // Integer variable
  double myDouble = myInt; // Implicit casting from int to double

  $vbLabelText   $csharpLabel

  Dieser Prozess wird oft als automatische Konvertierung bezeichnet, da der C# Compiler ihn ohne explizite Anweisung vom Entwickler durchführt.

• Explizite Konvertierung: Dies erfordert eine Typumwandlung und ist notwendig, wenn von einem größeren Typ in einen kleineren Typ konvertiert wird, da es sonst zu Datenverlusten kommen kann. Zum Beispiel:

  double myDouble = 9.78;
  int myInt = (int)myDouble; // Explicit casting from double to int

  double myDouble = 9.78;
  int myInt = (int)myDouble; // Explicit casting from double to int

  $vbLabelText   $csharpLabel

  In diesem Fall muss der Entwickler angeben, dass er die Daten in einen anderen Typ konvertieren möchte, daher der Begriff explizites Typ-Casting.

Gängige Casting-Szenarien

Casting wird häufig in Szenarien mit Basisklassen und abgeleiteten Klassen verwendet. Zum Beispiel können Sie bei der Arbeit mit einer Klassenhierarchie ein Objekt einer abgeleiteten Klasse in den Typ seiner Basisklasse umwandeln:

class Base { }
class Derived : Base { }
Derived derived = new Derived();
Base baseRef = derived; // Implicit casting to base class

class Base { }
class Derived : Base { }
Derived derived = new Derived();
Base baseRef = derived; // Implicit casting to base class

Bei der Verwendung von IronPDF ist Casting unerlässlich, wenn es um verschiedene PDF-bezogene Klassen geht, wie z.B. wenn Sie ein generisches PDF-Objekt in einen spezifischeren Typ umwandeln möchten, um auf bestimmte Eigenschaften oder Methoden zuzugreifen.

Installation von IronPDF

Install-Package IronPdf

using IronPdf;

using IronPdf;

Arbeiten mit PDF-Dokumentenobjekten

IronPDF bietet mehrere Klassen zur Bearbeitung von PDF-Dokumenten, wie PdfDocument, ChromePdfRenderer und PdfPage. Das Verständnis, wie diese Typen durch Casting interagieren, ist entscheidend für eine effektive PDF-Bearbeitung.

Zum Beispiel haben Sie möglicherweise eine Sammlung von generischen PdfDocument-Objekten und müssen mit einem bestimmten PdfPage-Objekt arbeiten. Dies können Sie durch Casting erreichen:

PdfDocument pdfDoc = new PdfDocument(210, 297);
PdfPage page = (PdfPage)pdfDoc.Pages[0]; // Casting a generic PDF page to a specific type

PdfDocument pdfDoc = new PdfDocument(210, 297);
PdfPage page = (PdfPage)pdfDoc.Pages[0]; // Casting a generic PDF page to a specific type

Dieses Casting ermöglicht es Ihnen, auf Eigenschaften und Methoden zuzugreifen, die spezifisch für PdfPage sind, wodurch Sie mehr Kontrolle über den PDF-Inhalt erhalten.

Beispiel: Casting in Aktion

Schauen wir uns das folgende Beispiel an, in dem wir Text aus einer PDF-Datei extrahieren und Objekte entsprechend umwandeln müssen:

using IronPdf;
using IronPdf.Pages;
using System;

public static void Main(string[] args)
{
    PdfDocument pdf = PdfDocument.FromFile("example.pdf");
    foreach (PdfPage page in pdf.Pages)
    {
        PdfPage pdfPage = (PdfPage)page;
        string text = pdfPage.Text;
        Console.WriteLine($"Text from Page {pdfPage.PageIndex}: {text}");
    }
}

using IronPdf;
using IronPdf.Pages;
using System;

public static void Main(string[] args)
{
    PdfDocument pdf = PdfDocument.FromFile("example.pdf");
    foreach (PdfPage page in pdf.Pages)
    {
        PdfPage pdfPage = (PdfPage)page;
        string text = pdfPage.Text;
        Console.WriteLine($"Text from Page {pdfPage.PageIndex}: {text}");
    }
}

Eingabe PDF:

Konsolenausgabe:

In diesem Beispiel laden wir ein PDF-Dokument, iterieren durch seine Seiten und wandeln jede Seite in PdfPage um, um Textinhalt zu extrahieren. Dies zeigt, wie Casting es Ihnen ermöglicht, mit den spezifischen Eigenschaften und Methoden der IronPDF-Klassen zu arbeiten.

Umgehung der InvalidCastException

Beim Casting ist es wichtig, sicherzustellen, dass die Konvertierung gültig ist, um eine InvalidCastException zur Laufzeit zu vermeiden. Hier sind einige bewährte Verfahren:

1. Verwenden Sie das Schlüsselwort as : Mit diesem Schlüsselwort können Sie eine Typumwandlung versuchen, ohne im Fehlerfall eine Ausnahme auszulösen. Stattdessen gibt es null zurück.

   PdfPage pdfPage = page as PdfPage; // Safe cast
   if (pdfPage != null)
   {
       // Proceed with pdfPage
   }

   PdfPage pdfPage = page as PdfPage; // Safe cast
   if (pdfPage != null)
   {
       // Proceed with pdfPage
   }

   $vbLabelText   $csharpLabel

2. Typüberprüfung mit is : Vor der Typumwandlung können Sie den Typ des Objekts mit dem Schlüsselwort is überprüfen.

   if (page is PdfPage)
   {
       PdfPage pdfPage = (PdfPage)page; // Safe cast after type check
   }

   if (page is PdfPage)
   {
       PdfPage pdfPage = (PdfPage)page; // Safe cast after type check
   }

   $vbLabelText   $csharpLabel

3. Benutzerdefinierte Konvertierungen: C# ermöglicht es Entwicklern, ihre eigenen Umwandlungsregeln für benutzerdefinierte Klassen durch benutzerdefinierte Konvertierungen zu definieren. Dies kann besonders nützlich sein, wenn Sie eine intuitivere Möglichkeit der Konvertierung zwischen verschiedenen benutzerdefinierten Typen schaffen möchten.

   public class MyCustomType
   {
       public static explicit operator MyCustomType(int value)
       {
           return new MyCustomType(/* conversion logic */);
       }
   }
   
   int myInt = 5;
   MyCustomType myCustomType = (MyCustomType)myInt; // Using explicit user-defined conversion

   public class MyCustomType
   {
       public static explicit operator MyCustomType(int value)
       {
           return new MyCustomType(/* conversion logic */);
       }
   }
   
   int myInt = 5;
   MyCustomType myCustomType = (MyCustomType)myInt; // Using explicit user-defined conversion

   $vbLabelText   $csharpLabel

Erwägungen zur Leistung

Obwohl Casting im Allgemeinen effizient ist, kann übermäßiges oder unnötiges Casting zu Performance-Problemen führen, insbesondere in Szenarien mit großen Sammlungen oder komplexen Objekten. Um die Leistung zu optimieren:

• Minimieren Sie das Casting, indem Sie wann immer möglich mit den spezifischsten Typen arbeiten.
• Vermeiden Sie Casting in leistungskritischen Schleifen und speichern Sie Ergebnisse, wo möglich.
• Nutzen Sie eingebauter Methoden zur Typkonvertierung, wenn möglich, da diese oft eine optimiertere Leistung bieten.