Imports Deyimi (.NET Ad Alanı ve Türü)

Makale
03/12/2024

Ad alanı niteliği olmadan tür adlarına başvurulmaya olanak tanır.

Sözdizimi

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

Parça

Süre	Tanım
`aliasname`	isteğe bağlı. Tam niteleme dizesi yerine kodun başvurabileceği `namespace` bir içeri aktarma diğer adı veya adı. Bkz. Bildirilen Öğe Adları.
`namespace`	Gerekli. İçeri aktarılan ad alanının tam adı. Herhangi bir düzeye iç içe yerleştirilmiş bir ad alanı dizesi olabilir.
`element`	isteğe bağlı. Ad alanında bildirilen bir programlama öğesinin adı. Herhangi bir kapsayıcı öğesi olabilir.

Açıklamalar

deyimi, Imports belirli bir ad alanında bulunan türlerin doğrudan başvurulmaya olanak tanır.

Tek bir ad alanı adı veya iç içe ad alanları dizesi sağlayabilirsiniz. Aşağıdaki örnekte gösterildiği gibi, iç içe yerleştirilmiş her ad alanı bir sonraki üst düzey ad alanından bir nokta (). ile ayrılır:

Imports System.Collections.Generic

Her kaynak dosya herhangi bir sayıda Imports deyim içerebilir. Bunlar deyimi gibi Option Strict tüm seçenek bildirimlerini izlemeli ve veya Class deyimleri gibi Module programlama öğesi bildirimlerinden önce gelmelidir.

Yalnızca dosya düzeyinde kullanabilirsiniz Imports . Bu, içeri aktarma için bildirim bağlamının bir kaynak dosya olması gerektiği ve ad alanı, sınıf, yapı, modül, arabirim, yordam veya blok olamayacağı anlamına gelir.

deyiminin Imports diğer projelerden ve derlemelerden öğeleri projeniz için kullanılabilir hale getirmediğini unutmayın. İçeri aktarma işlemi, başvuru ayarlama yerine almaz. Yalnızca projenizde zaten kullanılabilir olan adları niteleme gereksinimini ortadan kaldırır. Daha fazla bilgi için, Bildirilen Öğelere Başvurular'daki "İçeri Aktaran Öğeleri İçeri Aktarma" bölümüne bakın.

Not

Örtük Imports deyimleri, Başvurular Sayfası, Project Tasarım Aracı (Visual Basic) kullanarak tanımlayabilirsiniz. Daha fazla bilgi için bkz . Nasıl yapılır: İçeri Aktarılan Ad Alanlarını Ekleme veya Kaldırma (Visual Basic).

Diğer Adları İçeri Aktar

İçeri aktarma diğer adı , ad alanı veya tür için diğer adı tanımlar. İçeri aktarma diğer adları, bir veya daha fazla ad alanında bildirilen aynı ada sahip öğeleri kullanmanız gerektiğinde kullanışlıdır. Daha fazla bilgi ve örnek için, Bildirilen Öğelere Başvurular bölümünde "Öğe Adını Niteleme" bölümüne bakın.

Ile aynı ada aliasnamesahip bir üyeyi modül düzeyinde bildirmemelisiniz. Bunu yaparsanız, Visual Basic derleyicisi yalnızca bildirilen üye için kullanır aliasname ve bunu artık içeri aktarma diğer adı olarak tanımaz.

İçeri aktarma diğer adını bildirmek için kullanılan söz dizimi, XML ad alanı ön ekini içeri aktarmak için kullanılan söz dizimi gibi olsa da, sonuçlar farklıdır. İçeri aktarma diğer adı kodunuzda bir ifade olarak kullanılabilirken, XML ad alanı ön eki yalnızca XML değişmez değerlerinde veya XML ekseni özelliklerinde nitelenmiş bir öğe veya öznitelik adı için ön ek olarak kullanılabilir.

Öğe adları

sağladığınızda elementkapsayıcı öğesini, yani diğer öğeleri içerebilen bir programlama öğesini temsil etmesi gerekir. Kapsayıcı öğeleri sınıflar, yapılar, modüller, arabirimler ve numaralandırmalar içerir.

Deyimi Imports tarafından sağlanan öğelerin kapsamı, belirtip belirtmediğinize elementbağlıdır. Yalnızca namespacebelirtirseniz, bu ad alanının benzersiz olarak adlandırılmış tüm üyeleri ve bu ad alanındaki kapsayıcı öğelerinin üyeleri niteleme olmadan kullanılabilir. hem hem elementde namespace belirtirseniz, niteleme olmadan yalnızca bu öğenin üyeleri kullanılabilir.

Örnek 1

Aşağıdaki örnek, sınıfını kullanarak DirectoryInfo C:\ dizinindeki tüm klasörleri döndürür:

Kodun dosyanın en üstünde deyimleri yok Imports . Bu nedenle, DirectoryInfo, StringBuilderve CrLf başvurularının tümü ad alanlarıyla tam olarak nitelenir.

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

Örnek 2

Aşağıdaki örnek, başvuruda bulunan ad alanları için deyimleri içerir Imports . Bu nedenle, türlerin ad alanlarıyla tam olarak nitelenmiş olması gerekmez.

' 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

Örnek 3

Aşağıdaki örnek, başvuruda bulunan ad alanları için diğer adlar oluşturan deyimleri içerir Imports . Türler diğer adlarla nitelenir.

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

Örnek 4

Aşağıdaki örnek, başvuruda bulunan türler için diğer adlar oluşturan deyimleri içerir Imports . Diğer adlar türleri belirtmek için kullanılır.

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

Aracılığıyla paylaş