Adlandırma Uyarıları
Uyarıları destek bağlılığın adlandırma kurallarına adlandırma .NET Framework tasarım yönergeleri.
Bu Bölümde
Kural |
Tanımlama |
---|---|
CA1700: Numaralandırma değerlerini 'Ayrılmış' olarak adlandırmayın |
Bu kural, "ayrılmış" içeren bir ada sahip bir numaralandırma üyesi şu anda kullanılmamaktadır ancak yeniden adlandırılabilir veya gelecekteki bir sürümüne kaldırıldığını varsayar.Üye kaldırma veya yeniden adlandırma bölünmesi farklıdır. |
Olay adı "Önce" veya "Sonra" ile başlar.Belirli bir sırayla ilgili olayları adlandırmak için yoksa veya geçmiş zamanın göreceli konumunu sıralı eylemleri belirtmek için kullanın. |
|
Ortak bir numaralandýrma System.FlagsAttribute özniteliğine sahip ve adı "s" bitmez.Bileşik FlagsAttribute ile işaretlenmiş türleri özniteliği birden fazla değer belirtilebilir gösterir çünkü çoğul adları vardır. |
|
Microsoft Yazım kitaplığı tarafından tanınmayan bir veya birkaç sözcük dışarıdan görünen bir tanımlayıcı adını içerir. |
|
Ortak dil çalışma zamanı hedef dilleri büyük küçük harf duyarlı olması gerekli değildir çünkü ad alanları, türleri, üyeler ve parametreler için tanımlayıcıları yalnızca harf farklı olamaz. |
|
Dışarıdan görünür bir arabirimin adını bir büyük "ı" başlatılmaz. Genel tür parametresi dışarıdan görünen türü veya yöntem adı büyük "T" ile başlamıyor. |
|
parametre adı açıkça görünür üye, veri tipi adını içerir, ya da açıkça görünen üyenin adı dil özellikli veri tipi adı içerir. |
|
Kural gereği, programlama elementlerinin belirli bir önek ile başlayan adları vardır. |
|
Kural gereği, yalnızca, belirli temel türleri genişletmek veya, bazı arabirimler ya da bu türlerinden türetilmiş tür uygulamak, tür adlarının belirli ayrılmış öneklerle bitmelidir.Diğer tür adları aşağıdaki ayrılmış soneklerini kullanmamalı. |
|
CA1717: Yalnızca FlagsAttribute numaralandırmalarında çoğul adlar olmalıdır |
Adlandırma kuralları numaralandırma için adlandırma aynı anda birden fazla numaralandırma değeri olduğunu gösterir. |
Parametreyi geçersiz kılma hiyerarşisinde tutarlı adlandırma yöntemini geçersiz kılmaları kullanılabilirliği artırır.Temel bildirim alanındaki addan farklı bir türetilmiş yöntem parametre adı taban yöntemin geçersiz kılma veya yeni aşırı yönteminin yöntem olup olmadığı hakkında karışıklığa neden olabilir. |
|
Parametre adını parametre anlamını iletişim kurmak ve üyenin adını üye anlamını iletişim kurmalıdır.Bunların aynı olduğu yerlerde nadir bir tasarım olur.Aynı üye adıyla parametreyi adlandırma sezgisel değildir ve kütüphane kullanımını zorlaştırır. |
|
CA1701: Kaynak dize bileşik sözcüklerinin küçük/büyük harfleri doğru yazılmalıdır |
Kaynak dizedeki her sözcük durumlandırmaya dayanan bütün işaretlerin içinde bölünür.Her bir bitişik ikili-işaret kombinasyonu Microsoft yazım kitaplığı tarafından denetlenir.Tanınırsa, kelime kural ihlali üretir. |
Kaynak dizesi, Microsoft Yazım kitaplığı tarafından tanınmayan bir veya birkaç sözcük içerir. |
|
Bu .NET Framework sınıf kütüphanesi içindeki tür adları içinde tanımlı ad alanlarının adlarıyla eşleşmiyor.Bu kuralı ihlal kitaplığı kullanılabilirliğini azaltabilir. |
|
Kural gereği, tanımlayıcı adlar alt çizgi (_) karakterini içermez.Bu kural; ad alanlarını, türlerini, üyelerini ve parametrelerini denetler. |
|
Ortak veya korumalı bir üye adı "Get" ile başlar, ve aksi durumda ortak veya korumalı özellik adıyla eşleşir. "Get" yöntemleri ve özellikleri, işlevleri açıkça ayırt adları olması gerekir. |
|
Ad alanı adı veya tür adı ayrılmış bir anahtar sözcük bir programlama dili ile eşleşir.Tanımlayıcı adı ve türleri için ortak dil çalışma zamanı, hedef diller tarafından tanımlanan anahtar sözcüklerle aynı değildir. |
|
Dışarıdan görünen bir tanımlayıcının adı, tercih edilen terim varolduğunda alternatif olarak bir terim içerir.Alternatif olarak ad, "Bayrak" veya "Bayraklar" terimini içerir. |
|
CA1709: Tanımlayıcıların büyük/küçük harfleri doğru yazılmalıdır |
Kuralı olarak, parametre adları camel casing ve ad, tür ve üye adlarını Pascal Kasa. |
CA1702: Bileşik sözcüklerin küçük/büyük harfleri doğru yazılmalıdır |
Tanımlayıcının adı birden çok sözcük içerir, ve bu sözcüklerden en az biri büyük harf kullanımı hatasına maruz kalmış birleşik kelime olarak görülür. |
CA1712: Numaralandırma değerleri için tür adıyla önek kullanmayın |
Tür bilgilerini geliştirme araçları tarafından sağlanan beklendiğinden numaralama üyelerinin adlarını tür adıyla öneki değil. |
Kural gereği, belli uzatılan tiplerin isimleri ya da belli arayüzlerin uygulanması, ya da bu tiplerden türetilen türler, basit tip ya da arayüzden oluşturulan son eke sahiptir. |