Delen via

Verwijzingen en de importverklaring (Visual Basic)

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 importverklaring

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 instructie Imports 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.

Opmerking

Verwar projectverwijzingen niet met de Imports verklaring of de Declare verklaring. 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 eenvoudiger om methodes van klassen aan te roepen door de noodzaak weg te nemen om de volledig gekwalificeerde namen van verwijzingen expliciet in te typen. Met aliassen kunt u een beschrijvendere naam toewijzen aan slechts één deel van een naamruimte. De carriage return/line feed-sequentie 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