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

性能考虑

尽管强制转换通常效率很高，但不必要或过多的强制转换可能导致性能问题，特别是在涉及大型集合或复杂对象的场景中。 为了优化性能：

• 尽可能与最具体的类型一起工作以最小化强制转换。
• 避免在性能关键循环中进行强制转换，而是缓存结果。
• 在可能的情况下，利用内置方法进行类型转换，因为它们通常可以提供更优化的性能。