Compartilhar via


Instrução Namespace

Declares the name of a namespace and causes the source code that follows the declaration to be compiled within that namespace.

Namespace { name | name.name }
    [ componenttypes ]
End Namespace

Parts

  • name
    Required. A unique name that identifies the namespace. Must be a valid Visual Basic identifier. For more information, see Nomes de elementos declarados (Visual Basic).

  • componenttypes
    Optional. Elements that make up the namespace. These include (but are not limited to) enumerations, structures, interfaces, classes, modules, delegates, and other namespaces.

  • End Namespace
    Terminates a Namespace block.

Comentários

Namespaces are used as an organizational system. They provide a way to classify and present programming elements that are exposed to other programs and applications. Note that a namespace is not a type in the sense that a class or structure is — you cannot declare a programming element to have the data type of a namespace.

You can use a Namespace statement only at the file or namespace level. This means the declaration context for a namespace must be a source file or another namespace, and cannot be a class, structure, module, interface, or procedure. For more information, see Contextos de declaração e níveis de acesso padrão (Visual Basic).

Namespaces are treated as if they had a Public access level. A namespace can be accessed from code anywhere in the same project, from other projects that reference the project, and from any assembly built from the project.

Rules

  • Atributos. You cannot apply attributes to a namespace. An attribute contributes information to the assembly's metadata, which is not meaningful for source classifiers such as namespaces.

  • Modificadores. You cannot apply any access or procedure modifiers, or any other modifiers, to a namespace. Because it is not a type, these modifiers are not meaningful.

  • Aninhamento. You can declare one namespace within another. There is no strict limit to the levels of nesting you can declare, but remember that when other code accesses the elements declared in the innermost namespace, it must use a qualification string that contains all the namespace names in the nesting hierarchy.

Behavior

  • Nível de acesso. Os elementos de programação declarados no nível de namespace , que significa que em um namespace , mas não dentro de outro elemento, podem ter Public ou Friend de acesso. If unspecified, the access level of such an element uses Friend by default. Elements you can declare at namespace level include classes, structures, modules, interfaces, enumerations, and delegates. For more information, see Contextos de declaração e níveis de acesso padrão (Visual Basic).

  • Compilation. Tudo elementos de programação declarados como após um Namespacededemonstrativo pertence ao namespace. Visual Basic continues to compile elements into the last declared namespace until it encounters either an End Namespace statement or another Namespace statement.

  • Adding to a Namespace. If a namespace is already defined, even outside your project, you can add programming elements to it. To do this, you use a Namespace statement to direct Visual Basic to compile the following elements into that namespace.

    The following example defines the skeleton of a new generic list class and adds it to the System.Collections.Generic namespace.

    Namespace System.Collections.Generic
        Class specialSortedList(Of T)
            Inherits List(Of T)
            ' Insert code to define the special generic list class.
        End Class
    End Namespace
    
  • Root Namespace. Tudo namespace de nomes em seu projeto baseiam-se em um raiz namespace. Visual Studio assigns your project name as the default root namespace for all code in your project. For example, if your project is named Payroll, its programming elements belong to namespace Payroll. If you declare Namespace funding, the full name of that namespace is Payroll.funding.

    If you want to specify an existing namespace in a Namespace statement, such as in the generic list class example, you can set your root namespace to a null value. To do this, click Project Properties from the Project menu and then clear the Root namespace entry so that the box is empty. If you did not do this in the generic list class example, the Visual Basic compiler would take System.Collections.Generic as a new namespace within project Payroll, with the full name of Payroll.System.Collections.Generic.

    Alternatively, you can use the Global keyword to refer to elements of namespaces defined outside your project. Doing so lets you retain your project name as the root namespace. This reduces the chance of unintentionally merging your programming elements together with those of existing namespaces.

Troubleshooting

  • Undefined Types. The root namespace can lead to unexpected concatenations of namespace names. If you make reference to namespaces defined outside your project, the Visual Basic compiler can construe them as nested namespaces in the root namespace. In such a case, the compiler does not recognize any types that have been already defined in the external namespaces. To avoid this, either set your root namespace to a null value as described in "Root Namespace", or use the Global keyword to access elements of external namespaces.

Exemplo

The following example declares two namespaces, one nested in the other.

Namespace n1
    Namespace n2
        Class a
            ' Insert class definition.
        End Class
    End Namespace
End Namespace

The following example declares multiple nested namespaces on a single line, and it is equivalent to the previous example.

Namespace n1.n2
    Class a
        ' Insert class definition.
    End Class
End Namespace

The following example accesses the class defined in the previous examples.

Dim instance As New n1.n2.a

Consulte também

Referência

Declaração Imports (Tipo e Namespace .NET)

Conceitos

Nomes de elementos declarados (Visual Basic)

Namespaces no Visual Basic