CA1050: Ad alanlarında türleri bildirin

Özellik	Değer
Kural Kimliği	CA1050
Başlık	Ad alanlarında türler bildirin
Kategori	Tasarım
Hataya neden olan veya bozulmayan düzeltme	Yeni
.NET 8'de varsayılan olarak etkin	Öneri olarak

Neden

Ortak veya korumalı bir tür, adlandırılmış ad alanının kapsamı dışında tanımlanır.

Kural açıklaması

Türler ad çakışmalarını önlemek için ve bir nesne hiyerarşisindeki ilgili türleri düzenlemenin bir yolu olarak ad alanları içinde bildirilir. Herhangi bir adlandırılmış ad alanının dışındaki türler, kodda başvurulamayan genel bir ad alanında yer alır.

İhlalleri düzeltme

Bu kuralın ihlalini düzeltmek için türü bir ad alanına yerleştirin.

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

Bu kuraldan gelen bir uyarıyı hiçbir zaman gizlemeniz gerekmeyecek olsa da, derleme hiçbir zaman diğer derlemelerle birlikte kullanılmadığında bunu yapmak 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 CA1050
// The code that's violating the rule is on this line.
#pragma warning restore CA1050

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

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

Örnek 1

Aşağıdaki örnekte, ad alanının dışında yanlış bildirilen bir türe ve ad alanında aynı ada sahip bir türe sahip bir kitaplık gösterilmektedir.

// Violates rule: DeclareTypesInNamespaces.
using System;

public class Test
{
    public override string ToString()
    {
        return "Test does not live in a namespace!";
    }
}

namespace ca1050
{
    public class Test
    {
        public override string ToString()
        {
            return "Test lives in a namespace!";
        }
    }
}

' Violates rule: DeclareTypesInNamespaces.
Public Class Test     

    Public Overrides Function ToString() As String        
        Return "Test does not live in a namespace!"    
    End Function 
    
End Class

Namespace ca1050

    Public Class Test

        Public Overrides Function ToString() As String
            Return "Test lives in a namespace!"
        End Function

    End Class

End Namespace

Örnek 2

Aşağıdaki uygulama daha önce tanımlanmış olan kitaplığı kullanır. Ad alanı dışında bildirilen tür, ad Test alanı tarafından nitelenmediğinde oluşturulur. Ad alanı içinde bildirilen türe erişmek Test için ad alanı adı gereklidir.

public class MainHolder
{
    public static void Main1050()
    {
        Test t1 = new Test();
        Console.WriteLine(t1.ToString());

        ca1050.Test t2 = new ca1050.Test();
        Console.WriteLine(t2.ToString());
    }
}

Public Class MainHolder

    Public Shared Sub Main1050()
        Dim t1 As New Test()
        Console.WriteLine(t1.ToString())

        Dim t2 As New ca1050.Test()
        Console.WriteLine(t2.ToString())
    End Sub

End Class