Share via

Verwijzingen en de importinstructie (Visual Basic)

  • Artikel

U kunt externe objecten beschikbaar maken voor uw project door de opdracht Verwijzing toevoegen te kiezen in het menu Project . Verwijzingen in Visual Basic kunnen verwijzen naar assembly's, zoals typebibliotheken, maar bevatten meer informatie.

De importinstructie

Assembly's bevatten een of meer naamruimten. Wanneer u een verwijzing naar een assembly toevoegt, kunt u ook een Imports instructie toevoegen aan een module waarmee de zichtbaarheid van de naamruimten van die assembly in de module wordt bepaald. De Imports instructie biedt een bereikcontext waarmee u alleen het gedeelte van de naamruimte kunt gebruiken dat nodig is om een unieke verwijzing op te geven.

De Imports instructie heeft de volgende syntaxis:

Imports [Aliasname =] Namespace

Aliasname verwijst naar een korte naam die u in code kunt gebruiken om te verwijzen naar een geïmporteerde naamruimte. Namespace is een naamruimte die beschikbaar is via een projectreferentie, via een definitie binnen het project of via een vorige Imports instructie.

Een module kan een willekeurig aantal Imports instructies bevatten. Ze moeten worden weergegeven na eventuele Option instructies, indien aanwezig, maar vóór andere code.

Notitie

Verwar projectverwijzingen niet met de Imports instructie of de Declare instructie. Projectverwijzingen maken externe objecten, zoals objecten in assembly's, beschikbaar voor Visual Basic-projecten. De Imports instructie wordt gebruikt om de toegang tot projectverwijzingen te vereenvoudigen, maar biedt geen toegang tot deze objecten. De Declare instructie wordt gebruikt om een verwijzing naar een externe procedure in een DLL (Dynamic Link Library) te declareren.

Aliassen gebruiken met de importinstructie

De Imports instructie maakt het gemakkelijker om toegang te krijgen tot methoden van klassen door de noodzaak om expliciet de volledig gekwalificeerde namen van verwijzingen te typen. Met aliassen kunt u een beschrijvendere naam toewijzen aan slechts één deel van een naamruimte. De regelterugloop/regelinvoervolgorde die ervoor zorgt dat één stuk tekst op meerdere regels wordt weergegeven, maakt deel uit van de ControlChars module in de Microsoft.VisualBasic naamruimte. Als u deze constante wilt gebruiken in een programma zonder alias, moet u de volgende code typen:

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

Imports instructies moeten altijd de eerste regels zijn die direct volgen op eventuele Option instructies in een module. In het volgende codefragment ziet u hoe u een alias importeert en toewijst aan de Microsoft.VisualBasic.ControlChars module:

Imports CtrlChrs = Microsoft.VisualBasic.ControlChars

Toekomstige verwijzingen naar deze naamruimte kunnen aanzienlijk korter zijn:

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

Als een Imports instructie geen aliasnaam bevat, kunnen elementen die zijn gedefinieerd in de geïmporteerde naamruimte, zonder kwalificatie in de module worden gebruikt. Als de aliasnaam is opgegeven, moet deze worden gebruikt als kwalificatie voor namen in die naamruimte.

Zie ook