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#編譯器在不需要開發者明確指示的情況下處理它。

• 顯式轉換：這需要一個轉型操作，並且在從大類型轉換為小類型時是必要的，因為這可能導致數據丟失。 例如：

  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 provides several classes to manipulate PDF documents, such as PdfDocument, ChromePdfRenderer, and 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

性能考量

雖然轉型通常效率很高，但過度或不必要的轉型可能會導致性能問題，特別是在涉及大集合或複雜對象的場景中。 優化性能：

• 儘可能使用最具體的類型以最小化轉型。
• 在性能關鍵的循環中避免轉型，並盡可能緩存結果。
• 儘量利用內置的類型轉換方法，因為它們常常能提供更優化的性能。