Bagikan melalui

Pernyataan Impor (Namespace XML)

Mengimpor prefiks namespace XML untuk digunakan dalam properti literal XML dan sumbu XML.

Sintaksis

Imports <xmlns:xmlNamespacePrefix = "xmlNamespaceName">

Bagian

xmlNamespacePrefix
Fakultatif. String tempat elemen dan atribut XML dapat merujuk ke xmlNamespaceName. Jika tidak ada xmlNamespacePrefix yang disediakan, namespace XML yang diimpor adalah namespace XML default. Harus merupakan pengidentifikasi XML yang valid. Untuk informasi selengkapnya, lihat Nama Elemen dan Atribut XML yang Dideklarasikan.

xmlNamespaceName
Dibutuhkan. String yang mengidentifikasi namespace XML yang sedang diimpor.

Komentar

Anda dapat menggunakan Imports pernyataan untuk menentukan namespace XML global yang bisa Anda gunakan dengan properti literal XML dan sumbu XML, atau sebagai parameter yang diteruskan ke GetXmlNamespace operator. (Untuk informasi tentang menggunakan Imports pernyataan untuk mengimpor alias yang dapat digunakan di mana nama jenis digunakan dalam kode Anda, lihat Pernyataan Impor (.NET Namespace dan Jenis).) Sintaks untuk mendeklarasikan namespace XML dengan menggunakan Imports pernyataan identik dengan sintaks yang digunakan dalam XML. Oleh karena itu, Anda dapat menyalin deklarasi namespace layanan dari file XML dan menggunakannya dalam pernyataan Imports .

Awalan namespace XML berguna saat Anda ingin berulang kali membuat elemen XML yang berasal dari namespace yang sama. Awalan namespace XML yang dideklarasikan dengan Imports pernyataan bersifat global dalam arti tersedia untuk semua kode dalam file. Anda dapat menggunakannya saat membuat literal elemen XML dan saat Anda mengakses properti sumbu XML. Untuk informasi selengkapnya, lihat Properti Literal Elemen XML dan Sumbu XML.

Jika Anda menentukan namespace XML global tanpa awalan namespace (misalnya, Imports <xmlns="http://SomeNameSpace>"), namespace layanan tersebut dianggap sebagai namespace XML default. Namespace XML default digunakan untuk setiap literal elemen XML atau properti sumbu atribut XML yang tidak secara eksplisit menentukan namespace. Namespace default juga digunakan jika namespace yang ditentukan adalah namespace kosong (yaitu, xmlns=""). Namespace XML default tidak berlaku untuk atribut XML dalam literal XML atau ke properti sumbu atribut XML yang tidak memiliki namespace.

Namespace XML yang ditentukan dalam xml literal, yang disebut namespace XML lokal, lebih diutamakan daripada namespace XML yang didefinisikan oleh Imports pernyataan sebagai global. Namespace XML yang ditentukan oleh Imports pernyataan lebih diutamakan daripada namespace XML yang diimpor untuk proyek Visual Basic. Jika XML literal menentukan namespace XML, namespace layanan lokal tersebut tidak berlaku untuk ekspresi yang disematkan.

Namespace XML global mengikuti aturan cakupan dan definisi yang sama dengan namespace .NET Framework. Akibatnya, Anda dapat menyertakan Imports pernyataan untuk menentukan namespace XML global di mana saja Anda dapat mengimpor namespace .NET Framework. Ini termasuk file kode dan namespace layanan impor tingkat proyek. Untuk informasi tentang namespace layanan impor tingkat proyek, 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 pernyataan atau Class .

Contoh 1

Contoh berikut mengimpor namespace XML default dan namespace XML yang diidentifikasi dengan awalan ns. Kemudian membuat literal XML yang menggunakan kedua namespace layanan.

' 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 awalan nsnamespace XML . Kemudian membuat xml literal yang menggunakan awalan namespace layanan dan menampilkan formulir 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 pengkompilasi mengonversi awalan namespace XML dari awalan global ke definisi awalan lokal.

Contoh 3

Contoh berikut mengimpor awalan nsnamespace XML . Kemudian menggunakan awalan namespace layanan untuk membuat XML harfiah dan mengakses simpul anak 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

  • Last updated on