Sdílet prostřednictvím


Příkaz Namespace

Deklaruje název oboru názvů a způsobuje následující prohlášení vypracovávají v rámci daného oboru názvů zdrojový kód.

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

Části

  • Globální
    Nepovinné.Umožňuje definovat obor názvů z oboru názvů root projektu.Viz téma Obory názvů v aplikaci Visual Basic.

  • name
    Povinné.Jedinečný název, který identifikuje obor názvů.Musí být platný identifikátor jazyka Visual Basic.Další informace naleznete v tématu Deklarovaný názvy prvků (Visual Basic).

  • componenttypes
    Nepovinné.Prvky, které tvoří obor názvů.Tyto zahrnují, ale nejsou omezeny na vyčíslení, struktury, rozhraní, třídy, moduly, delegátů a ostatní obory názvů.

  • End Namespace
    Ukončí Namespace bloku.

Poznámky

Obory názvů jsou používány jako organizační systém.Poskytují ke klasifikaci a prezentovat programovací prvky, které jsou vystaveny jiné programy a aplikace.Všimněte si, že oboru názvů není typu v tom smyslu, že třídy nebo struktury – programovací element mít datový typ oboru názvů nelze deklarovat.

Po prohlášena za všechny programovací prvky Namespace prohlášení patří do daného oboru názvů.Visual Basic nadále kompilace prvků do poslední prohlášených oboru názvů, dokud nenarazí buď End Namespace prohlášení nebo jinou Namespace prohlášení.

Pokud již definován obor názvů, dokonce i mimo projekt, můžete ji přidat programovací prvky.To provedete pomocí Namespace prohlášení přímého Visual Basic kompilace prvků do tohoto oboru názvů.

Můžete použít Namespace prohlášení pouze na úrovni souboru nebo oboru názvů.To znamená prohlášení kontextu pro obor názvů musí být zdrojový soubor nebo jiný obor názvů a nemůže být třída, struktura, modul, rozhraní nebo postup.Další informace naleznete v tématu Prohlášení kontextů a úrovně přístupu výchozí (Visual Basic).

Jeden obor názvů v rámci jiného, můžete deklarovat.Neexistuje žádné přísné omezení úrovní vnoření, můžete deklarovat, ale mějte na paměti, když jiný kód přistupuje elementy deklarované v nejvnitřnější oboru názvů, je nutné použít kvalifikace řetězec, který obsahuje všechny názvy oboru názvů v hierarchii vnořených.

Úroveň přístupu

Obory názvů jsou zpracovány jako by měly Public úroveň přístupu.Obor názvů lze přistupovat z kódu kdekoli ve stejném projektu, z jiných projektů, které odkazují na projektu a z libovolné sestavení vytvořeno z projektu.

Programování elementy deklarované na úrovni oboru názvů v oboru názvů, ale ne uvnitř prvku, což může mít Public nebo Friend přístup.Pokud tento parametr nezadáte, úroveň přístupu těchto prvek používá Friend ve výchozím nastavení.Prvky, které lze deklarovat na úrovni oboru názvů patří třídy, struktury, moduly, rozhraní, vyčíslení a delegáty.Další informace naleznete v tématu Prohlášení kontextů a úrovně přístupu výchozí (Visual Basic).

Kořenový obor názvů

Názvy všech názvů v projektu jsou založeny na kořenový obor názvů.Visual Studio přiřadí název vašeho projektu jako výchozí obor názvů root pro veškerý kód v projektu.Například projekt s názvem Payroll, jeho programovací prvky patří do oboru názvů Payroll.Pokud deklarujete Namespace funding, úplný název daného oboru názvů je Payroll.funding.

Chcete-li určit existujícího oboru názvů v Namespace prohlášení, jako v příkladu třídy obecný seznam, můžete nastavit kořenový obor názvů na hodnotu null.Chcete-li to provést, klepněte na tlačítko Vlastnosti projektu z projektu nabídky a potom zrušte zaškrtnutí políčka kořenový obor názvů položku tak, že je pole prázdné.Pokud jste neučinili tento příklad třídy obecný seznam, by trvat kompilátoru Visual Basic System.Collections.Generic jako nový obor názvů v rámci projektu Payroll, úplné jméno Payroll.System.Collections.Generic.

Můžete také použít Global klíčové prvky obory názvů definované mimo projekt odkazovat.Přitom umožňuje zachovat název vašeho projektu jako kořenový obor názvů.To snižuje pravděpodobnost neúmyslně sloučení vaší programovací prvky společně s existující obory názvů.Další informace naleznete v části "Globální klíčové slovo v plně kvalifikované názvy" Obory názvů v aplikaci Visual Basic.

Global Klíčové slovo je také možné v příkazu oboru názvů.To umožňuje definovat obor názvů z oboru názvů root projektu.Další informace naleznete v části "Globální klíčové slovo v oboru názvů příkazů" Obory názvů v aplikaci Visual Basic.

Poradce při potížích. Kořenový obor názvů může vést k neočekávaným zřetězení obor názvů.Pokud odkaz na obory názvů definované mimo projekt, může kompilátor Visual Basic provést construe jako vnořené obory názvů v kořenovém oboru názvů.V takovém případě kompilátor nerozpoznal všechny typy, které byly již definovány v externí obory názvů.Vyhnout, nastavte na hodnotu null, jak je popsáno v "Oboru názvů Root" kořenový obor názvů, nebo použít Global klíčové prvky přístupu externí obory názvů.

Atributy a modifikátory

Obor názvů nelze použít atributy.Atribut přispívá informace k sestavení metadat, která není srozumitelný pro třídění zdroje, například obory názvů.

Obor názvů nelze použít přístup nebo modifikátory postup nebo modifikátory.Protože není typu, nejsou tyto modifikátory smysluplné.

Příklad

Následující příklad prohlašuje dvěma obory názvů, jeden vnořený do druhé.

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

Následující příklad deklaruje více vnořených oborů na jednom řádku a je ekvivalentní předchozí příklad.

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

Následující příklad přistupuje k třídy definované v předchozích příkladech.

Dim instance As New n1.n2.a

Následující příklad definuje kostra nové třídy obecný seznam a přidá ji System.Collections.Generic oboru názvů.

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

Viz také

Referenční dokumentace

Importuje příkaz (.NET oboru názvů a typ)

Koncepty

Deklarovaný názvy prvků (Visual Basic)

Obory názvů v aplikaci Visual Basic