'nameof' operatörü, C# 6.0'de tanıtılan ve program öğelerine isimle referans verirken sessizce bozulan çalışma zamanı davranışını adreslemek için tasarlanmış bir derleme zamanı yapısıdır. Birincil hedefi, kodlanmış dizeleri ortadan kaldırmak, daha sürdürülebilir ve hata oranı düşük bir yaklaşım sunmaktır. Bu makalede, C#'deki nameof operatörünü keşfedeceğiz ve ayrıca PDF belgelerini programatik olarak oluşturmak için IronPDF Kütüphanesi tanıtacağız.
'nameof' operatörünün temel sözdizimi basittir. Bir öğeyi argüman olarak alır ve adını bir dize olarak döndürür. Aşağıdaki örneğe bakın:
static void Main()
{
// Declare a string variable
string myVariable = nameof(myVariable);
Console.WriteLine(myVariable); // Output: "myVariable"
}Shared Sub Main()
' Declare a string variable
Dim myVariable As String = NameOf(myVariable)
Console.WriteLine(myVariable) ' Output: "myVariable"
End SubBu durumda, 'nameof(myVariable)' dizesi 'myVariable' verir. Operatör, değişkenler, türler, üyeler ve daha fazlası dahil olmak üzere çeşitli kod öğelerine uygulanabilir.
'nameof' operatörünün öne çıkan avantajlarından biri, kod sürdürülebilirliği üzerindeki olumlu etkisidir. İsimleri dizi olarak kodlamak yerine, geliştiriciler adların değişmesi durumunda referansların otomatik olarak güncellenmesini sağlayarak 'nameof' kullanabilirler.
static void Main()
{
// Without using nameof
Logger.Log("Error: The variable 'myVariable' is null.");
// Using nameof for improved maintainability
Logger.Log($"Error: The variable '{nameof(myVariable)}' is null.");
}Shared Sub Main()
' Without using nameof
Logger.Log("Error: The variable 'myVariable' is null.")
' Using nameof for improved maintainability
Logger.Log($"Error: The variable '{NameOf(myVariable)}' is null.")
End Sub'nameof', adlardaki yanlış yazım veya tutarsızlık riskini ortadan kaldırarak derleme zamanı güvenliğini artırır. Bir değişken adını yanlış yazmak veya değiştirmek, çalışma zamanı sorunlarını azaltarak bir derleme zamanı hatasına neden olur.
static void Main()
{
// Compile-time error if 'myVariable' is misspelled
string myVariable;
string variableName = nameof(myVariable);
Console.WriteLine(variableName);
}Shared Sub Main()
' Compile-time error if 'myVariable' is misspelled
Dim myVariable As String
Dim variableName As String = NameOf(myVariable)
Console.WriteLine(variableName)
End Sub'nameof' operatörü, değişkenler, türler veya üyeleri yeniden adlandırırken sorunsuz bir deneyim sunarak yeniden adlandırma araçlarıyla sorunsuz bir şekilde bütünleşir. Tüm 'nameof' referansları otomatik olarak güncellenir.
static void Main()
{
// Before renaming local variable 'myVariable' to 'newVariable'
string myVariableNameChange = nameof(myVariableNameChange);
// After renaming local variable 'myVariable' to 'newVariable'
string newVariableNameChange = nameof(newVariableNameChange);
Console.WriteLine(newVariableNameChange);
}Shared Sub Main()
' Before renaming local variable 'myVariable' to 'newVariable'
Dim myVariableNameChange As String = NameOf(myVariableNameChange)
' After renaming local variable 'myVariable' to 'newVariable'
Dim newVariableNameChange As String = NameOf(newVariableNameChange)
Console.WriteLine(newVariableNameChange)
End SubHata ayıklama sırasında, 'nameof' kodu daha bilgilendirici ve okunabilir hale getirir. Günlükleme ifadeler, istisna mesajları ve diğer hata ayıklama çıktıları kısa ve bağlamsal olarak uygun hale gelir.
static void Main()
{
// Without using nameof
// throw new ArgumentNullException("myVariable", "The variable cannot be null.");
// Using nameof for improved debugging
throw new ArgumentNullException(nameof(myVariable), "The variable cannot be null.");
}Shared Sub Main()
' Without using nameof
' throw new ArgumentNullException("myVariable", "The variable cannot be null.");
' Using nameof for improved debugging
Throw New ArgumentNullException(NameOf(myVariable), "The variable cannot be null.")
End SubBurada, değişken tanımlanmadıysa throw new ArgumentNullException bir istisna fırlatır.
Reflection ile çalışırken, 'nameof' operatörü, türlerin, özelliklerin veya yöntemlerin isimlerini dize olarak kodlamadan almayı basitleştirir.
Type type = typeof(MyClass);
string typeName = nameof(MyClass);Dim type As Type = GetType([MyClass])
Dim typeName As String = NameOf([MyClass])Örnek sınıf MyClass sabit kodlanmış bir string olabilir, ancak sınıf adını dinamik olarak almak için yansımayı kullanabiliriz. Değişken type sınıf adını içerir ve sonra bir sınıf örneğinin adını almak için nameof anahtar kelimesi kullanılır. Aynı ad değildirler.
'nameof', günlükleme ifadeleri ve istisna mesajlarında değerli hale gelir, onları daha okunabilir ve hata oranı düşük hale getirir.
Logger.Log($"Error: The property '{nameof(MyClass.MyProperty)}' is out of range.");Logger.Log($"Error: The property '{NameOf([MyClass].MyProperty)}' is out of range.")Bu örnekte, bir Kişiyi temsil eden basit bir sınıf oluşturacağız ve günlükleme ve hata mesajlarını iyileştirmek için nameof operatörünü kullanacağız.
using System;
class Person
{
public string FirstName { get; set; }
public string LastName { get; set; }
// Method that displays the full name of the person
public void DisplayFullName()
{
if (string.IsNullOrEmpty(FirstName) || string.IsNullOrEmpty(LastName))
{
LogError($"Invalid name: {nameof(FirstName)} or {nameof(LastName)} is missing.");
}
else
{
Console.WriteLine($"Full Name: {FirstName} {LastName}");
}
}
// Custom error logging method that highlights errors
private void LogError(string errorMessage)
{
Console.ForegroundColor = ConsoleColor.Red;
Console.WriteLine($"Error: {errorMessage}");
Console.ResetColor();
}
}
class Program
{
static void Main()
{
// Create an instance of the Person class
Person person = new Person();
// Attempt to display the full name without setting the properties
person.DisplayFullName();
// Set the properties and display the full name again
person.FirstName = "John";
person.LastName = "Doe";
person.DisplayFullName();
}
}Imports System
Friend Class Person
Public Property FirstName() As String
Public Property LastName() As String
' Method that displays the full name of the person
Public Sub DisplayFullName()
If String.IsNullOrEmpty(FirstName) OrElse String.IsNullOrEmpty(LastName) Then
LogError($"Invalid name: {NameOf(FirstName)} or {NameOf(LastName)} is missing.")
Else
Console.WriteLine($"Full Name: {FirstName} {LastName}")
End If
End Sub
' Custom error logging method that highlights errors
Private Sub LogError(ByVal errorMessage As String)
Console.ForegroundColor = ConsoleColor.Red
Console.WriteLine($"Error: {errorMessage}")
Console.ResetColor()
End Sub
End Class
Friend Class Program
Shared Sub Main()
' Create an instance of the Person class
Dim person As New Person()
' Attempt to display the full name without setting the properties
person.DisplayFullName()
' Set the properties and display the full name again
person.FirstName = "John"
person.LastName = "Doe"
person.DisplayFullName()
End Sub
End ClassPerson sınıfımız var ve FirstName ile LastName özelliklerine ve tam adı görüntülemeden önce her iki özelliğin ayarlandığını kontrol eden bir DisplayFullName yöntemine sahibiz.DisplayFullName yönteminin içinde, özellik adlarına dize literalleri olarak başvurmak için nameof(FirstName) ve nameof(LastName) kullanırız. Bu, kod okunabilirliğini artırır ve eğer özellik adları değişirse, hem özellik tanımı hem de karşılık gelen hata mesajı derleme sırasında otomatik olarak güncellenir.LogError yöntemi, hata mesajına özellik adını dinamik olarak eklemek için nameof kullanır.Main yönteminde, Person sınıfının bir örneğini oluşturur, özellikleri ayarlamadan tam adı görüntülemeye çalışır, ardından özellikleri ayarlar ve tam adı tekrar görüntüleriz.Bu programı çalıştırdığınızda, hata mesajının dinamik olarak özellik adlarını içerdiğini göreceksiniz, daha fazla bağlam sağlar ve hangi özelliğin eksik olduğunu belirlemeyi kolaylaştırır.
Bu örnek, öz debugıktırma adı operatörünün, özellik adları değiştiğinde referansları otomatik olarak güncelleyerek kodun sürdürülebilirliğini geliştirdiğini ve geliştirme sırasında daha bilgilendirici detaylarla hata mesajlarını iyileştirdiğini gösterir.
IronPDF for C#.NET, bir PDF okuyucu ve üreticisi olarak kullanılabilen, Iron Software tarafından sunulan bir PDF kütüphanesidir. Burada temel işlevsellik tanıtılmaktadır. Daha fazla bilgi için belgelere bakınız.
IronPDF'in öne çıkan özelliği, düzenleriniz ve stilleriniz korunarak HTML'den PDF'ye Dönüştürme yetenekleridir. Web içeriğinden PDF'ler oluşturur ve raporlar, faturalar ve dökümantasyon için mükemmeldir. HTML dosyaları, URL'ler ve HTML dizgileri kesintisiz olarak PDF'ye dönüştürülebilir.
using IronPdf;
class Program
{
static void Main(string[] args)
{
var renderer = new ChromePdfRenderer();
// 1. Convert HTML String to PDF
var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");
// 2. Convert HTML File to PDF
var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");
// 3. Convert URL to PDF
var url = "http://ironpdf.com"; // Specify the URL
var pdfFromUrl = renderer.RenderUrlAsPdf(url);
pdfFromUrl.SaveAs("URLToPDF.pdf");
}
}Imports IronPdf
Friend Class Program
Shared Sub Main(ByVal args() As String)
Dim renderer = New ChromePdfRenderer()
' 1. Convert HTML String to PDF
Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")
' 2. Convert HTML File to PDF
Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")
' 3. Convert URL to PDF
Dim url = "http://ironpdf.com" ' Specify the URL
Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
pdfFromUrl.SaveAs("URLToPDF.pdf")
End Sub
End ClassIronPDF, NuGet paket yöneticisi konsolunu veya Visual Studio paket yöneticisini kullanarak yüklenebilir.
namespace OrderBy;
class Person
{
public string FirstName { get; set; }
public string LastName { get; set; }
public void DisplayFullName()
{
if (string.IsNullOrEmpty(FirstName) || string.IsNullOrEmpty(LastName))
{
LogError($"Invalid name: {nameof(FirstName)} or {nameof(LastName)} is missing.");
}
else
{
Console.WriteLine($"Full Name: {FirstName} {LastName}");
}
}
public void PrintPdf()
{
Console.WriteLine("Generating PDF using IronPDF.");
string content = $@"<!DOCTYPE html>
<html>
<body>
<h1>Hello, {FirstName}!</h1>
<p>First Name: {FirstName}</p>
<p>Last Name: {LastName}</p>
</body>
</html>";
// Create a new PDF document
var pdfDocument = new ChromePdfRenderer();
pdfDocument.RenderHtmlAsPdf(content).SaveAs("person.pdf");
}
private void LogError(string errorMessage)
{
Console.ForegroundColor = ConsoleColor.Red;
Console.WriteLine($"Error: {errorMessage}");
Console.ResetColor();
}
}
class Program
{
static void Main()
{
// Create an instance of the Person class
Person person = new Person();
// Attempt to display the full name
person.DisplayFullName();
// Set the properties
person.FirstName = "John";
person.LastName = "Doe";
// Display the full name again
person.DisplayFullName();
// Generate a PDF
person.PrintPdf();
}
}Namespace OrderBy
Friend Class Person
Public Property FirstName() As String
Public Property LastName() As String
Public Sub DisplayFullName()
If String.IsNullOrEmpty(FirstName) OrElse String.IsNullOrEmpty(LastName) Then
LogError($"Invalid name: {NameOf(FirstName)} or {NameOf(LastName)} is missing.")
Else
Console.WriteLine($"Full Name: {FirstName} {LastName}")
End If
End Sub
Public Sub PrintPdf()
Console.WriteLine("Generating PDF using IronPDF.")
Dim content As String = $"<!DOCTYPE html>
<html>
<body>
<h1>Hello, {FirstName}!</h1>
<p>First Name: {FirstName}</p>
<p>Last Name: {LastName}</p>
</body>
</html>"
ignore ignore ignore ignore ignore ignore ignore var pdfDocument = New ChromePdfRenderer()
pdfDocument.RenderHtmlAsPdf(content).SaveAs("person.pdf")
End Sub
Private Sub LogError(ByVal errorMessage As String)
Console.ForegroundColor = ConsoleColor.Red
Console.WriteLine($"Error: {errorMessage}")
Console.ResetColor()
End Sub
End Class
Friend Class Program
Shared Sub Main()
' Create an instance of the Person class
Dim person As New Person()
' Attempt to display the full name
person.DisplayFullName()
' Set the properties
person.FirstName = "John"
person.LastName = "Doe"
' Display the full name again
person.DisplayFullName()
' Generate a PDF
person.PrintPdf()
End Sub
End Class
End NamespaceBurada IronPDF, yerel değişkenler content ve pdfDocument kullanılarak bir PDF oluşturmak için kullanılır, bu PrintPdf yönteminde görülebilir.
Çıktı
PDF Oluşturma
Lisanslama için Deneme Lisansı Bilgileri'ne bakınız. Bu anahtar appsettings.json içine yerleştirilmesi gereklidir.
"IronPdf.LicenseKey": "your license key"Deneme lisansı almak için e-posta adresinizi sağlayın.
C#'daki 'nameof' operatörü, daha temiz, daha güvenli ve daha sürdürülebilir kod arayan geliştiriciler için bir dayanak haline gelmiştir. Kod okunabilirliğini artırma yeteneği, derleme zamanı güvenliği ve sorunsuz yeniden adlandırma desteği ile birleştiğinde, C# geliştiricisinin araç kitinde vazgeçilmez bir araç haline gelir. Geliştirme topluluğu 'nameof' operatörünü kucaklamaya ve kullanmaya devam ettikçe, C# programlamasının geleceğini şekillendirmede önemli bir rol oynamaya hazırlanıyor. IronPDF, PDF'leri hızlı ve kolay bir şekilde oluşturmak için kullanılabilen kullanışlı bir NuGet Paketidir.
Jacob Mellor, Iron Software'de Baş Teknoloji Yöneticisidir ve C# PDF teknolojisinde öncü bir mühendisdir. Iron Software'ın ana kod tabanının ilk geliştiricisi olarak, CEO Cameron Rimington ile birlikte şirketin ürün mimarisini 50'den fazla kişilik bir şirkete dönüştürmüştür ve NASA, Tesla ve dünya genelindeki devlet kurumlarına hizmet etmektedir.
IronPDF, IRONSUITE'in bir parçasıdır
Ofis belgeleriniz için 10 .NET API ürünü
PDF'nizin HTML gibi görünmesine ihtiyaç duyduğunuzda, hızlı.
