C# Syntax
Esenlikler dilerim, bu yazıda sizlere C# dilinin Syntax kuralları verilmiştir.
C# basit, modern, nesne yönelimli, tip korumalı ve C ile C++ dillerinden türetilmiş bir dildir. Yapısal olarak Java dili ile benzerlik göstermektedir. Kullanıcı dostu ve hızlı uygulama geliştirme aracı olduğu kabul edilir.
Kodlama Kuralları (Syntax) Neden Önemlidir?
Okuyucuların düzene değil içeriğe odaklanabilmesi için koda tutarlı bir görünüm oluşturur.
Okuyucuların önceki deneyime dayalı varsayımlarda bulunarak kodu daha hızlı anlamasını sağlar.
Kodu kopyalamayı, değiştirmeyi ve korumayı kolaylaştırır.
Adlandırma Kuralları
C# kodu yazarken dikkat edilmesi gereken birkaç adlandırma kuralı vardır. Bunlar;
PascalCasing
Record, Struct ve Class adlandırması yaparken PascalCasing kullanılır.
public class DataService
{
}
public record PhysicalAddress(
string Street,
string City,
string StateOrProvince,
string ZipCode);
public struct ValueCoordinate
{
}
Bir interface öğesi adlandırılırken, adın başına I ön eki eklenmesi ve ek olarak PascalCasing kullanılması gerekmektedir.
public interface IWorkerQueue
{
}
Local function, events, methods, properties ve type adlandırmalarında PascalCasing kullanılır.
public class ExampleEvents
{
// type
public bool IsValid;
// property
public IWorkerQueue WorkerQueue { get; init; }
// event
public event Action EventProcessing;
// Method
public void StartEventProcessing()
{
// Local function
static int CountQueueItems() => WorkerQueue.Count;
// …
}
}
camelCasing
Private ve internal alanlar için camelCasing ve ek olarak _ kullanılır.
public class DataService
{
private IWorkerQueue _workerQueue;
}
Method parametreleri adlandırılırken camelCasing kullanılır.
public T SomeMethod<T>(int someNumber, bool isValid)
{
}
Ek Adlandırma Kuralları
Bir namespace’in projede default olarak içeri aktarıldığını biliyorsanız, bu namespace’in adları tam olarak nitelemeniz gerekmez. Nitelenmiş adlar, aşağıdaki örnekte gösterildiği gibi tek bir satır için çok uzunsa nokta (.) sonrasında bozulabilir.
var currentPerformanceCounterCategory = new System.Diagnostics.
PerformanceCounterCategory();
Düzen Kuralları
Düzen kuralları kodun okunabilirliğini arttırmak adına büyük önem taşır. Gelişmiş Kod Editörlerinde düzen kurallarına uyabilmeniz için ekstra bir emek gerekmez. Kod editörleri içlerinde bulundurdukları özelliklerle düzen kurallarında dikkat etmeniz gerekenleri minimize eder.
Dikkat etmeniz gereken önemli husus tek bir satırda birden fazla koşul belirtmek isterseniz bunu parantezler ile ayırmanız gerektiğidir.
if ((val1 > val2) && (val1 > val3))
{
}
Yorum Oluşturma Kuralları
Yorum satıları kullanılırken açıklama yazdığınız kodun bulunduğu satıra değil, ayrı bir satıra yazılmalıdır.
Yorum cümleleri büyük harflerle başlamalıdır.
Yorum satırı “.” Ile sonlandırılmalıdır.
Yorum satırları “//” ya da “/* yorum */” şeklinde yazılmalıdır.
Dil Yönergeleri
Aşağıdaki kodda kısa metinleri birleştirmek için $ kullanımı örneği verilmiştir.
string displayName = $”{nameList[n].LastName}, {nameList[n].FirstName}”;
Aşağıdaki kodda değişken adlandırma örneği verilmiştir.
var var1 = “This is clearly a string.”;
var var2 = 27;
&& ve || Kullanım Kuralları
“&” ve anlamına “|” veya anlamına gelmektedir. Bu öğelerin kullanımı aşağıdaki örnekte verilmiştir.
if( (a = 5) && (b = 3)
{
}
else if ( (a=5 ) || (b=3)
{
}