Aracılığıyla paylaş

Kod stili kurallar

.NET kod stili analizi, kod tabanınızda tutarlı stili korumayı hedefleyen kurallar sağlar. Bu kuralların kural kimliğinde bir "IDE" ön eki vardır.

Kod stili kuralları aşağıdaki alt kategorilere ayrılır:

  • Dil ve gereksiz kod kuralları

    C# veya Visual Basic diliyle ilgili kurallar. Örneğin, değişkenleri tanımlarken var kullanımını veya ifade gövdeli üyelerin tercih edilip edilmediğini belirten kurallar tanımlayabilirsiniz. Bu kategoride, yöntemler veya kullanılmayan özel alanlar, özellikler veya yöntemler içinde erişilemeyen kod gibi gereksiz kodu bulan kurallar da bulunur.

  • Biçimlendirme kuralları

    Okunmasını kolaylaştırmak için kodunuzun düzeni ve yapısıyla ilgili kurallar. Örneğin, denetim bloklarındaki boşlukların tercih edilip edilmediğini tanımlayan bir biçimlendirme seçeneği belirtebilirsiniz.

  • Adlandırma kuralları

    Kod öğelerinin adlandırılmasıyla ilgili kurallar. Örneğin, yöntem adlarının async "Async" son ekine sahip olması gerektiğini belirtebilirsiniz.

  • Çeşitli kurallar

    Diğer kategorilere ait olmayan kurallar.

Dizin

Aşağıdaki tabloda, varsa kimlik ve seçeneklere göre tüm kod stili kuralları listelenmiştir.

Kural Kimliği Başlık Seçenek
IDE0001 Adı basitleştirme
IDE0002 Üye erişimini basitleştirme
IDE0003 Kaldır this veya Me nitelemeyi dotnet_style_qualification_for_field
dotnet_stili_özellik_için_yeterlik
dotnet_style_qualification_for_method
dotnet_style_qualification_for_event
IDE0004 Gereksiz dönüştürmeyi kaldır
IDE0005 Gereksiz importu kaldır
IDE0007 Açık tür yerine kullan var yerleşik_türler_için_csharp_stili_var
csharp_stili_tür_belirgin_olduğunda_var_kullanımı
csharp_style_var_elsewhere
IDE0008 Açık türü var yerine kullanın yerleşik_türler_için_csharp_stili_var
csharp_stili_tür_belirgin_olduğunda_var_kullanımı
csharp_style_var_elsewhere
IDE0009 this veya Me niteliğini ekle dotnet_style_qualification_for_field
dotnet_stili_özellik_için_yeterlik
dotnet_style_qualification_for_method
dotnet_style_qualification_for_event
IDE0010 Switch ifadesine eksik durumları ekleyin
IDE0011 Ayraç ekleme csharp_tercih_ayraç_kullanımı
IDE0016 Throw ifadesini kullan csharp_style_throw_expression
IDE0017 Nesne başlatıcıları kullanma dotnet_style_object_initializer
IDE0018 Satır içi değişken bildirimi csharp_stili_satır_içi_değişken_bildirimi
IDE0019 as ifadesinin ardından null denetimi gelmesinden kaçınmak için desen eşleştirmeyi kullanın csharp_stil_kalıp_eşleşme_as_üzerinden_null_kontrolü
IDE0020 is kontrolün ardından bir dönüştürme (değişkenli) olmasını önlemek için desen eşleştirmeyi kullanın csharp_style_pattern_matching_over_is_with_cast_check (C# stilinde, tür kontrolü yaparken desen eşleştirme tercih edilir)
IDE0021 Oluşturucular için ifade gövdesini kullan csharp_style_expression_bodied_constructors (csharp_stili_ifade_gövdesine_sahip_yapıcılar)
IDE0022 Yöntemler için ifade gövdesi kullanın C# ifadeli gövdeli yöntemler tarzı
IDE0023 Dönüştürme işleçleri için ifade gövdesini kullanma csharp_dil_ifadeli_gövde_operatorleri
IDE0024 İşleçler için ifade gövdesini kullan csharp_dil_ifadeli_gövde_operatorleri
IDE0025 Özellikler için ifade gövdesini kullanma csharp_stil_ifade_gövdesi_özellikleri
IDE0026 Dizin oluşturucular için ifade gövdesini kullanma csharp_stil_exp_dizini (C# ifadeyle gövdelendirilmiş dizinleyici stili)
IDE0027 Erişimciler için ifade gövdesini kullanın csharp_stili_ifade_gövde_erişicileri
IDE0028 Koleksiyon başlatıcılarını kullanma dotnet_style_collection_initializer
dotnet_style_prefer_collection_expression ayarı, koleksiyon ifadelerini tercih etmenizi sağlar.
IDE0029 Null kontrolü basitleştirilebilir dotnet_style_coalesce_expression
IDE0030 Null kontrolü basitleştirilebilir dotnet_style_coalesce_expression
IDE0031 Null yayılımını kullan dotnet_style_null_propagation (dotnet tarzı null yayılımı)
IDE0032 Otomatik özelliği kullanma dotnet_style_prefer_auto_properties
IDE0033 Açıkça belirtilen tanımlama grubu adını kullan dotnet_style_explicit_tuple_names
IDE0034 İfadeyi basitleştirme default csharp_basit_varsayılan_ifade_tercih_et
IDE0035 Erişilemeyen kodları kaldırma
IDE0036 Sipariş değiştiricileri C# tercih edilen değiştirici sırası (csharp_preferred_modifier_order)
Visual Basic tercih edilen değiştirici sırası
IDE0037 Çıkarsanan üye adını kullanma dotnet_style_prefer_inferred_tuple_names
dotnet_style_prefer_inferred_anonymous_type_member_names
IDE0038 is kontrolünü takip eden bir biçim dönüşümünden (değişken olmadan) kaçınmak için desen eşleştirmeyi kullanın. csharp_style_pattern_matching_over_is_with_cast_check (C# stilinde, tür kontrolü yaparken desen eşleştirme tercih edilir)
IDE0039 Lambda yerine yerel işlevi kullanma yerel_değişkeni_anonim_fonksiyona_tercih_etme_stili_csharp
IDE0040 Erişilebilirlik değiştiricileri ekleme dotnet_style_require_accessibility_modifiers (erişilebilirlik değiştiricilerini zorunlu kılma stili)
IDE0041 Null kontrolü yapın dotnet_style_prefer_is_null_check_over_reference_equality_method
IDE0042 Değişken bildirimini çözümleme csharp_stili_parçalanmış_değişken_beyanı
IDE0044 Salt-okunur değiştirici ekle dotnet_style_readonly_field
IDE0045 Atama için koşullu ifade kullanma dotnet_stili_atama_üzerindeki_koşullu_ifadenin_tercih_edilmesi
IDE0046 Dönüş için koşullu ifade kullanma dotnet_style_prefer_conditional_expression_over_return (Koşullu ifadeyi dönüşten önce tercih etme stili)
IDE0047 Gereksiz parantezleri kaldırma aritmetik ikili işleçlerde parantezlerin dotnet tarzı
dotnet_style_parentheses_in_relational_binary_operators (ilişkisel ikili operatörlerde parantez kullanımı stili)
If an improved translation is indeed required, it might look something like this: "Diğer Binary Operatörlerde Dotnet Tarzı Parantezler (dotnet_style_parentheses_in_other_binary_operators)".
dotnet_style_parentheses_in_other_operators
IDE0048 Netlik için parantez ekleme aritmetik ikili işleçlerde parantezlerin dotnet tarzı
dotnet_style_parentheses_in_relational_binary_operators (ilişkisel ikili operatörlerde parantez kullanımı stili)
If an improved translation is indeed required, it might look something like this: "Diğer Binary Operatörlerde Dotnet Tarzı Parantezler (dotnet_style_parentheses_in_other_binary_operators)".
dotnet_style_parentheses_in_other_operators
IDE0049 Tür başvuruları için çerçeve türü adları yerine dil anahtar sözcükleri kullanma dotnet_style_predefined_type_for_locals_parameters_members
dotnet_stili_ön_tanımlı_türü_üye_erişimi_için
IDE0050 Anonim türü demete dönüştürme
IDE0051 Kullanılmayan özel üyeyi kaldırma
IDE0052 Okunmamış özel üyeyi kaldırma
IDE0053 Lambdalar için ifade gövdesi kullanın C# tarzı ifade gövdeli lambda ifadeleri
IDE0054 Bileşik atamayı kullan dotnet_style_prefer_compound_assignment
IDE0055 Biçimlendirmeyi düzeltme (Burada listelenemeyecek kadar çok. Bkz. .NET biçimlendirme seçenekleri ve C# biçimlendirme seçenekleri.)
IDE0056 Dizin işlecini kullanma csharp_stili_tercih_indeks_işleci
IDE0057 Aralık işlecini kullan csharp_stili_tercih_aralık_operatörü
IDE0058 Kullanılmayan ifade değerini kaldırma csharp_style_unused_value_expression_statement_preference (C# kullanılmayan değer ifade deyimi tercihi)
visual_basic_style_unused_value_expression_statement_preference
IDE0059 Gereksiz değer atamasını kaldırma csharp_stili_kullanılmayan_değer_atama_tercihi
görsel_temel_stili_kullanılmayan_değer_atama_tercihi
IDE0060 Kullanılmayan parametreyi kaldırma dotnet_kod_kalitesi_kullanılmayan_parametreler
IDE0061 Yerel işlevler için ifade gövdesini kullanma csharp_stil_ifade_gövdelik_yerel_fonksiyonlar
IDE0062 Yerel işlev yap static csharp_prefer_static_local_function (C# statik yerel fonksiyonları tercih et)
IDE0063 Basit using deyimini kullanma C# basit using deyimi tercih et
IDE0064 Yapı alanlarını yazılabilir hale getirme
IDE0065 using yönergenin yerleştirilmesi csharp_using_directive_placement
IDE0066 Switch ifadesini kullanma csharp_style_prefer_switch_expression (C# dilinde 'switch' ifadesi tercih edilir)
IDE0070 System.HashCode.Combine komutunu kullanma
IDE0071 İlişkilendirmeyi basitleştirme dotnet_style_prefer_simplified_interpolation
IDE0072 İfadee eksik durumları ekleyin
IDE0073 Dosya üst bilgisini kullanma file_header_template
IDE0074 Koalesans bileşik atamasını kullanın dotnet_style_prefer_compound_assignment
IDE0075 Koşullu ifadeyi basitleştirme dotnet_style_prefer_simplified_boolean_expressions
IDE0076 Geçersiz küresel SuppressMessageAttribute öğesini kaldır
IDE0077 Küresel SuppressMessageAttribute içinde eski format hedeflerinden kaçının
IDE0078 Desen eşleştirme kullanma csharp_stili_desen_eşleştirmeyi_tercih_eder
IDE0079 Gereksiz bastırmayı kaldır dotnet_gereksiz_baskılamaları_kaldırma_dışlamaları
IDE0080 Gereksiz gizleme işlecini kaldırma
IDE0081 ByVal öğesini kaldır
IDE0082 Dönüştür typeof'dan nameof'e
IDE0083 Desen eşleştirmeyi kullan (not işleç) csharp_tarzi_tercih_etme_degillerin_deseni
IDE0084 Desen eşleştirmeyi kullan (IsNot işleç) Visual Basic stili "isnot" ifadesini tercih et
IDE0090 İfadeyi basitleştirme new türün_belli_olduğu_durumlarda_csharp_stili_belirsiz_nesne_oluşturma
IDE0100 Gereksiz eşitlik işlecini kaldır
IDE0110 Gereksiz atığı kaldır
IDE0120 LINQ ifadesini basitleştirme
IDE0121 LINQ türü denetimini ve atamayı basitleştirme
IDE0130 Ad alanı klasör yapısıyla eşleşmiyor dotnet_style_namespace_match_folder ayarı, namespace'in dosya yapısıyla eşleşmesini sağlar.
IDE0140 Nesne oluşturmayı basitleştirme visual_basic_stili_basitlestirilmis_nesne_olusturmayi_tercih_eder
IDE0150 Tür kontrolü yerine null kontrolünü tercih edin csharp_style_prefer_null_check_over_type_check
IDE0160 Blok kapsamına sahip ad alanı kullanma csharp_stili_ad_alanı_beyannameleri
IDE0161 Dosya kapsamlı ad alanı kullanın csharp_stili_ad_alanı_beyannameleri
IDE0170 Özellik düzenini basitleştirme csharp_style_prefer_extended_property_pattern
IDE0180 Değerleri değiştirmek için demet kullan csharp_stili_tercih_edilen_tuple_değişimi
IDE0200 Gereksiz lambda ifadesini kaldırma csharp_stili_metot_grubu_dönüşümünü_tercih_et
IDE0210 Üst düzey ifadelere dönüştürme csharp_style_prefer_top_level_statements ayarları
IDE0211 'Program.Main' tarzında bir programa dönüştür csharp_style_prefer_top_level_statements (C# stili - üst düzey ifadeleri tercih et)
IDE0220 foreach döngüsünde açık atama ekleme dotnet_style_prefer_foreach_explicit_cast_in_source
IDE0230 UTF-8 dize değişmez değeri kullanın csharp_stil_utf8_dizgi_değerlerini_tercih_et
IDE0240 Null olunabilir yönergesi gereksiz
IDE0241 Null atanabilir yönergeye gerek yok
IDE0250 Yapı 'yalnızca okunabilir' yapılabilir csharp_style_prefer_readonly_struct
IDE0251 Üye 'salt okunur' olarak ayarlanabilir csharp_style_prefer_readonly_struct_member
IDE0260 Desen eşleştirme kullanma csharp_stil_kalıp_eşleşme_as_üzerinden_null_kontrolü
IDE0270 Null kontrolü basitleştirilebilir dotnet_style_coalesce_expression
IDE0280 nameof komutunu kullanma
IDE0290 Birincil oluşturucuyu kullanma csharp_style_prefer_primary_constructors
IDE0300 Dizi için koleksiyon ifadesini kullanma dotnet_style_prefer_collection_expression ayarı, koleksiyon ifadelerini tercih etmenizi sağlar.
IDE0301 Boş öğeler için koleksiyon ifadesi kullanın dotnet_style_prefer_collection_expression ayarı, koleksiyon ifadelerini tercih etmenizi sağlar.
IDE0302 Stackalloc için koleksiyon ifadesini kullanma dotnet_style_prefer_collection_expression ayarı, koleksiyon ifadelerini tercih etmenizi sağlar.
IDE0303 Create() için koleksiyon ifadesini kullanın dotnet_style_prefer_collection_expression ayarı, koleksiyon ifadelerini tercih etmenizi sağlar.
IDE0304 Oluşturucu için koleksiyon ifadesi kullanma dotnet_style_prefer_collection_expression ayarı, koleksiyon ifadelerini tercih etmenizi sağlar.
IDE0305 Akıcı bir şekilde koleksiyon ifadesi kullanma dotnet_style_prefer_collection_expression ayarı, koleksiyon ifadelerini tercih etmenizi sağlar.
IDE0306 Yeni bir nesne oluşturmak için koleksiyon ifadesini kullanın dotnet_style_prefer_collection_expression ayarı, koleksiyon ifadelerini tercih etmenizi sağlar.
IDE0320 Anonim işlev yapma static csharp_prefer_static_anonymous_function
IDE0330 'System.Threading.Lock' tercih edin csharp_prefer_system_threading_lock
IDE0340 İlişkisiz genel tür kullanma csharp_stili_ismi_için_sınırsız_genel_türü_tercih_et
IDE0350 Örtük olarak yazılan lambda kullanın csharp_style_prefer_implicitly_typed_lambda_expression (C#'ta varsayılan olarak tanımlanan lambda ifadelerini tercih etme stili)
IDE1005 Koşullu temsilci çağrısını kullan. csharp_stili_koşullu_delege_çağrısı
IDE1006 Adlandırma stilleri
IDE3000 Copilot ile uygulama

Not

Yalnızca Visual Studio IDE'de görünen bazı kurallar vardır ve bunlar JSON ve normal ifade desen dizeleriyle ilgilidir. Daha fazla bilgi için bkz . JSON001, JSON002 ve RE0001.

Efsane

Aşağıdaki tabloda, başvuru belgelerindeki her kural için sağlanan bilgi türü gösterilmektedir.

Öğe Açıklama
Kural Kimliği Kuralın benzersiz tanımlayıcısı. Kural önem derecesini yapılandırmak ve kod dosyasındaki uyarıları engellemek için kullanılır.
Başlık Kuralın başlığı.
Kategori Kuralın kategorisi.
Alt kategori Dil kuralları, Biçimlendirme kuralları veya Adlandırma kuralları gibi kuralın alt kategorisi.
Geçerli diller Uygulanabilir .NET dilleri (C# veya Visual Basic) ve varsa en düşük dil sürümü.
Tanıtılan sürüm Kural ilk kez tanıtıldığında .NET SDK veya Visual Studio sürümü.
Seçenekler Kural için kullanılabilir seçenekler.

Ayrıca bkz.