Compartilhar via


Declarar tipos em namespaces

TypeName

DeclareTypesInNamespaces

CheckId

CA1050

Category (Categoria)

Microsoft.Design

Quebrando alterar

Quebrando

Causa

Um tipo público ou protegido é definido fora do escopo de uma chamada namespace.

Descrição da regra

Tipos são declarados em espaços para nome para evitar conflitos de nome e sistema autônomo uma forma de organizar tipos relacionados em uma hierarquia de objetos.Tipos fora de qualquer namespace nomeado estão em um namespace global não pode ser referenciado no código.

Como corrigir violações

Para corrigir uma violação dessa regra, coloque o tipo em um namespace.

Quando suprimir avisos

Embora nunca é necessário eliminar um aviso da regra, é seguro fazer isso quando o assembly nunca será usado com outros assemblies.

Exemplo

O exemplo a seguir mostra uma biblioteca com um tipo incorretamente declarado fora de um namespace, e um tipo com o mesmo nome declarado em um namespace.

Imports System 

' 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 GoodSpace  

    Public Class Test 

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

    End Class 

End Namespace
using System;

// Violates rule: DeclareTypesInNamespaces.
public class Test
{
   public override string ToString()
   {
      return "Test does not live in a namespace!";
   }
}

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

O aplicativo a seguir usa a biblioteca definida anteriormente.Observe que o tipo declarado fora de um namespace é criado quando o nome de Test não qualificado por um namespace. Observe também que para acessar o Test Digite na Goodspace, o nome do espaço para nome é obrigatório.

Imports System

Namespace ApplicationTester

    Public Class MainHolder

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

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

    End Class

End Namespace
using System;

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

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