C# 型別轉換 (如何為開發人員運作)

隱式與顯式型別轉換

在 C# 中，型別轉換主要可分為兩種型別：隱式轉換 和 顯式轉換。

• 隱式轉換： 當編譯器自動進行轉換時發生。 這是安全的，不會導致資料丟失。 例如，將較小資料型別（如整數變數）轉換為較大型別（如雙精度變數）是隱式轉換：

  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

  這個過程通常被稱為自動轉換，因為 C# 編譯器處理它時不需開發者提供顯式指令。

• 顯式轉換： 需要使用 cast 操作，當從較大型別轉換為較小型別時是必要的，因為這可能導致資料丟失。 例如：

  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

  在這種情況下，開發者必須表明他們打算將資料型別轉換為另一種型別，因此稱為顯式型別轉換。

常見的型別轉換場景

型別轉換通常用於涉及基類和派生類的場景中。 例如，當處理型別層次結構時，您可以將派生類物件轉換為其基類型別：

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

當使用 IronPDF 時，型別轉換在處理各種與 PDF 有關的類別時是必需的，例如，當您想要將通用 PDF 物件轉換為更具體的型別以存取某些屬性或方法時。

安裝IronPDF

Install-Package IronPdf

using IronPdf;

using IronPdf;

Imports IronPdf

處理 PDF 文件物件

IronPDF 提供若干類來操作 PDF 文件，例如 PdfDocument、ChromePdfRenderer 和 PdfPage。 理解這些型別通過型別轉換如何相互作用對於有效的 PDF 操作至關重要。

例如，您可能有一組通用的 PdfDocument 物件，並需要處理一個具體的 PdfPage 物件。 您可以通過型別轉換來實現這一點：

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

這種型別轉換允許您存取 PdfPage 特定的屬性和方法，增強了對 PDF 內容的控制。

範例：作用中的型別轉換

讓我們看看以下例子，我們需要從 PDF 中提取文字並正確轉換物件：

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

輸入 PDF：

控制台輸出：

在此例中，我們載入了一份 PDF 文件，遍歷其頁面，並將每個頁面轉換為 PdfPage 以提取文字內容。 這突顯了型別轉換如何使您能夠與 IronPDF 類的特定屬性和方法一起工作。

避免 InvalidCastException

進行型別轉換時，確保轉換有效以避免在運行時出現 InvalidCastException 這一點很重要。以下是一些最佳實踐：

1. 使用 as 關鍵字：此關鍵字允許您在嘗試轉換失敗時不拋出異常。 相反，它返回 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. 使用 is 進行型別檢查：在進行型別轉換之前，您可以使用 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. 使用者定義轉換： C# 允許開發者通過使用者定義轉換來為自訂類定義自己的轉換規則。 當您想要在不同使用者定義型別之間提供更直觀的轉換途徑時，這特別有用。

   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

性能考慮

儘管型別轉換通常是高效的，但過多或不必要地進行轉換可能會導致性能問題，尤其是在涉及大量集合或複雜物件的情況下。 為了優化性能：

• 儘量通過使用最具體的型別來減少型別轉換。
• 避免在性能關鍵的迴圈中進行型別轉換，而是儘可能快取結果。
• 儘可能利用內建方法進行型別轉換，因為它們往往提供更優化的性能。