Büyük/Küçük Harf Kuralları
Not
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 veya bu nedenle 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 harfli tanımlayıcıyı başlatan iki harfli kısaltmaların ikisi de küçük harftir.
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 parametresi adları 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 |
|---|---|---|
| Ad Alanı | Pascal | namespace System.Security { ... } |
| Tür | Pascal | public class StreamReader { ... } |
| Arabirim | Pascal | public interface IEnumerable { ... } |
| Metot | Pascal | public class Object { public virtual string ToString(); } |
| Özellik | 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; } |
| Numaralandırma değeri | Pascal | public enum FileMode { Append, ... } |
| Parametre | Ortası büyük harf | 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ı için, kapalı biçimli bileşik sözcüğü tek bir sözcük olarak kabul edin. 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 | Ortası büyük harf | Not |
|---|---|---|
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 tek başına büyük/küçük harfe dayanamaz.
❌ Tüm programlama dillerinin büyük/küçük harfe duyarlı olduğunu VARSAYMAYIN. Durum bu değildir. 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. in Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraryes, 2nd Edition by Krzysztof Cwalina and Brad Abrams izniyle yeniden yazdırıldı ve 22 Ekim 2008'de Addison-Wesley Professional tarafından Microsoft Windows Geliştirme Serisi'nin bir parçası olarak yayımlandı.