CA1200: Ön ek ile cref etiketlerini kullanmaktan kaçının

Özellik	Değer
Kural Kimliği	CA1200
Başlık	cref etiketlerini ön ek ile kullanmaktan kaçının
Kategori	Dokümantasyon
Düzeltme bozucu ya da bozmayan olabilir	Kesintisiz
.NET 10'da varsayılan olarak etkin	Hayır
Geçerli diller	C# ve Visual Basic

Neden

XML belge açıklamasındaki cref etiketi bir ön ek kullanır.

Kural açıklaması

XML belge etiketindeki cref özniteliği "kod başvurusu" anlamına gelir. Etiketin iç metninin tür, yöntem veya özellik gibi bir kod öğesi olduğunu belirtir. Derleyicinin referansları doğrulamasını engellediği için cref etiketlerini ön eklerle kullanmaktan kaçının. Ayrıca, Visual Studio tümleşik geliştirme ortamının (IDE) yeniden düzenleme sırasında bu sembol başvurularını bulmasını ve güncelleştirmesini engeller. cref etiketlerindeki sembol adlarına başvurmak için ön ekleri olmadan tam söz dizimini kullanmanız önerilir.

İhlalleri düzeltme

Bu kuralın ihlalini düzeltmek için etiketinden cref ön eki kaldırın. Örneğin, aşağıdaki iki kod parçacığı kuralın ihlalini ve nasıl düzeltileceğini gösterir:

// Violates CA1200
/// <summary>
/// Type <see cref="T:C" /> contains method <see cref="F:C.F" />
/// </summary>
class C
{
    public void F() { }
}

// Does not violate CA1200
/// <summary>
/// Type <see cref="C" /> contains method <see cref="F" />
/// </summary>
class C
{
    public void F() { }
}

Uyarıların ne zaman bastırılması gerekiyor?

Başvurulan tür derleyici tarafından bulunamadığından kod başvurusunun bir ön ek kullanması gerekiyorsa bu uyarıyı gizlemeniz güvenlidir. Örneğin, bir kod başvurusu full framework'teki spesifik bir özelliğe atıfta bulunuyorsa, ancak dosya portable framework'te derleniyorsa, bu uyarıyı bastırabilirsiniz.

Uyarıyı gizleme

Yalnızca tek bir ihlali engellemek istiyorsanız, kuralı devre dışı bırakmak ve sonra yeniden etkinleştirmek için kaynak dosyanıza ön işlemci yönergeleri ekleyin.

#pragma warning disable CA1200
// The code that's violating the rule is on this line.
#pragma warning restore CA1200

Bir dosya, klasör veya projenin kuralını devre dışı bırakmak için, yapılandırma dosyasındaki önem derecesini noneolarak ayarlayın.

[*.{cs,vb}]
dotnet_diagnostic.CA1200.severity = none

Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.

Ayrıca bkz.

• Kodunuzu XML açıklamalarıyla belgeleme