C# Rzutowanie (Jak to dziala dla programistow)

Rzutowanie niejawne vs. jawne

W C# rzutowanie można ogólnie podzielić na dwa rodzaje: konwersja niejawna i konwersja jawna.

• Konwersja niejawna: Występuje, gdy konwersja jest wykonywana automatycznie przez kompilator. Jest bezpieczna i nie prowadzi do utraty danych. Na przykład, konwersja mniejszego typu danych (np. zmienna typu całkowitego) na większy typ (np. zmienna typu double) jest niejawna:

  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

  Dim myInt As Integer = 10 ' Integer variable
  Dim myDouble As Double = myInt ' Implicit casting from int to double

  $vbLabelText   $csharpLabel

  Ten proces jest często nazywany automatyczną konwersją, ponieważ kompilator C# obsługuje to bez wyraźnych instrukcji od programisty.

• Konwersja jawna: Wymaga operacji rzutowania i jest konieczna podczas konwersji z większego typu na mniejszy, ponieważ może to prowadzić do utraty danych. Na przykład:

  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

  Imports System
  
  Dim myDouble As Double = 9.78
  Dim myInt As Integer = CInt(Math.Truncate(myDouble)) ' Explicit casting from double to int

  $vbLabelText   $csharpLabel

  W takim przypadku programista musi wskazać swoją intencję przekształcenia typu danych na inny typ, stąd termin jawne rzutowanie typów.

Typowe scenariusze rzutowania

Rzutowanie jest często używane w scenariuszach obejmujących klasy bazowe i pochodne. Na przykład, podczas pracy z hierarchią klas, można rzutować obiekt klasy pochodnej na typ klasy bazowej:

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

Friend Class Base
End Class
Friend Class Derived
	Inherits Base

End Class
Private derived As New Derived()
Private baseRef As Base = derived ' Implicit casting to base class

Podczas korzystania z IronPDF, rzutowanie jest niezbędne przy pracy z różnymi klasami związanymi z PDF, takimi jak gdy chcesz przekształcić ogólny obiekt PDF w bardziej specyficzny typ, aby uzyskać dostęp do określonych właściwości lub metod.

Instalacja IronPDF

Install-Package IronPdf

using IronPdf;

using IronPdf;

Imports IronPdf

Praca z obiektami dokumentu PDF

IronPDF dostarcza kilka klas do manipulacji dokumentami PDF, takich jak PdfDocument, ChromePdfRenderer i PdfPage. Zrozumienie, jak te typy współdziałają poprzez rzutowanie, jest kluczowe dla efektywnej manipulacji PDF.

Na przykład, możesz mieć kolekcję ogólnych obiektów PdfDocument i potrzebujesz pracować z konkretnym obiektem PdfPage. Możesz to osiągnąć dzięki rzutowaniu:

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

Dim pdfDoc As New PdfDocument(210, 297)
Dim page As PdfPage = CType(pdfDoc.Pages(0), PdfPage) ' Casting a generic PDF page to a specific type

To rzutowanie pozwala uzyskać dostęp do właściwości i metod specyficznych dla PdfPage, zwiększając kontrolę nad zawartością PDF.

Przykład: Rzutowanie w działaniu

Przyjrzyjmy się następującemu przykładowi, w którym musimy wyodrębnić tekst z PDF i odpowiednio zrzutować obiekty:

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}");
    }
}

Imports IronPdf
Imports IronPdf.Pages
Imports System

Public Shared Sub Main(ByVal args() As String)
	Dim pdf As PdfDocument = PdfDocument.FromFile("example.pdf")
	For Each page As PdfPage In pdf.Pages
		Dim pdfPage As PdfPage = CType(page, PdfPage)
		Dim text As String = pdfPage.Text
		Console.WriteLine($"Text from Page {pdfPage.PageIndex}: {text}")
	Next page
End Sub

Wejściowy PDF:

Wyjście w konsoli:

W tym przykładzie ładujemy dokument PDF, iterujemy przez jego strony i rzutujemy każdą stronę na PdfPage, aby wyodrębnić zawartość tekstową. To pokazuje, jak rzutowanie umożliwia pracę z określonymi właściwościami i metodami klas IronPDF.

Unikanie InvalidCastException

Podczas rzutowania, ważne jest, aby upewnić się, że konwersja jest ważna, aby uniknąć InvalidCastException w czasie wykonywania. Oto kilka najlepszych praktyk:

1. Używaj słowa kluczowego as: To słowo kluczowe pozwala spróbować rzutować bez wywoływania wyjątku w przypadku niepowodzenia. Zamiast tego zwraca null.

   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
   }

   Dim pdfPage As PdfPage = TryCast(page, PdfPage) ' Safe cast
   If pdfPage IsNot Nothing Then
   	' Proceed with pdfPage
   End If

   $vbLabelText   $csharpLabel

2. Sprawdzanie typu za pomocą is: Przed rzutowaniem możesz sprawdzić typ obiektu, używając słowa kluczowego is.

   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
   }

   If TypeOf page Is PdfPage Then
   	Dim pdfPage As PdfPage = CType(page, PdfPage) ' Safe cast after type check
   End If

   $vbLabelText   $csharpLabel

3. Konwersje zdefiniowane przez użytkownika: C# pozwala programistom definiować własne reguły rzutowania dla klas niestandardowych poprzez konwersje zdefiniowane przez użytkownika. Może to być szczególnie użyteczne, gdy chcesz ułatwić bardziej intuicyjny sposób przekształcania pomiędzy różnymi typami zdefiniowanymi przez użytkownika.

   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

   Public Class MyCustomType
   	Public Shared Narrowing Operator CType(ByVal value As Integer) As MyCustomType
   		Return New MyCustomType()
   	End Operator
   End Class
   
   Private myInt As Integer = 5
   Private myCustomType As MyCustomType = CType(myInt, MyCustomType) ' Using explicit user-defined conversion

   $vbLabelText   $csharpLabel

Rozważania dotyczące wydajności

Chociaż rzutowanie jest na ogół wydajne, nadmierne lub niepotrzebne rzutowanie może prowadzić do problemów z wydajnością, zwłaszcza w scenariuszach obejmujących duże kolekcje lub skomplikowane obiekty. Aby zoptymalizować wydajność:

• Minimalizuj rzutowanie, pracując z najbardziej specyficznymi typami, kiedy to możliwe.
• Unikaj rzutowania w pętlach krytycznych dla wydajności i zamiast tego buforuj wyniki, gdzie to możliwe.
• Korzystaj z wbudowanych metod konwersji typów, gdy to możliwe, ponieważ często mogą zapewnić bardziej zoptymalizowaną wydajność.