Imports Deyimi (XML Ad Alanı)

  • Makale

XML değişmez değerleri ve XML ekseni özelliklerinde kullanılmak üzere XML ad alanı ön eklerini içeri aktarır.

Sözdizimi

Imports <xmlns:xmlNamespacePrefix = "xmlNamespaceName">

Parça

xmlNamespacePrefix
isteğe bağlı. XML öğelerinin ve özniteliklerinin başvurabileceği xmlNamespaceNamedize. Sağlanmamışsa xmlNamespacePrefix , içeri 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
Gerekli. İçeri aktarılan XML ad alanını tanımlayan dize.

Açıklamalar

DEYIMIni Imports , XML değişmez değerleri ve XML ekseni özellikleriyle kullanabileceğiniz genel XML ad alanlarını tanımlamak için veya işlecine GetXmlNamespace geçirilen parametreler olarak kullanabilirsiniz. (Kodunuzda tür adlarının kullanıldığı bir diğer adı içeri aktarmak için deyimini Imports kullanma hakkında bilgi için bkz . Imports Deyimi (.NET Ad Alanı ve Türü).) deyimini kullanarak Imports XML ad alanını bildirme söz dizimi, XML'de kullanılan söz dizimi ile aynıdır. Bu nedenle, xml dosyasından bir ad alanı bildirimi kopyalayabilir ve bunu bir Imports deyiminde kullanabilirsiniz.

XML ad alanı ön ekleri, aynı ad alanından gelen XML öğelerini tekrar tekrar oluşturmak istediğinizde kullanışlıdır. deyimiyle Imports bildirilen XML ad alanı ön eki, dosyadaki tüm kodlar için kullanılabilir olması anlamında geneldir. XML öğesi değişmez değerleri oluştururken ve XML ekseni özelliklerine erişirken bunu kullanabilirsiniz. Daha fazla bilgi için bkz. XML Öğesi Değişmez Değeri ve XML Ekseni Özellikleri.

Ad alanı ön eki olmayan bir genel 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ı, açıkça ad alanı belirtmeyen tüm XML öğesi değişmez değerleri veya XML öznitelik ekseni özellikleri için kullanılır. Belirtilen ad alanı boş ad alanıysa (yani ) xmlns=""varsayılan ad alanı da kullanılır. Varsayılan XML ad alanı, XML değişmez değerlerindeki XML özniteliklerine veya ad alanına sahip olmayan XML öznitelik ekseni özelliklerine uygulanmaz.

Yerel XML ad alanları olarak adlandırılan bir XML değişmez değeri içinde tanımlanan XML ad alanları, deyimi tarafından Imports genel olarak tanımlanan XML ad alanlarına göre önceliklidir. deyimi tarafından Imports tanımlanan XML ad alanları, Visual Basic projesi için içeri aktarılan XML ad alanlarına göre önceliklidir. XML değişmez değeri bir XML ad alanını tanımlarsa, bu yerel ad alanı katıştırılmış ifadelere uygulanmaz.

Genel XML ad alanları, .NET Framework ad alanlarıyla aynı kapsam ve tanım kurallarını izler. Sonuç olarak, .NET Framework ad alanını içeri aktarabileceğiniz her yerde genel XML ad alanı tanımlamak için bir deyim ekleyebilirsiniz Imports . Buna hem kod dosyaları hem de proje düzeyinde içeri aktarılan ad alanları dahildir. Proje düzeyinde içeri aktarılan ad alanları hakkında bilgi için bkz. Başvurular Sayfası, Project Tasarım Aracı (Visual Basic).

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

Örnek 1

Aşağıdaki örnek, ön ekiyle nstanımlanan bir varsayılan XML ad alanını ve XML ad alanını içeri aktarır. Ardından her iki ad alanını da kullanan XML değişmez değerleri 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 ekini nsiçeri aktarır. Ardından ad alanı ön ekini kullanan ve öğenin son formunu görüntüleyen bir XML değişmez değeri 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 ekini genel ön ekten yerel ön ek tanımına dönüştürdüğüne dikkat edin.

Örnek 3

Aşağıdaki örnek XML ad alanı ön ekini nsiçeri aktarır. Ardından ad alanının ön ekini kullanarak bir XML değişmez değeri oluşturur ve nitelenmiş adıyla ns:nameilk alt düğüme erişir.

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

Ayrıca bkz.