Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespaces organizam os objetos definidos em um assembly. Os assemblies podem conter vários namespaces, que, por sua vez, podem conter outros namespaces. Os namespaces impedem a ambiguidade e simplificam as referências ao usar grandes grupos de objetos, como bibliotecas de classes.
Por exemplo, o .NET Framework define a ListBox classe no System.Windows.Forms namespace. O fragmento de código a seguir mostra como declarar uma variável usando o nome totalmente qualificado para esta classe:
Dim LBox As System.Windows.Forms.ListBox
Evitar conflitos de nomes
Os namespaces do .NET Framework resolvem um problema às vezes chamado de poluição de namespace, no qual o desenvolvedor de uma biblioteca de classes é prejudicado pelo uso de nomes semelhantes em outra biblioteca. Esses conflitos com componentes existentes às vezes são chamados de colisões de nome.
Por exemplo, se você criar uma nova classe chamada ListBox
, poderá usá-la dentro de seu projeto sem qualificação. No entanto, se você quiser usar a classe .NET Framework ListBox no mesmo projeto, deverá usar uma referência totalmente qualificada para tornar a referência exclusiva. Se a referência não for exclusiva, o Visual Basic produzirá um erro informando que o nome é ambíguo. O exemplo de código a seguir demonstra como declarar esses objetos:
' Define a new object based on your ListBox class.
Dim LBC As New ListBox
' Define a new Windows.Forms ListBox control.
Dim MyLB As New System.Windows.Forms.ListBox
A ilustração a seguir mostra duas hierarquias de namespace, ambas contendo um objeto chamado ListBox
:
Por padrão, cada arquivo executável criado com o Visual Basic contém um namespace com o mesmo nome do projeto. Por exemplo, se você definir um objeto em um projeto chamado ListBoxProject
, o arquivo executável ListBoxProject.exe conterá um namespace chamado ListBoxProject
.
Vários assemblies podem usar o mesmo namespace. O Visual Basic os trata como um único conjunto de nomes. Por exemplo, você pode definir classes para um namespace chamado SomeNameSpace
em um assembly chamado Assemb1
e definir classes adicionais para o mesmo namespace de um assembly chamado Assemb2
.
Nomes totalmente qualificados
Nomes totalmente qualificados são referências de objeto prefixadas com o nome do namespace no qual o objeto é definido. Você pode usar objetos definidos em outros projetos se criar uma referência à classe (escolhendo Adicionar Referência no menu Projeto ) e, em seguida, usar o nome totalmente qualificado para o objeto em seu código. O fragmento de código a seguir mostra como usar o nome totalmente qualificado para um objeto do namespace de outro projeto:
Dim LBC As New ListBoxProject.Form1.ListBox
Nomes totalmente qualificados impedem conflitos de nomenclatura porque possibilitam que o compilador determine qual objeto está sendo usado. No entanto, os próprios nomes podem ficar longos e complicados. Para contornar isso, você pode usar a Imports
instrução para definir um alias— um nome abreviado que você pode usar no lugar de um nome totalmente qualificado. Por exemplo, o exemplo de código a seguir cria aliases para dois nomes totalmente qualificados e usa esses aliases para definir dois objetos.
Imports LBControl = System.Windows.Forms.ListBox
Imports MyListBox = ListBoxProject.Form1.ListBox
Dim LBC As LBControl
Dim MyLB As MyListBox
Se você usar a Imports
instrução sem um alias, poderá usar todos os nomes nesse namespace sem qualificação, desde que eles sejam exclusivos para o projeto. Se o projeto contiver Imports
instruções para namespaces que contenham itens com o mesmo nome, você deverá qualificar totalmente esse nome quando usá-lo. Suponha, por exemplo, que seu projeto contenha as seguintes duas instruções: Imports
' This namespace contains a class called Class1.
Imports MyProj1
' This namespace also contains a class called Class1.
Imports MyProj2
Se você tentar usá-lo Class1
sem qualificá-lo totalmente, o Visual Basic produzirá um erro informando que o nome Class1
é ambíguo.
Instruções de nível de namespace
Em um namespace, você pode definir itens como módulos, interfaces, classes, delegados, enumerações, estruturas e outros namespaces. Não é possível definir itens como propriedades, procedimentos, variáveis e eventos no nível do namespace. Esses itens devem ser declarados em contêineres, como módulos, estruturas ou classes.
Palavra-chave global em nomes totalmente qualificados
Se você tiver definido uma hierarquia aninhada de namespaces, o código dentro dessa hierarquia poderá ser impedido de acessar o System namespace do .NET Framework. O exemplo a seguir ilustra uma hierarquia na qual o namespace SpecialSpace.System
bloqueia o acesso a System.
Namespace SpecialSpace
Namespace System
Class abc
Function getValue() As System.Int32
Dim n As System.Int32
Return n
End Function
End Class
End Namespace
End Namespace
Como resultado, o compilador do Visual Basic não pode resolver a referência a System.Int32, porque SpecialSpace.System
não define Int32
. Você pode usar a Global
palavra-chave para iniciar a cadeia de qualificação no nível mais externo da biblioteca de classes do .NET Framework. Isso permite que você especifique o System namespace ou qualquer outro namespace na biblioteca de classes. O exemplo a seguir ilustra essa situação.
Namespace SpecialSpace
Namespace System
Class abc
Function getValue() As Global.System.Int32
Dim n As Global.System.Int32
Return n
End Function
End Class
End Namespace
End Namespace
Você pode usar Global
para acessar outros namespaces de nível raiz, como Microsoft.VisualBasic, e qualquer namespace associado ao seu projeto.
Palavra-chave global em declarações de namespace
Você também pode usar a Global
palavra-chave em uma declaração de namespace. Isso permite que você defina um namespace fora do namespace raiz do seu projeto.
Todos os namespaces em seu projeto são baseados no namespace raiz do projeto. O Visual Studio atribui o nome do projeto como o namespace raiz padrão para todo o código em seu projeto. Por exemplo, se o projeto for nomeado ConsoleApplication1
, seus elementos de programação pertencem ao namespace ConsoleApplication1
. Se você declarar Namespace Magnetosphere
, as referências a Magnetosphere
no projeto acessarão ConsoleApplication1.Magnetosphere
.
Os exemplos a seguir usam a Global
palavra-chave para declarar um namespace fora do namespace raiz do projeto.
Namespace Global.Magnetosphere
End Namespace
Namespace Global
Namespace Magnetosphere
End Namespace
End Namespace
Em uma declaração de namespace, Global
não pode ser aninhado em outro namespace.
Você pode usar a Página do Aplicativo, o Designer de Projeto (Visual Basic) para exibir e modificar o namespace raiz do projeto. Para novos projetos, o Namespace Raiz usa como padrão o nome do projeto. Para fazer com que Global
se torne o namespace de nível superior, você pode limpar o campo do Namespace Raiz para que a caixa fique vazia. Limpar o namespace raiz remove a necessidade da Global
palavra-chave em declarações de namespace.
Se uma Namespace
instrução declarar um nome que também seja um namespace no .NET Framework, o namespace do .NET Framework ficará indisponível se a Global
palavra-chave não for usada em um nome totalmente qualificado. Para habilitar o acesso a esse namespace do .NET Framework sem usar a Global
palavra-chave, você pode incluir a Global
palavra-chave na Namespace
instrução.
O exemplo a seguir possui a palavra-chave Global
na declaração de namespace System.Text
.
Se a Global
palavra-chave não estava presente na declaração de namespace, StringBuilder não foi possível acessar sem especificar Global.System.Text.StringBuilder
. Para um projeto chamado ConsoleApplication1
, as referências a System.Text
acessariam ConsoleApplication1.System.Text
se a palavra-chave Global
não fosse usada.
Module Module1
Sub Main()
Dim encoding As New System.Text.TitanEncoding
' If the namespace defined below is System.Text
' instead of Global.System.Text, then this statement
' causes a compile-time error.
Dim sb As New System.Text.StringBuilder
End Sub
End Module
Namespace Global.System.Text
Class TitanEncoding
End Class
End Namespace