CA1515: Genel türleri dahili hale getirebilirsiniz

Özellik	Değer
Kural Kimliği	CA1515
Başlık	Genel türleri dahili yapmayı göz önünde bulundurun
Kategori	Bakýmýný
Hataya neden olan veya bozulmayan düzeltme	Hataya neden olmayan
.NET 10'da varsayılan olarak etkin	Hayır
Geçerli diller	C# ve Visual Basic

Neden

Yürütülebilir derleme içindeki bir tür genel olarak bildirilir.

Kural açıklaması

Sınıf kitaplığının aksine, bir uygulamanın API'lerine genel olarak başvurulmuyor, bu nedenle türler işaretlenebilir internal.

İç türler de genel olmayan API'leri hedefleyen çeşitli kod çözümleyicilerinden yararlanabilir.

İhlalleri düzeltme

Türünü olarak internalişaretleyin.

Örnek

Aşağıdaki kod parçacığı CA1515 ihlalini gösterir:

// Inside a project with <OutputKind>Exe</OutputKind>.
public class Program
{
    public static void Main(string[] args)
    {
    }
}

' Inside a project with <OutputKind>Exe</OutputKind>.
Public Class Program
    Public Shared Sub Main(args As string())
    End Sub
End Class

Aşağıdaki kod parçacığı ihlali düzeltir:

// Inside a project with <OutputKind>Exe</OutputKind>.
internal class Program
{
    public static void Main(string[] args)
    {
    }
}

' Inside a project with <OutputKind>Exe</OutputKind>.
Friend Class Program
    Public Shared Sub Main(args As string())
    End Sub
End Class

(Projenin çıkış türü hakkında daha fazla bilgi için .NET Proje Tasarımcısı'nın "Çıkış türü" bölümüne bakın.)

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

Kodunuzun sürdürülebilirliği konusunda endişeleriniz yoksa bu kuralın ihlalini gizlemeniz güvenlidir.

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 CA1515
// The code that's violating the rule is on this line.
#pragma warning restore CA1515

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.CA1515.severity = none

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

Analiz için kodu yapılandırın

Bu kuralın uygulanacağı çıkış derleme türlerini yapılandırabilirsiniz. Örneğin, bu kuralı yalnızca konsol uygulaması veya dinamik olarak bağlı bir kitaplık (ui uygulaması değil) oluşturan koda uygulamak için projenizdeki bir .editorconfig dosyasına aşağıdaki anahtar-değer çiftini ekleyin:

dotnet_code_quality.CA1515.output_kind = ConsoleApplication, DynamicallyLinkedLibrary

Daha fazla bilgi için bkz. output_kind.