Referencje i importy — Instrukcja (Visual Basic)

  • Artykuł

Obiekty zewnętrzne można udostępnić projektowi, wybierając polecenie Dodaj odwołanie w menu Project . Odwołania w Visual Basic mogą wskazywać zestawy, które są podobne do bibliotek typów, ale zawierają więcej informacji.

Instrukcja Import

Zestawy obejmują co najmniej jedną przestrzeń nazw. Po dodaniu odwołania do zestawu można również dodać instrukcję Imports do modułu, który kontroluje widoczność przestrzeni nazw tego zestawu w module. Instrukcja Imports zawiera kontekst określania zakresu, który umożliwia używanie tylko części przestrzeni nazw niezbędnej do dostarczenia unikatowego odwołania.

Instrukcja Imports ma następującą składnię:

Imports [Aliasname =] Namespace

Aliasname odwołuje się do krótkiej nazwy, której można użyć w kodzie, aby odwołać się do zaimportowanej przestrzeni nazw. Namespace to przestrzeń nazw dostępna za pośrednictwem odwołania do projektu, przez definicję w projekcie lub za pomocą poprzedniej Imports instrukcji.

Moduł może zawierać dowolną liczbę instrukcji Imports . Muszą pojawić się po wszelkich instrukcjach Option , jeśli są obecne, ale przed jakimkolwiek innym kodem.

Uwaga

Nie należy mylić odwołań do projektu za pomocą instrukcji Imports lub instrukcji Declare . Odwołania do projektu sprawiają, że obiekty zewnętrzne, takie jak obiekty w zestawach, są dostępne dla projektów Języka Visual Basic. Instrukcja Imports służy do upraszczania dostępu do odwołań do projektu, ale nie zapewnia dostępu do tych obiektów. Instrukcja Declare służy do deklarowania odwołania do procedury zewnętrznej w bibliotece linków dynamicznych (DLL).

Używanie aliasów z instrukcją Import

Instrukcja Imports ułatwia dostęp do metod klas, eliminując konieczność jawnego wpisywania w pełni kwalifikowanych nazw odwołań. Aliasy umożliwiają przypisanie bardziej przyjaznej nazwy tylko do jednej części przestrzeni nazw. Na przykład sekwencja zestawienia powrotu/wiersza karetki, która powoduje wyświetlenie pojedynczego fragmentu tekstu w wielu wierszach, jest częścią modułu ControlCharsMicrosoft.VisualBasic w przestrzeni nazw. Aby użyć tej stałej w programie bez aliasu, należy wpisać następujący kod:

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

Imports instrukcje muszą zawsze być pierwszymi wierszami bezpośrednio po instrukcjach Option w module. Poniższy fragment kodu pokazuje, jak zaimportować i przypisać alias do modułu Microsoft.VisualBasic.ControlChars :

Imports CtrlChrs = Microsoft.VisualBasic.ControlChars

Przyszłe odwołania do tej przestrzeni nazw mogą być znacznie krótsze:

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

Jeśli instrukcja Imports nie zawiera nazwy aliasu, elementy zdefiniowane w importowanej przestrzeni nazw mogą być używane w module bez kwalifikacji. Jeśli określona jest nazwa aliasu, musi być używana jako kwalifikator nazw zawartych w tej przestrzeni nazw.

Zobacz też