C# Tip Dönüştürme (Geliştiriciler İçin Nasıl Çalışır)

Örtülü vs. Açık Tür Dönüştürme

C#'ta, tür dönüştürme genellikle iki türe ayrılabilir: örtük dönüştürme ve açık dönüştürme.

• Örtük Dönüştürme: Derleyici tarafından otomatik olarak yapılan bir dönüştürmedir. Güvenlidir ve veri kaybına yol açmaz. Örneğin, daha küçük bir veri türündeki (bir tamsayı değişkeni gibi) bir değişkeni, daha büyük bir tür (bir double değişkeni gibi) olarak dönüştürmek örtüktür:

  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

  Bu işlem, genellikle otomatik dönüştürme olarak adlandırılır, çünkü C# derleyicisi, geliştiriciden herhangi bir açık bir talimat olmadan bunu ele alır.

• Açık Dönüştürme: Bu, bir cast işlemi gerektirir ve daha büyük bir türden daha küçük bir türe dönüştürme yapıldığında gereklidir, çünkü veri kaybına yol açabilir. Örneğin:

  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

  Bu durumda, geliştirici, veri türünü başka bir türe dönüştürmek niyetinde olduğunu belirtmelidir, bu nedenle terim açık tür dönüştürme kullanılıyor.

Yaygın Tür Dönüştürme Senaryoları

Tür dönüştürme, genellikle temel ve türetilmiş sınıfları içeren senaryolarda kullanılır. Örneğin, bir sınıf hiyerarşisiyle çalışırken, bir türetilmiş sınıf nesnesini kendi temel sınıf türüne dönüştürebilirsiniz:

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 kullanırken, farklı PDF ile ilgili sınıflarla uğraşırken tür dönüştürme, belirli özelliklere veya yöntemlere erişmek için genel bir PDF nesnesini daha özel bir türe dönüştürmek istediğinizde çok önemlidir.

Installing IronPDF

Install-Package IronPdf

using IronPdf;

using IronPdf;

Imports IronPdf

PDF Belge Nesneleriyle Çalışma

IronPDF, PdfDocument, ChromePdfRenderer ve PdfPage gibi sınıfları kullanarak PDF belgelerini manipüle etmek için çeşitli sınıflar sağlar. Bu türlerin nasıl birbirleriyle etkileştiğini anlamak, etkili bir PDF manipülasyonu için çok önemlidir.

Örneğin, elinizde genel PdfDocument nesnelerinden oluşan bir koleksiyon olabilir ve belirli bir PdfPage nesnesiyle çalışmanız gerekir. Bu, tür dönüştürme yoluyla gerçekleştirilebilir:

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

Bu tür dönüştürme, PDF içeriği üzerindeki kontrolünüzü artırarak PdfPage 'e özgü özelliklere ve yöntemlere erişmenizi sağlar.

Örnek: Tür Dönüştürme Uygulamada

PDF dosyasından metin çıkartmamız ve nesneleri uygun şekilde dönüştürmemiz gereken aşağıdaki örneğe bir göz atalım:

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

Giriş PDF:

Konsol Çıkışı:

Bu örnekte, bir PDF belgesi yüklüyoruz, sayfalarını döngü ile geziyoruz ve metin içeriğini çıkartmak için her sayfayı PdfPage'e dönüştürüyoruz. Bu, IronPDF sınıflarının belirli özellikleri ve yöntemleri ile çalışma yeteneğinizi gösterir.

InvalidCastException'dan Kaçınma

Tür dönüştürme yaparken, dönüşümün geçerli olduğundan emin olmak önemlidir, böylece çalışma zamanında bir InvalidCastException'dan kaçınılabilir. İşte bazı en iyi uygulamalar:

1. as Anahtar Kelimesini Kullanın: Bu anahtar kelime, başarısız olursa bir istisna fırlatmadan dönüşüm yapmanıza olanak tanır. Bunun yerine null döner.

   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 ile Tür Kontrolü: Dönüştürmeden önce, nesnenin türünü is anahtar kelimesini kullanarak kontrol edebilirsiniz.

   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. Kullanıcı Tanımlı Dönüştürmeler: C#, geliştiricilerin kullanıcı tanımlı dönüştürmeler aracılığıyla özel sınıflar için kendi tür dönüştürme kurallarını tanımlamalarına olanak tanır. Farklı kullanıcı tanımlı türler arasında daha sezgisel bir dönüştürme yolu sağlamak istediğinizde bu özellikle yararlı olabilir.

   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

Performans Hususları

Genellikle tür dönüştürme etkili olsa da, aşırı veya gereksiz tür dönüştürme, özellikle büyük koleksiyonlar veya karmaşık nesneler içeren senaryolarda performans sorunlarına yol açabilir. Performansı optimize etmek için:

• Mümkün olan her durumda, en spesifik türler ile çalışarak tür dönüştürmeyi en aza indirin.
• Performansının kritik olduğu döngülerde tür dönüştürmeden kaçının, bunun yerine mümkün olduğunda sonuçları önbelleğe alın.
• Tür dönüştürme için yerleşik yöntemleri kullanmayı tercih edin, çünkü bunlar genellikle daha optimize edilmiş performans sunabilir.