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

隱式鑄造與顯式鑄造

在 C# 中，轉換大致可分為兩種類型：隱式轉換和顯式轉換。

• 隱含轉換：當編譯器自動執行轉換時會發生這種情況。 安全且不會導致資料遺失。 例如，將較小的資料類型 (如整數變數) 轉換為較大的類型 (如 double 變數) 是隱含的：

  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

  在這種情況下，開發人員必須表明他們打算將資料類型轉換為另一種類型，因此稱為明確類型轉換 (explicit type casting)。

常見的鑄造情境

鑄造通常用於涉及基類和派生類的情況。 例如，在處理類的階層結構時，您可以將衍生類的物件轉換為其基類的類型：

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。

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

2.使用 is 進行類型檢查：在鑄造之前，您可以使用 is 關鍵字檢查物件的類型。

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

3.使用者定義的轉換：C# 允許開發人員透過使用者定義的轉換，為自訂類別定義自己的轉換規則。 當您想要促進以更直覺的方式在不同的使用者定義類型之間進行轉換時，這可能會特別有用。

```csharp
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
```

效能考量

鑄造通常是有效率的，但過度或不必要的鑄造可能會導致效能問題，尤其是在涉及大型集合或複雜物件的情況下。 優化效能：

• 盡可能使用最特定的類型，以減少鑄造。
• 避免在性能關鍵的迴圈中進行鑄造，而是在可行的情況下快取結果。
• 盡可能利用內建方法進行類型轉換，因為它們通常可以提供更優化的效能。