Imports Deyimi (XML Ad Alanı)
XML değişmez değerlerde ve XML ekseni özelliklerinde kullanmak üzere XML ad alanı ön eklerini içeri aktarıyor.
Syntax
Imports <xmlns:xmlNamespacePrefix = "xmlNamespaceName">
Bölümler
xmlNamespacePrefix
İsteğe bağlı. XML öğelerinin ve özniteliklerinin başvurabilecekleri xmlNamespaceName dize. Sağlanmadı xmlNamespacePrefix ise, içe aktarılan XML ad alanı varsayılan XML ad alanıdır. Geçerli bir XML tanımlayıcısı olmalıdır. Daha fazla bilgi için bkz. Bildirilen XML Öğelerinin ve Özniteliklerinin Adları.
xmlNamespaceName
Gereklidir. İçeri aktarılan XML ad alanını tanımlayan dize.
Açıklamalar
XML değişmez değerleri ve XML ekseni özellikleriyle kullanabileceğiniz genel XML ad alanlarını tanımlamak veya işlecine geçirilen parametreler olarak Imports deyimini GetXmlNamespace kullanabilirsiniz. (Kodda tür adlarının kullanıldıklarında kullanıla bir diğer adı içeri aktaran deyimini kullanma hakkında bilgi için Imports bkz. Imports Deyimi (.NET Ad Alanı ve Tür).) deyimini kullanarak bir XML ad alanını bildirime ilişkin Imports söz dizimi, XML'de kullanılan söz dizim ile aynıdır. Bu nedenle, bir XML dosyasından ad alanı bildirimi kopyalayıp deyiminde Imports kullanabilirsiniz.
XML ad alanı ön ekleri, aynı ad alanına sahip XML öğelerini tekrar tekrar oluşturmak istediğiniz zaman kullanışlıdır. deyimiyle bildirilen XML ad alanı Imports ön eki, dosyanın tüm kodlarında kullanılabilir olması için geneldir. BUNU XML öğesi değişmez değişmezleri oluşturma ve XML ekseni özelliklerine erişenler için kullanabilirsiniz. Daha fazla bilgi için bkz. XML Öğesi Değişmez Verileri ve XML Ekseni Özellikleri.
Ad alanı ön eki olmadan genel bir XML ad alanı tanımlarsanız (örneğin), Imports <xmlns="http://SomeNameSpace>" bu ad alanı varsayılan XML ad alanı olarak kabul edilir. Varsayılan XML ad alanı, bir ad alanını açıkça belirtmeden xml öğesi değişmez değerleri veya XML öznitelik ekseni özellikleri için kullanılır. Belirtilen ad alanı boş ad alanı ise de varsayılan ad alanı kullanılır (diğer bir ad xmlns="" alanı). Varsayılan XML ad alanı, XML değişmez değerlerde XML özniteliklerine veya ad alanına sahip olan XML öznitelik ekseni özelliklerine geçerli değildir.
Yerel XML ad alanları olarak adlandırılan bir XML değişmez verisinde tanımlanan XML ad alanları, deyimi tarafından genel olarak tanımlanan XML ad alanlarından Imports önceliklidir. deyimi tarafından tanımlanan XML ad alanları, bir proje Imports için içe aktarılan XML ad alanlarından Visual Basic alır. BIR XML değişmez verisi bir XML ad alanını tanımlarsa, bu yerel ad alanı katıştırılmış ifadeler için geçerli değildir.
Genel XML ad alanları, ad alanlarıyla aynı .NET Framework takip eder. Sonuç olarak, bir xml ad alanını içeri aktarabilirsiniz her Imports yerde genel XML ad alanı tanımlamak için bir deyimi .NET Framework dahil olabilir. Buna hem kod dosyaları hem de proje düzeyinde içe aktarılan ad alanları dahildir. Proje düzeyinde içe aktarılan ad alanları hakkında bilgi için bkz. Başvurular Sayfası, Project Tasarımcısı (Visual Basic).
Her kaynak dosya herhangi bir sayıda Imports deyim içerebilir. Bunlar deyimi gibi seçenek bildirimlerini izlemeli ve veya deyimleri gibi programlama öğesi Option Strict bildirimlerini Module Class izlemeli.
Örnek 1
Aşağıdaki örnek varsayılan XML ad alanını ve ön eki ile tanımlanan bir XML ad alanını içeri ns aktaracaktır. Ardından her iki ad alanını da kullanan XML değişmez verileri oluşturur.
' Place Imports statements at the top of your program.
Imports <xmlns="http://DefaultNamespace">
Imports <xmlns:ns="http://NewNamespace">
Module Module1
Sub Main()
' Create element by using the default global XML namespace.
Dim inner = <innerElement/>
' Create element by using both the default global XML namespace
' and the namespace identified with the "ns" prefix.
Dim outer = <ns:outer>
<ns:innerElement></ns:innerElement>
<siblingElement></siblingElement>
<%= inner %>
</ns:outer>
' Display element to see its final form.
Console.WriteLine(outer)
End Sub
End Module
Bu kod aşağıdaki metni görüntüler:
<ns:outer xmlns="http://DefaultNamespace"
xmlns:ns="http://NewNamespace">
<ns:innerElement></ns:innerElement>
<siblingElement></siblingElement>
<innerElement />
</ns:outer>
Örnek 2
Aşağıdaki örnek XML ad alanı ön eklerini içeri ns aktaracaktır. Ardından ad alanı ön eklerini kullanan ve öğenin son formunu görüntüleyen bir XML değişmez değer oluşturur.
' Place Imports statements at the top of your program.
Imports <xmlns:ns="http://SomeNamespace">
Class TestClass1
Shared Sub TestPrefix()
' Create test using a global XML namespace prefix.
Dim inner2 = <ns:inner2/>
Dim test =
<ns:outer>
<ns:middle xmlns:ns="http://NewNamespace">
<ns:inner1/>
<%= inner2 %>
</ns:middle>
</ns:outer>
' Display test to see its final form.
Console.WriteLine(test)
End Sub
End Class
Bu kod aşağıdaki metni görüntüler:
<ns:outer xmlns:ns="http://SomeNamespace">
<ns:middle xmlns:ns="http://NewNamespace">
<ns:inner1 />
<inner2 xmlns="http://SomeNamespace" />
</ns:middle>
</ns:outer>
Derleyicinin XML ad alanı ön ekinin genel ön ekten yerel ön ek tanımına dönüştürülmesi.
Örnek 3
Aşağıdaki örnek XML ad alanı ön eklerini içeri ns aktaracaktır. Ardından bir XML değişmez değer oluşturmak ve tam adıyla ilk alt düğüme erişmek için ad alanının ön eklerini ns:name kullanır.
Imports <xmlns:ns = "http://SomeNamespace">
Class TestClass4
Shared Sub TestPrefix()
Dim contact = <ns:contact>
<ns:name>Patrick Hines</ns:name>
</ns:contact>
Console.WriteLine(contact.<ns:name>.Value)
End Sub
End Class
Bu kod aşağıdaki metni görüntüler:
Patrick Hines