C# 캐스팅 (개발자를 위한 작동 방식)

묵시적 VS 명시적 캐스팅

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는 PdfDocument, ChromePdfRenderer, PdfPage와 같은 PDF 문서를 조작하기 위한 여러 클래스를 제공합니다. 이러한 유형이 캐스팅을 통해 상호작용하는 방식을 이해하는 것은 효과적인 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

성능 고려 사항

캐스팅은 일반적으로 효율적이지만, 지나치거나 불필요한 캐스팅은 성능 문제를 초래할 수 있습니다. 특히 대량의 컬렉션이나 복잡한 객체를 포함하는 시나리오에서 그렇습니다. 성능을 최적화하기 위해:

• 가능한 한 가장 구체적인 유형으로 작업하여 캐스팅을 최소화하십시오.
• 성능이 중요한 루프에서 캐스팅을 피하고 가능한 경우 캐시 결과를 사용하십시오.
• 유형 변환을 위한 내장 메서드를 사용할 수 있는 경우 사용하십시오. 이는 더 최적화된 성능을 제공할 수 있습니다.