Bagikan melalui

Pernyataan Impor (Namespace XML)

  • Artikel

Mengimpor awalan kumpulan nama XML untuk digunakan dalam harfiah XML dan properti sumbu XML.

Sintaks

Imports <xmlns:xmlNamespacePrefix = "xmlNamespaceName">

Generator

xmlNamespacePrefix
Opsional. String yang mana elemen dan atribut XML dapat merujuk kexmlNamespaceName. Jika tidak ada xmlNamespacePrefix yang disediakan, kumpulan nama XML yang diimpor adalah kumpulan nama XML default. Harus berupa pengidentifikasi XML yang sah. Untuk informasi selengkapnya, lihat Nama Elemen dan Atribut XML yang Dideklarasikan.

xmlNamespaceName
Harus diisi. String mengidentifikasi kumpulan nama XML yang diimpor.

Keterangan

Anda dapat menggunakan Imports pernyataan tersebut untuk menentukan kumpulan nama XML global yang bisa Anda gunakan dengan harfiah XML dan sumbu properti XML, atau sebagai parameter untuk diteruskan ke GetXmlNamespaceoperator. (Untuk informasi tentang menggunakanImports pernyataan tersebut untuk mengimpor sebuah alias yang dapat digunakan di mana nama jenis digunakan di kode Anda, lihat Mengimpor Pernyataan (.NET kumpulan nama layanan dan Jenis).) Sintaks untuk mendeklarasikan kumpulan nama XML dengan menggunakan Importspernyataan identik dengan sintaks yang digunakan di XML. Oleh karena itu, Anda dapat menyalin deklarasi kumpulan nama dari file XML dan menggunakannya di dalam Importspernyataan.

Awalan kumpulan nama XML berguna ketika Anda ingin berulang kali membuat elemen XML yang berasal dari kumpulan nama yang sama. Awalan kumpulan nama XML yang dideklarasikan dengan Importspernyataan bersifat global dalam arti tersedia untuk semua kode yang ada di dalam file. Anda dapat menggunakannya saat membuat harfiah elemen XML dan ketika Anda mengakses properti sumbu XML. Untuk informasi selengkapnya, lihat Harfiah Elemen XML dan Properti Sumbu XML.

Jika Anda menentukan sebuah kumpulan nama XML tanpa sebuah awalan kumpulan nama (sebagai contoh, Imports <xmlns="http://SomeNameSpace>") kumpulan nama itu dianggap kumpulan nama XML default. Kumpulan nama XML default digunakan untuk harfiah elemen XML apapun atau properti sumbu atribut XML yang tidak secara eksplisit menentukan kumpulan nama. Kumpulan nama default juga digunakan jika kumpulan nama tertentu merupakan kumpulan nama kosong (yaitu, xmlns=""). Kumpulan nama XML default tidak berlaku untuk atribut XML di harfiah XML atau properti sumbu atribut XML yang tidak memiliki kumpulan nama.

Kumpulan nama XML yang ditentukan dalam harfiah XML, yang disebut kumpulan nama XML lokal, lebih diutamakan daripada kumpulan nama XML yang didefinisikan oleh Imports pernyataan sebagai global. Kumpulan nama XML yang ditentukan oleh Imports pernyataan lebih diutamakan daripada kumpulan nama XML yang diimpor untuk proyek Visual Basic. Jika harfiah XML menentukan kumpulan nama XML, kumpulan nama lokal tersebut tidak berlaku untuk ekspresi yang disematkan.

Kumpulan nama XML global mengikuti aturan pelingkupan dan definisi yang sama dengan kumpulan nama .NET Framework. Akibatnya, Anda dapat menyertakan Imports pernyataan untuk menentukan kumpulan nama XML global di mana saja Anda dapat mengimpor kumpulan nama .NET Framework. Ini termasuk file kode dan kumpulan nama tingkat proyek yang diimpor. Untuk informasi tentang kumpulan nama tingkat proyek yang diimpor, lihat Halaman Referensi, Perancang Proyek (Visual Basic).

Setiap file sumber dapat berisi sejumlah Imports pernyataan. Ini harus mengikuti deklarasi opsi, seperti Option Strict pernyataan, dan harus mendahului deklarasi elemen pemrograman, seperti, Module atau Class pernyataan.

Contoh 1

Contoh berikut ini mengimpor kumpulan nama XML default dan kumpulan nama XML yang diidentifikasi dengan awalanns. Kemudian menciptakan harfiah XML yang menggunakan kedua kumpulan nama.

' 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

Kode ini menampilkan teks berikut:

<ns:outer xmlns="http://DefaultNamespace"
          xmlns:ns="http://NewNamespace">
  <ns:innerElement></ns:innerElement>
  <siblingElement></siblingElement>
  <innerElement />
</ns:outer>

Contoh 2

Contoh berikut mengimpor ns sebagai awalan kumpulan nama XML. Kemudian menciptakan harfiah XML yang menggunakan awalan kumpulan nama dan menampilkan bentuk akhir elemen.

' 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

Kode ini menampilkan teks berikut:

<ns:outer xmlns:ns="http://SomeNamespace">
  <ns:middle xmlns:ns="http://NewNamespace">
    <ns:inner1 />
    <inner2 xmlns="http://SomeNamespace" />
  </ns:middle>
</ns:outer>

Perhatikan bahwa penyusun mengonversi awalan kumpulan nama XML dari awalan global ke definisi awalan lokal.

Contoh 3

Contoh berikut mengimpor ns sebagai awalan kumpulan nama XML. Kemudian menggunakan awalan namespace layanan untuk membuat XML harfiah dan mengakses sumbu turunan pertama dengan nama ns:nameyang memenuhi syarat.

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

Kode ini menampilkan teks berikut:

Patrick Hines

Lihat juga