Declare tipos en espacios de nombres

Actualización: noviembre 2007

Nombre de tipo	DeclareTypesInNamespaces
Identificador de comprobación	CA1050
Categoría	Microsoft.Design
Cambio problemático	Sí

Motivo

Un tipo público o protegido se define fuera del ámbito de un espacio de nombres.

Descripción de la regla

Los tipos se declaran dentro de los espacios de nombres para evitar conflictos de nombre y como una forma de organizar los tipos relacionados en una jerarquía de objetos. Los tipos fuera de cualquier espacio de nombres se encuentran en un espacio de nombres global al que no se puede hacer referencia en el código.

Cómo corregir infracciones

Para corregir las infracciones de esta regla, coloque el tipo en un espacio de nombres.

Cuándo suprimir advertencias

Mientras que nunca sea necesario suprimir una advertencia de esta regla, es seguro hacerlo cuando el ensamblado nunca se vaya a usar con otros ensamblados.

Ejemplo

El siguiente ejemplo muestra una biblioteca con un tipo declarado incorrectamente fuera del espacio de nombres, y otro tipo con el mismo nombre declarado dentro del espacio de nombres.

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!";
      }
   }
}   

La aplicación siguiente utiliza la biblioteca definida previamente. Tenga en cuenta que el tipo se ha declarado fuera de un espacio de nombres creado cuando el nombre Testno está calificado por un espacio de nombres. También observe que es necesario el nombre del espacio de nombres para obtener acceso al tipo Test en Goodspace.

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());
        }
    }
}