C# Adlandırma Kuralları (Geliştiriciler İçin Nasıl Çalışır)

İsimlendirme Kurallarına Genel Bakış

public class Customer
{
    public decimal Balance { get; set; }
}

public interface ICustomer
{
    decimal GetBalance();
}

public class Customer
{
    public decimal Balance { get; set; }
}

public interface ICustomer
{
    decimal GetBalance();
}

Public Class Customer
	Public Property Balance() As Decimal
End Class

Public Interface ICustomer
	Function GetBalance() As Decimal
End Interface

public decimal CalculateInterest(decimal principal, decimal rate)
{
    return principal * rate;
}

public decimal CalculateInterest(decimal principal, decimal rate)
{
    return principal * rate;
}

Public Function CalculateInterest(ByVal principal As Decimal, ByVal rate As Decimal) As Decimal
	Return principal * rate
End Function

public DateTime DateOpened { get; set; }
public decimal Reserves { get; set; }

public DateTime DateOpened { get; set; }
public decimal Reserves { get; set; }

Public Property DateOpened() As DateTime
Public Property Reserves() As Decimal

Yerel Değişkenler ve Method Argümanları

Yerel değişkenler ve method argümanları camel case kullanmalıdır. Bu, ilk kelimenin küçük harfle başladığı ve sonraki kelimelerin büyük harfle başlayıp boşluk veya alt çizgi kullanmaksızın yapılması anlamına gelir. İlk harfin büyük harfle başlamadığı Pascal Case'den farklıdır.

public void SelectCustomer(string customerName)
{
    var selectedCustomer = FindCustomer(customerName);
}

public void SelectCustomer(string customerName)
{
    var selectedCustomer = FindCustomer(customerName);
}

Public Sub SelectCustomer(ByVal customerName As String)
	Dim selectedCustomer = FindCustomer(customerName)
End Sub

Bu örnekte, yerel değişken selectedCustomer camel case konvansiyonunu takip eder ve metod argümanı customerName da camel case'dir.

public void AddCustomer(string customerName, DateTime dateOpened)
{
    // Add customer logic
}

public void AddCustomer(string customerName, DateTime dateOpened)
{
    // Add customer logic
}

Public Sub AddCustomer(ByVal customerName As String, ByVal dateOpened As DateTime)
	' Add customer logic
End Sub

Statik Üyeler ve Alanlar

Sınıflardaki statik üyeler, statik alanlar, sabitler, ve methodlar, belirli isimlendirme kurallarını da izler.

private static int _totalCustomers;

private static int _totalCustomers;

Private Shared _totalCustomers As Integer

public const int MAX_CUSTOMERS = 100;

public const int MAX_CUSTOMERS = 100;

Public Const MAX_CUSTOMERS As Integer = 100

private void OnCustomerAdded(object sender, EventArgs e)
{
    // Event handling logic
}

private void OnCustomerAdded(object sender, EventArgs e)
{
    // Event handling logic
}

Private Sub OnCustomerAdded(ByVal sender As Object, ByVal e As EventArgs)
	' Event handling logic
End Sub

Özel Alanların ve Nesne Başlatıcılarının Adlandırılması

Özel alanlar camel case kuralını ancak bir alt çizgi öneki ile izlemelidir. Bu, onları yerel değişkenlerden ve method argümanlarından ayırmaya yardımcı olur.

private string _customerName;

private string _customerName;

Private _customerName As String

Nesne başlatıcılarını kullanırken, bir sınıfın örneği oluşturulurken özelliklere doğrudan değer atayabilirsiniz.

var seattleCustomer = new Customer
{
    Balance = 1000,
    DateOpened = DateTime.Now
};

var seattleCustomer = new Customer
{
    Balance = 1000,
    DateOpened = DateTime.Now
};

Dim seattleCustomer = New Customer With {
	.Balance = 1000,
	.DateOpened = DateTime.Now
}

Bu örnekte, özellik adları Balance ve DateOpened, özellikler için konvansiyon olan Pascal Case'dedir.

İstisna İşleme ve Metotlar

İstisnaları işlerken, metot adları yine Pascal Kasa sözleşmelerine uymalıdır. İstisna sınıf adları da Pascal Kasa olmalı ve 'Exception' ekiyle bitmelidir. Örneğin:

public void ProcessTransaction()
{
    try
    {
        // Transaction logic
    }
    catch (InvalidOperationException ex)
    {
        // Handle exception
    }
}

public void ProcessTransaction()
{
    try
    {
        // Transaction logic
    }
    catch (InvalidOperationException ex)
    {
        // Handle exception
    }
}

Public Sub ProcessTransaction()
	Try
		' Transaction logic
	Catch ex As InvalidOperationException
		' Handle exception
	End Try
End Sub

public decimal CalculateTotalBalance()
{
    return _totalCustomers * balancePerCustomer;
}

public decimal CalculateTotalBalance()
{
    return _totalCustomers * balancePerCustomer;
}

Public Function CalculateTotalBalance() As Decimal
	Return _totalCustomers * balancePerCustomer
End Function

C# Sabitleri için İsimlendirme Kuralları

C#'da sabit adları tümüyle büyük harflerle yazılmalı ve kelimeler alt çizgi ile ayrılmalıdır. Bu, sabitlerin diğer değişkenlerden farklı olmasını sağlar. İşte bir örnek:

public const double PI = 3.14159;

public const double PI = 3.14159;

Public Const PI As Double = 3.14159

Bu kural, farklı türlerde sabit adlarının kodda tutarlılığı ve kolay tanınmasını sağlamak adına uygulanır.

C# Kodlama Kuralları: Satır Sonları ve Süslü Parantezler

C# ayrıca satır sonları ve süslü parantezler için kodlama kuralları vardır. C#'da, her açılış kümesi { ait olduğu ifadenin aynı satırında ve kapanış kümesi } ise yeni bir satırda, ilgili ifadeyle hizalı olmalıdır. İşte bir örnek:

public void AddCustomer(string customerName)
{
    if (!string.IsNullOrEmpty(customerName))
    {
        _customerName = customerName;
    }
}

public void AddCustomer(string customerName)
{
    if (!string.IsNullOrEmpty(customerName))
    {
        _customerName = customerName;
    }
}

Public Sub AddCustomer(ByVal customerName As String)
	If Not String.IsNullOrEmpty(customerName) Then
		_customerName = customerName
	End If
End Sub

Uygun formatlama, kodun okunmasını ve takip edilmesini kolaylaştırır.

Macar Notasyonundan Kaçınma

Modern C# geliştirmesinde, veri türleri ile ön eklenen değişken adlarına (örneğin, bir metin için strName veya bir tamsayı için intCount), Macar Notasyonu teşvik edilmez. Bunun yerine, değişkenin veri türü yerine amacını açıklayan anlamlı adlar kullanın:

public string CustomerName { get; set; }
public int OrderCount { get; set; }

public string CustomerName { get; set; }
public int OrderCount { get; set; }

Public Property CustomerName() As String
Public Property OrderCount() As Integer

Bu yaklaşım, kodun daha net ve sürdürülebilir olmasını sağlar.

IronPDF'i Adlandırma Kuralları ile Kullanma

IronPDF C# projelerinize entegre ederken, adlandırma kurallarını izleyerek temiz ve okunabilir kod sağlamak önemlidir. IronPDF, C# uygulamalarınızda HTML içeriğinden PDF'ler oluşturmanıza olanak tanır. Bunu yaparken, tutarlılığı sağlamak için sınıflar, metodlar ve değişkenler için adlandırma kurallarına uymak önemlidir. Aşağıda, IronPDF kullanarak kod okunabilirliğini artırmak için adlandırma kurallarını uygulayan basit bir uygulama örneği verilmiştir:

using IronPdf;

public class PdfReportGenerator
{
    private readonly string _htmlContent;
    private readonly string _filePath;

    public PdfReportGenerator(string htmlContent, string filePath)
    {
        _htmlContent = htmlContent;
        _filePath = filePath;
    }

    public void GenerateReport()
    {
        var pdfRenderer = new ChromePdfRenderer();
        PdfDocument pdfDocument = pdfRenderer.RenderHtmlAsPdf(_htmlContent);
        pdfDocument.SaveAs(_filePath);
    }
}

public static class Program
{
    public static void Main()
    {
        var htmlContent = "<h1>Monthly Report</h1><p>Generated using IronPDF.</p>";
        var filePath = @"C:\Reports\MonthlyReport.pdf";
        PdfReportGenerator reportGenerator = new PdfReportGenerator(htmlContent, filePath);
        reportGenerator.GenerateReport();
    }
}

using IronPdf;

public class PdfReportGenerator
{
    private readonly string _htmlContent;
    private readonly string _filePath;

    public PdfReportGenerator(string htmlContent, string filePath)
    {
        _htmlContent = htmlContent;
        _filePath = filePath;
    }

    public void GenerateReport()
    {
        var pdfRenderer = new ChromePdfRenderer();
        PdfDocument pdfDocument = pdfRenderer.RenderHtmlAsPdf(_htmlContent);
        pdfDocument.SaveAs(_filePath);
    }
}

public static class Program
{
    public static void Main()
    {
        var htmlContent = "<h1>Monthly Report</h1><p>Generated using IronPDF.</p>";
        var filePath = @"C:\Reports\MonthlyReport.pdf";
        PdfReportGenerator reportGenerator = new PdfReportGenerator(htmlContent, filePath);
        reportGenerator.GenerateReport();
    }
}

Imports IronPdf

Public Class PdfReportGenerator
	Private ReadOnly _htmlContent As String
	Private ReadOnly _filePath As String

	Public Sub New(ByVal htmlContent As String, ByVal filePath As String)
		_htmlContent = htmlContent
		_filePath = filePath
	End Sub

	Public Sub GenerateReport()
		Dim pdfRenderer = New ChromePdfRenderer()
		Dim pdfDocument As PdfDocument = pdfRenderer.RenderHtmlAsPdf(_htmlContent)
		pdfDocument.SaveAs(_filePath)
	End Sub
End Class

Public Module Program
	Public Sub Main()
		Dim htmlContent = "<h1>Monthly Report</h1><p>Generated using IronPDF.</p>"
		Dim filePath = "C:\Reports\MonthlyReport.pdf"
		Dim reportGenerator As New PdfReportGenerator(htmlContent, filePath)
		reportGenerator.GenerateReport()
	End Sub
End Module

Bu adlandırma kurallarına uyarak, raporları oluştururken IronPDF kullanarak kodunuz profesyonel, düzenli ve okunabilir kalır.

Sonuç

Bu C# adlandırma kurallarını izleyerek, kodunuzun temiz, okunabilir ve bakımı kolay olmasını sağlayabilirsiniz. İster sınıf adları için Pascal Kasa, ister yerel değişkenler için camel case, ister private alanlar için alt çizgi öneki kullanın, bu kurallar tutarlı bir kod tabanı oluşturmanıza yardımcı olur.

IronPDF ile çalışmanız için ücretsiz deneme ile tüm yeteneklerini keşfedebilirsiniz. Bu deneme, iş akışınıza ne kadar iyi entegre olduğunu test etmenizi ve doğrudan görmenizi sağlar. Bir sonraki adıma geçmeye hazır olduğunuzda, lisanslar sadece $999'den başlar.