Imports Deyimi (.NET Ad Alanı ve Türü)
Ad alanı niteliği olmadan tür adlarına başvurulmalarına olanak sağlar.
Syntax
Imports [ aliasname = ] namespace
' -or-
Imports [ aliasname = ] namespace.element
Bölümler
| Süre | Tanım |
|---|---|
aliasname |
İsteğe bağlı. Kodun tam nitelik dizesi yerine başvura bir içeri namespace aktarma diğer adı veya adı. Bkz. Bildirilen Öğe Adları. |
namespace |
Gereklidir. İçeri aktarılan ad alanının tam adı. Herhangi bir düzeyde iç içe geçmiş bir ad alanı dizesi olabilir. |
element |
İsteğe bağlı. Ad alanına bildirilen programlama öğesinin adı. Herhangi bir kapsayıcı öğesi olabilir. |
Açıklamalar
deyimi, Imports verilen ad alanı içinde yer alan türlerin doğrudan başvurulmalarını sağlar.
Tek bir ad alanı adı veya iç içe geçmiş ad alanları dizesi sebilirsiniz. Aşağıdaki örnekte gösterildiği gibi, iç içe geçmiş her ad alanı bir sonraki üst düzey ad alanından nokta () . ile ayrılır:
Imports System.Collections.Generic
Her kaynak dosya herhangi bir sayıda Imports deyim içerebilir. Bunlar deyimi gibi herhangi bir seçenek bildirimini izlemeli ve veya deyimleri gibi programlama öğesi Option Strict bildirimlerini Module Class izlemeli.
Yalnızca dosya Imports düzeyinde kullanabilirsiniz. Bu, içeri aktarma için bildirim bağlamının bir kaynak dosya olması ve ad alanı, sınıf, yapı, modül, arabirim, yordam veya blok olamaz olduğu anlamına gelir.
Importsdeyiminin, diğer projelerden ve derlemelerden öğeleri projeniz için kullanılabilir hale olmadığını unutmayın. İçeri aktarma, bir başvuru ayarlamanın yerini almaz. Yalnızca projeniz için zaten kullanılabilir olan adları uygun olarak nitelendirma ihtiyacı ortadan kaldırır. Daha fazla bilgi için, Bildirilen Öğelere Başvurular'da "İçeren Öğeleri İçeri Aktarma" 'ye bakın.
Not
Başvurular Sayfasını, Project Imports Designer'ı (Visual Basic) kullanarak örtülü deyimler tanımlayabilirsiniz. Daha fazla bilgi için, bkz. How to: Add or Remove Imported Namespaces (Visual Basic).
Diğer Adları İçeri Aktarma
İç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ına bildirilen aynı ad alanına sahip öğeleri kullanmak için kullanışlıdır. Daha fazla bilgi ve örnek için, Bildirilen Öğelere Başvurular'da "Öğe Adını Nitelendirerek" öğesine bakın.
ile aynı adla modül düzeyinde bir üye aliasname bildiresiniz. Bunu yaparsanız, Visual Basic derleyicisi yalnızca bildirilen üye için kullanır ve artık bunu içeri aliasname aktarma diğer adı olarak tanımaz.
İçeri aktarma diğer adını bildirim için kullanılan söz dizimi XML ad alanı ön eklerini içeri aktarmaya benzer olsa da sonuçlar farklıdır. İçeri aktarma diğer adı, kodunda ifade olarak kullanılabilirken, XML ad alanı ön eki yalnızca XML değişmez değerlerinde veya XML ekseni özelliklerinde nitelikli öğe veya öznitelik adı için ön ek olarak kullanılabilir.
Öğe adları
elementsağlarsanız, diğer öğeleri içere bir programlama öğesi olan kapsayıcı öğesini temsil etmek gerekir. Kapsayıcı öğeleri sınıflar, yapılar, modüller, arabirimler ve numaralar içerir.
Bir deyimi tarafından kullanılabilir duruma yapılan öğelerin Imports kapsamı, belirttiğinize element bağlıdır. Yalnızca belirtirsiniz, bu ad alanının tüm benzersiz olarak adlandırılmış üyeleri ve bu ad alanı içindeki kapsayıcı namespace öğelerinin üyeleri, niteliksiz kullanılabilir. hem hem de namespace element belirtirsiniz, yalnızca bu öğenin üyeleri nitelik olmadan kullanılabilir.
Örnek 1
Aşağıdaki örnek, sınıfını kullanarak C: \ dizinindeki tüm klasörleri DirectoryInfo döndürür:
Kodun Imports dosyanın üst kısmında deyimi yoktur. Bu DirectoryInfo nedenle, StringBuilder , ve CrLf başvurularını ad alanlarıyla tam olarak niteler.
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, Imports başvurulan ad alanları için deyimleri içerir. Bu nedenle türlerin ad alanlarıyla tam olarak nitelene sahip olması gerek değildir.
' 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, Imports başvurulan ad alanları için diğer adlar oluşturan deyimleri içerir. Türler diğer adlarla tam olarak uygun olur.
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, Imports başvurulan türler için diğer adlar oluşturan deyimleri içerir. 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