Aracılığıyla paylaş

Büyük Harfe Çevirme Kuralları

Uyarı

Bu içerik, Çerçeve Tasarım Yönergeleri: Kurallar, Deyimler ve Yeniden Kullanılabilir .NET Kitaplıkları için Desenler, 2. Sürüm'den Pearson Education, Inc.'in izniyle yeniden yazdırılır. Bu baskı 2008'de yayımlandı ve kitap o zamandan beri üçüncü baskıda tamamen revize edilmiştir. Bu sayfadaki bazı bilgiler güncel olmayabilir.

Bu bölümdeki yönergelerde, tutarlı bir şekilde uygulandığında türlerin, üyelerin ve parametrelerin tanımlayıcılarının okunmasını kolaylaştıran basit bir kullanım yöntemi yer alır.

Tanımlayıcılar için Büyük Harfe Çevirme Kuralları

Tanımlayıcıdaki sözcükleri ayırt etmek için, tanımlayıcıdaki her sözcüğün ilk harfini büyük harfle yazın. Sözcükleri ayırt etmek için veya tanımlayıcıların herhangi bir yerinde alt çizgi kullanmayın. Tanımlayıcının kullanımına bağlı olarak tanımlayıcıları büyük harfe çevirmenin iki uygun yolu vardır:

  • PascalCasing

  • camelCasing

Parametre adları dışındaki tüm tanımlayıcılar için kullanılan PascalCasing kuralı, aşağıdaki örneklerde gösterildiği gibi her sözcüğün ilk karakterini (iki harf uzunluğunda kısaltmalar dahil) büyük harfe çevirir:

PropertyDescriptor HtmlTag

Aşağıdaki tanımlayıcıda gösterildiği gibi, her iki harfin de büyük harfle yazıldığı iki harfli kısaltmalar için özel bir durum oluşturulur:

IOStream

Aşağıdaki örneklerde gösterildiği gibi, yalnızca parametre adları için kullanılan camelCasing kuralı, ilk sözcük dışında her sözcüğün ilk karakterini büyük harfe çevirir. Örnekte de gösterildiği gibi, deve başlı tanımlayıcıyı başlatan iki harfli kısaltmalar küçük harflerle yazılır.

propertyDescriptor ioStream htmlTag

✔️ DO, birden çok sözcük içeren tüm genel üye, tür ve ad alanı adları için PascalCasing kullanır.

✔️ DO parametre isimleri için camelCasing kullanın.

Aşağıdaki tabloda farklı tanımlayıcı türleri için büyük harf kullanımı kuralları açıklanmaktadır.

Tanımlayıcı Büyük/Küçük Harf Kullanımı Örnek
Namespace Pascal namespace System.Security { ... }
Türü Pascal public class StreamReader { ... }
Arayüz Pascal public interface IEnumerable { ... }
Yöntem Pascal public class Object {
public virtual string ToString();
}
Mülkiyet Pascal public class String {
public int Length { get; }
}
Etkinlik Pascal public class Process {
public event EventHandler Exited;
}
Alan Pascal public class MessageQueue {
public static readonly TimeSpan
InfiniteTimeout;
}
public struct UInt32 {
public const Min = 0;
}
Enum değeri Pascal public enum FileMode {
Append,
...
}
Parametre Deve public class Convert {
public static int ToInt32(string value);
}

Bileşik Sözcükleri ve Ortak Terimleri Büyük Harfe Çevirme

Çoğu bileşik terim, büyük harfe çevirme amacıyla tek sözcük olarak kabul edilir.

❌ Her sözcüğü kapalı biçimli bileşik sözcüklerle büyük harfe ÇEVIRMEYİn.

Bunlar, uç nokta gibi tek bir sözcük olarak yazılmış bileşik sözcüklerdir. Büyük/küçük harf kılavuzlarına göre, kapalı biçimli bileşik kelimeleri tek bir kelime olarak ele alın. Bileşik sözcüğün kapalı biçimde yazıp yazılmadığını belirlemek için geçerli bir sözlük kullanın.

Pascal Deve Değil
BitFlag bitFlag Bitflag
Callback callback CallBack
Canceled canceled Cancelled
DoNot doNot Don't
Email email EMail
Endpoint endpoint EndPoint
FileName fileName Filename
Gridline gridline GridLine
Hashtable hashtable HashTable
Id id ID
Indexes indexes Indices
LogOff logOff LogOut
LogOn logOn LogIn
Metadata metadata MetaData, metaData
Multipanel multipanel MultiPanel
Multiview multiview MultiView
Namespace namespace NameSpace
Ok ok OK
Pi pi PI
Placeholder placeholder PlaceHolder
SignIn signIn SignOn
SignOut signOut SignOff
UserName userName Username
WhiteSpace whiteSpace Whitespace
Writable writable Writeable

Büyük/Küçük Harf Duyarlılığı

CLR üzerinde çalışabilen dillerin büyük/küçük harf duyarlılığını desteklemesi gerekmez, ancak bazıları destekler. Diliniz bunu desteklese bile, çerçevenize erişebilecek diğer diller desteklemez. Bu nedenle dışarıdan erişilebilen API'ler, aynı bağlamdaki iki adı ayırt etmek için yalnızca büyük/küçük harfe güvenemez.

❌ Tüm programlama dillerinin büyük/küçük harfe duyarlı olduğunu VARSAYMAYIN. Onlar değil. Adlar yalnızca büyük/küçük harfe göre farklılık gösteremez.

Porsiyonlar © 2005, 2009 Microsoft Corporation. Tüm hakları saklıdır.

Pearson Education, Inc. tarafından Krzysztof Cwalina ve Brad Abrams'ın Yeniden Kullanılabilir .NET Kütüphaneleri için Çerçeve Tasarım Yönergeleri: Sözleşmeler, Deyimler ve Kalıplar, 2. Baskı eserinden izniyle yeniden basılmıştır. Addison-Wesley Professional tarafından Microsoft Windows Geliştirme Serisi kapsamında 22 Ekim 2008'de yayımlanmıştır.

Ayrıca bakınız

  • Last updated on