Importinstructie (.NET-naamruimte en -type)

Artikel
03/13/2024

Hiermee kunnen typenamen worden verwezen zonder naamruimtekwalificatie.

Syntaxis

Imports [ aliasname = ] namespace
' -or-
Imports [ aliasname = ] namespace.element

generator

Term	Definitie
`aliasname`	Optioneel. Een importalias of -naam waarnaar code kan verwijzen `namespace` in plaats van de volledige kwalificatietekenreeks. Zie Gedeclareerde elementnamen.
`namespace`	Vereist. De volledig gekwalificeerde naam van de naamruimte die wordt geïmporteerd. Dit kan een tekenreeks van naamruimten zijn die op elk niveau zijn genest.
`element`	Optioneel. De naam van een programmeerelement dat in de naamruimte is gedeclareerd. Kan elk containerelement zijn.

Opmerkingen

Met de Imports instructie kunnen typen die zich in een bepaalde naamruimte bevinden rechtstreeks naar een bepaalde naamruimte worden verwezen.

U kunt één naamruimtenaam of een tekenreeks met geneste naamruimten opgeven. Elke geneste naamruimte wordt gescheiden van de volgende naamruimte op een hoger niveau door een punt (.), zoals in het volgende voorbeeld wordt geïllustreerd:

Imports System.Collections.Generic

Elk bronbestand kan een willekeurig aantal Imports instructies bevatten. Deze moeten eventuele optiedeclaraties volgen, zoals de Option Strict instructie, en ze moeten voorafgaan aan declaraties van programmeerelementen, zoals Module of Class instructies.

U kunt alleen op bestandsniveau gebruiken Imports . Dit betekent dat de declaratiecontext voor invoer een bronbestand moet zijn en geen naamruimte, klasse, structuur, module, interface, procedure of blok kan zijn.

Houd er rekening mee dat de Imports instructie geen elementen maakt van andere projecten en assembly's die beschikbaar zijn voor uw project. Importeren vindt niet plaats als u een verwijzing instelt. Hiermee hoeft u alleen namen te kwalificeren die al beschikbaar zijn voor uw project. Zie 'Importeren met elementen' in verwijzingen naar gedeclareerde elementen voor meer informatie.

Notitie

U kunt impliciete Imports instructies definiëren met behulp van de referentiepagina, Project Designer (Visual Basic). Zie Procedure: Geïmporteerde naamruimten (Visual Basic) toevoegen of verwijderen voor meer informatie.

Aliassen importeren

Een importalias definieert de alias voor een naamruimte of type. Importaliassen zijn handig wanneer u items wilt gebruiken met dezelfde naam die zijn gedeclareerd in een of meer naamruimten. Zie 'Een elementnaam kwalificeren' in verwijzingen naar gedeclareerde elementen voor meer informatie en een voorbeeld.

U moet geen lid declareren op moduleniveau met dezelfde naam als aliasname. Als u dit doet, gebruikt aliasname de Visual Basic-compiler alleen voor het gedeclareerde lid en wordt deze niet meer herkend als een importalias.

Hoewel de syntaxis die wordt gebruikt voor het declareren van een importalias, lijkt op de syntaxis die wordt gebruikt voor het importeren van een XML-naamruimtevoorvoegsel, zijn de resultaten anders. Een importalias kan worden gebruikt als een expressie in uw code, terwijl een XML-naamruimtevoorvoegsel alleen kan worden gebruikt in eigenschappen van XML-letterlijke waarden of XML-as als voorvoegsel voor een gekwalificeerde element- of kenmerknaam.

Elementnamen

Als u elementinvoert, moet het een containerelement vertegenwoordigen, dat wil gezegd een programmeerelement dat andere elementen kan bevatten. Containerelementen omvatten klassen, structuren, modules, interfaces en opsommingen.

Het bereik van de elementen die beschikbaar worden gesteld door een Imports instructie, is afhankelijk van of u opgeeft element. Als u alleen opgeeft namespace, zijn alle unieke benoemde leden van die naamruimte en leden van containerelementen binnen die naamruimte beschikbaar zonder kwalificatie. Als u zowel als namespaceelement, alleen de leden van dat element beschikbaar zijn zonder kwalificatie.

Voorbeeld 1

In het volgende voorbeeld worden alle mappen in de map C:\ geretourneerd met behulp van de DirectoryInfo klasse:

De code bevat geen Imports instructies boven aan het bestand. Daarom zijn de DirectoryInfo, StringBuilderen CrLf verwijzingen allemaal volledig gekwalificeerd met de naamruimten.

Public Function GetFolders() As String
    ' Create a new StringBuilder, which is used
    ' to efficiently build strings.
    Dim sb As New System.Text.StringBuilder

    Dim dInfo As New System.IO.DirectoryInfo("c:\")

    ' Obtain an array of directories, and iterate through
    ' the array.
    For Each dir As System.IO.DirectoryInfo In dInfo.GetDirectories()
        sb.Append(dir.Name)
        sb.Append(Microsoft.VisualBasic.ControlChars.CrLf)
    Next

    Return sb.ToString
End Function

Voorbeeld 2

Het volgende voorbeeld bevat Imports instructies voor de naamruimten waarnaar wordt verwezen. Daarom hoeven de typen niet volledig te worden gekwalificeerd met de naamruimten.

' Place Imports statements at the top of your program.
Imports System.Text
Imports System.IO
Imports Microsoft.VisualBasic.ControlChars

Public Function GetFolders() As String
    Dim sb As New StringBuilder

    Dim dInfo As New DirectoryInfo("c:\")
    For Each dir As DirectoryInfo In dInfo.GetDirectories()
        sb.Append(dir.Name)
        sb.Append(CrLf)
    Next

    Return sb.ToString
End Function

Voorbeeld 3

Het volgende voorbeeld bevat Imports instructies voor het maken van aliassen voor de naamruimten waarnaar wordt verwezen. De typen worden gekwalificeerd met de aliassen.

Imports systxt = System.Text
Imports sysio = System.IO
Imports ch = Microsoft.VisualBasic.ControlChars

Public Function GetFolders() As String
    Dim sb As New systxt.StringBuilder

    Dim dInfo As New sysio.DirectoryInfo("c:\")
    For Each dir As sysio.DirectoryInfo In dInfo.GetDirectories()
        sb.Append(dir.Name)
        sb.Append(ch.CrLf)
    Next

    Return sb.ToString
End Function

Voorbeeld 4

Het volgende voorbeeld bevat Imports instructies voor het maken van aliassen voor de typen waarnaar wordt verwezen. Aliassen worden gebruikt om de typen op te geven.

Imports strbld = System.Text.StringBuilder
Imports dirinf = System.IO.DirectoryInfo

Public Function GetFolders() As String
    Dim sb As New strbld

    Dim dInfo As New dirinf("c:\")
    For Each dir As dirinf In dInfo.GetDirectories()
        sb.Append(dir.Name)
        sb.Append(ControlChars.CrLf)
    Next

    Return sb.ToString
End Function

Delen via