Odkazy a příkaz Imports (Visual Basic)

Externí objekty můžete zpřístupnit projektu tak, že v nabídce Projekt vyberete příkaz Přidat odkaz. Odkazy v jazyce Visual Basic mohou odkazovat na sestavení, která jsou jako knihovny typů, ale obsahují další informace.

Příkaz Imports

Sestavení obsahují jeden nebo více oborů názvů. Když přidáte odkaz na sestavení, můžete také přidat Imports příkaz do modulu, který řídí viditelnost oborů názvů sestavení v rámci modulu. Příkaz Imports poskytuje kontext rozsahu, který umožňuje použít pouze část oboru názvů potřebnou k poskytnutí jedinečného odkazu.

Příkaz Imports má následující syntaxi:

Imports [Aliasname =] Namespace

Aliasname odkazuje na krátký název, který můžete použít v kódu k odkazování na importovaný obor názvů. Namespace je obor názvů dostupný prostřednictvím odkazu na projekt, prostřednictvím definice v projektu nebo prostřednictvím předchozího Imports příkazu.

Modul může obsahovat libovolný počet Imports příkazů. Musí se zobrazit za libovolnými Option příkazy, pokud existují, ale před jakýmkoli jiným kódem.

Poznámka:

Nezaměňujte odkazy na projekt s příkazem Imports nebo příkazem Declare . Odkazy projektu zpřístupňuje externí objekty, například objekty v sestaveních, pro projekty jazyka Visual Basic. Tento Imports příkaz se používá ke zjednodušení přístupu k odkazům na projekt, ale neposkytuje přístup k těmto objektům. Tento Declare příkaz slouží k deklaraci odkazu na externí proceduru v knihovně dynamického propojení (DLL).

Použití aliasů s příkazem Imports

Tento Imports příkaz usnadňuje přístup k metodám tříd tím, že eliminuje nutnost explicitně zadávat plně kvalifikované názvy odkazů. Aliasy umožňují přiřadit popisnější název jenom jedné části oboru názvů. Například sekvence návratu na začátek řádku nebo odřádkování, která způsobí, že jeden text se zobrazí na více řádcích, je součástí ControlChars modulu v Microsoft.VisualBasic oboru názvů. Pokud chcete tuto konstantu použít v programu bez aliasu, musíte zadat následující kód:

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

Imports příkazy musí být vždy prvním řádkem bezprostředně za všemi Option příkazy v modulu. Následující fragment kódu ukazuje, jak importovat a přiřadit alias modulu Microsoft.VisualBasic.ControlChars :

Imports CtrlChrs = Microsoft.VisualBasic.ControlChars

Budoucí odkazy na tento obor názvů mohou být výrazně kratší:

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

Imports Pokud příkaz neobsahuje název aliasu, lze prvky definované v importovaném oboru názvů použít v modulu bez kvalifikace. Pokud je název aliasu zadaný, musí se použít jako kvalifikátor pro názvy obsažené v tomto oboru názvů.

Viz také