Odkazy a příkaz Imports (Visual Basic)References and the Imports Statement (Visual Basic)

Můžete zpřístupnit externí objekty projektu výběrem příkazu Přidat odkaz v nabídce projekt .You can make external objects available to your project by choosing the Add Reference command on the Project menu. Odkazy v Visual Basic mohou odkazovat na sestavení, která jsou jako knihovny typů, ale obsahují více informací.References in Visual Basic can point to assemblies, which are like type libraries but contain more information.

Příkaz ImportsThe Imports Statement

Sestavení zahrnují jeden nebo více oborů názvů.Assemblies include one or more namespaces. Přidáte-li odkaz na sestavení, můžete také přidat příkaz Imports do modulu, který řídí viditelnost oborů názvů tohoto sestavení v rámci modulu.When you add a reference to an assembly, you can also add an Imports statement to a module that controls the visibility of that assembly's namespaces within the module. Příkaz Imports poskytuje obor kontextu, který umožňuje používat pouze část oboru názvů, který je nezbytný k poskytnutí jedinečného odkazu.The Imports statement provides a scoping context that lets you use only the portion of the namespace necessary to supply a unique reference.

Příkaz Imports má následující syntaxi:The Imports statement has the following syntax:

Imports [Aliasname =] Namespace

Aliasname odkazuje na krátký název, který můžete použít v rámci kódu pro odkazování na importovaný obor názvů.Aliasname refers to a short name you can use within code to refer to an imported namespace. Namespace je obor názvů dostupný buď prostřednictvím odkazu na projekt, prostřednictvím definice v rámci projektu, nebo prostřednictvím předchozího příkazu Imports.Namespace is a namespace available through either a project reference, through a definition within the project, or through a previous Imports statement.

Modul může obsahovat libovolný počet příkazů Imports.A module may contain any number of Imports statements. Musí se objevit za jakýmkoli Optionmi příkazy, pokud jsou přítomny, ale před jakýmkoli jiným kódem.They must appear after any Option statements, if present, but before any other code.

Poznámka

Nezaměňujte odkazy na projekt pomocí příkazu Imports nebo příkazu Declare.Do not confuse project references with the Imports statement or the Declare statement. Odkazy na projekt zpřístupňují externí objekty, například objekty v sestaveních, k dispozici pro Visual Basic projekty.Project references make external objects, such as objects in assemblies, available to Visual Basic projects. Příkaz Imports slouží k zjednodušení přístupu k projektovým odkazům, ale neposkytuje přístup k těmto objektům.The Imports statement is used to simplify access to project references, but does not provide access to these objects. Příkaz Declare slouží k deklaraci odkazu na externí proceduru v dynamické knihovně (DLL).The Declare statement is used to declare a reference to an external procedure in a dynamic-link library (DLL).

Použití aliasů s příkazem ImportsUsing Aliases with the Imports Statement

Příkaz Imports usnadňuje přístup k metodám tříd tím, že eliminuje nutnost explicitně zadat plně kvalifikované názvy odkazů.The Imports statement makes it easier to access methods of classes by eliminating the need to explicitly type the fully qualified names of references. Aliasy umožňují přiřadit název příjemnější pouze jedné části oboru názvů.Aliases let you assign a friendlier name to just one part of a namespace. Například sekvence návratového a řádkového kanálu, která způsobuje, že se na více řádcích zobrazí jedna část textu, je součástí modulu ControlChars v oboru názvů Microsoft.VisualBasic.For example, the carriage return/line feed sequence that causes a single piece of text to be displayed on multiple lines is part of the ControlChars module in the Microsoft.VisualBasic namespace. Chcete-li použít tuto konstantu v programu bez aliasu, je třeba zadat následující kód:To use this constant in a program without an alias, you would need to type the following code:

MsgBox("Some text" & Microsoft.VisualBasic.ControlChars.CrLf &
       "Some more text")

příkazy Imports musí být vždy první řádky hned za všemi příkazy Option v modulu.Imports statements must always be the first lines immediately following any Option statements in a module. Následující fragment kódu ukazuje, jak importovat a přiřadit alias k modulu Microsoft.VisualBasic.ControlChars:The following code fragment shows how to import and assign an alias to the Microsoft.VisualBasic.ControlChars module:

Imports CtrlChrs = Microsoft.VisualBasic.ControlChars

Budoucí odkazy na tento obor názvů můžou být výrazně kratší:Future references to this namespace can be considerably shorter:

MsgBox("Some text" & CtrlChrs.CrLf & "Some more text")

Pokud příkaz Imports nezahrnuje název aliasu, prvky definované v rámci importovaného oboru názvů lze v modulu použít bez kvalifikace.If an Imports statement does not include an alias name, elements defined within the imported namespace can be used in the module without qualification. Pokud je název aliasu zadán, je nutné jej použít jako kvalifikátor názvů obsažených v daném oboru názvů.If the alias name is specified, it must be used as a qualifier for names contained within that namespace.

Viz také:See also