XmlNamespaceManager Kelas

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlNamespacemanager.cs

Mengatasi, menambahkan, dan menghapus namespace ke koleksi dan menyediakan manajemen cakupan untuk namespace ini.

public ref class XmlNamespaceManager : System::Collections::IEnumerable, System::Xml::IXmlNamespaceResolver

public class XmlNamespaceManager : System.Collections.IEnumerable, System.Xml.IXmlNamespaceResolver

type XmlNamespaceManager = class
    interface IEnumerable
    interface IXmlNamespaceResolver

Public Class XmlNamespaceManager
Implements IEnumerable, IXmlNamespaceResolver

Warisan

Object

XmlNamespaceManager

Turunan

System.Windows.Data.XmlNamespaceMappingCollection

System.Xml.Xsl.XsltContext

Penerapan

IEnumerable IXmlNamespaceResolver

Keterangan

Untuk informasi umum tentang bagaimana namespace dinyatakan dan digunakan dalam dokumen XML, lihat Mengelola Namespace dalam Dokumen XML.

XmlNamespaceManager menyimpan awalan dan namespace sebagai string. Berikut adalah ringkasan tugas manajemen dan pencarian yang dapat Anda lakukan dengan kelas ini. Untuk informasi dan contoh selengkapnya, ikuti tautan ke halaman referensi untuk setiap metode atau properti.

Untuk	Menggunakan
Menambahkan namespace	metode AddNamespace
Menghapus namespace layanan	metode RemoveNamespace
Temukan URI untuk namespace default	Properti DefaultNamespace
Menemukan URI untuk awalan namespace	metode LookupNamespace
Temukan prefix untuk sebuah URI namespace	metode LookupPrefix
Dapatkan daftar namespace di simpul saat ini	metode GetNamespacesInScope
Cakupan namespace layanan	metode PushScope dan PopScope
Periksa apakah prefiks ditentukan dalam cakupan saat ini	metode HasNamespace
Dapatkan tabel nama yang digunakan untuk mencari awalan dan URI	Properti NameTable

Untuk menambahkan namespace ke pengelola namespace, Anda membuat XmlNamespaceManager objek lalu menggunakan metode .AddNamespace Pasangan awalan dan namespace default secara otomatis ditambahkan ke pengelola namespace saat dibuat.

Saat membuat pengelola namespace, Anda dapat menentukan tabel nama dari XmlReaderkelas , , XsltContextatau XmlDocument , lalu menggunakan AddNamespace metode untuk menambahkan namespace layanan.

Anda dapat menyediakan XmlNamespaceManager objek sebagai parameter ke SelectNodes metode XmlDocument atau SelectSingleNode kelas untuk menjalankan ekspresi kueri XPath yang mereferensikan elemen dan nama atribut yang memenuhi syarat namespace layanan.

Manajer namespace mengasumsikan bahwa awalan dan namespace telah diverifikasi dan sesuai dengan spesifikasi Namespace W3C . Pengelola namespace tidak melakukan validasi apa pun.

Manajer namespace mengotomatiskan string saat ditambahkan dengan menggunakan AddNamespace metode dan ketika pencarian dilakukan dengan menggunakan LookupNamespace metode atau LookupPrefix .

Pengelola namespace mengimplementasikan dukungan enumerasi selain menambahkan dan mengambil namespace. Anda dapat mengulang informasi yang disimpan di pengelola namespace dengan menggunakan foreach konstruksi. Misalnya, jika Anda membuat pengelola namespace dengan nama nsmanager, Anda dapat melakukan iterasi melalui tabel dengan menggunakan foreach (String prefix in nsmanager).

Karena pengelola namespace menyediakan perbandingan string dengan awalan dan namespace sebagai objek, ada peningkatan performa saat menggunakan manajer namespace layanan melalui perbandingan langsung string.

Contoh kode berikut menunjukkan cara mengikat awalan xsdhttp://www.w3.org/2001/XMLSchema dengan URI namespace layanan dan menambahkannya ke pengelola namespace:

nsmgr.AddNamespace("xsd", "http://www.w3.org/2001/XMLSchema")

nsmgr.AddNamespace("xsd", "http://www.w3.org/2001/XMLSchema");

Anda kemudian dapat menemukan namespace layanan dengan menggunakan LookupNamespace metode :

nsmgr.LookupNamespace("xsd")

nsmgr.LookupNamespace("xsd");

Contoh berikut membuat XmlNamespaceManager dengan menggunakan tabel nama dari pembaca XML:

Dim reader As New XmlTextReader("myfile.xml")
Dim nsmanager As New XmlNamespaceManager(reader.NameTable)
nsmanager.AddNamespace("msbooks", "www.microsoft.com/books")
nsmanager.PushScope()
nsmanager.AddNamespace("msstore", "www.microsoft.com/store")
While reader.Read()
    Console.WriteLine("Reader Prefix:{0}", reader.Prefix)
    Console.WriteLine("XmlNamespaceManager Prefix:{0}",
     nsmanager.LookupPrefix(nsmanager.NameTable.Get(reader.NamespaceURI)))
End While

XmlTextReader reader = new XmlTextReader("myfile.xml");
XmlNamespaceManager nsmanager = new XmlNamespaceManager(reader.NameTable);
nsmanager.AddNamespace("msbooks", "www.microsoft.com/books");
nsmanager.PushScope();
nsmanager.AddNamespace("msstore", "www.microsoft.com/store");
while (reader.Read())
{
    Console.WriteLine("Reader Prefix:{0}", reader.Prefix);
    Console.WriteLine("XmlNamespaceManager Prefix:{0}",
    nsmanager.LookupPrefix(nsmanager.NameTable.Get(reader.NamespaceURI)));
}

Konstruktor

Nama	Deskripsi
XmlNamespaceManager(XmlNameTable)	Menginisialisasi instans baru kelas XmlNamespaceManager dengan XmlNameTableyang ditentukan .

Properti

Nama	Deskripsi
DefaultNamespace	Mendapatkan URI namespace layanan untuk namespace default.
NameTable	Mendapatkan yang XmlNameTable terkait dengan objek ini.

Metode

Nama	Deskripsi
AddNamespace(String, String)	Menambahkan namespace yang diberikan ke koleksi.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetEnumerator()	Mengembalikan enumerator yang akan digunakan untuk melakukan iterasi melalui namespace di XmlNamespaceManager.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetNamespacesInScope(XmlNamespaceScope)	Mendapatkan kumpulan nama namespace yang dikunci oleh awalan, yang dapat digunakan untuk menghitung namespace layanan yang saat ini berada dalam cakupan.
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
HasNamespace(String)	Mendapatkan nilai yang menunjukkan apakah awalan yang disediakan memiliki namespace yang ditentukan untuk cakupan yang didorong saat ini.
LookupNamespace(String)	Mendapatkan URI namespace layanan untuk awalan yang ditentukan.
LookupPrefix(String)	Menemukan awalan yang dideklarasikan untuk URI namespace yang diberikan.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
PopScope()	Memunculkan cakupan namespace dari tumpukan.
PushScope()	Mendorong cakupan namespace ke tumpukan.
RemoveNamespace(String, String)	Menghapus namespace yang diberikan untuk awalan yang diberikan.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Metode Ekstensi

Nama	Deskripsi
AsParallel(IEnumerable)	Mengaktifkan paralelisasi kueri.
AsQueryable(IEnumerable)	Mengonversi IEnumerable menjadi IQueryable.
Cast<TResult>(IEnumerable)	Melemparkan elemen IEnumerable ke jenis yang ditentukan.
OfType<TResult>(IEnumerable)	Memfilter elemen IEnumerable berdasarkan jenis tertentu.

Lihat juga

• Dokumen dan Data XML
• Mengelola Namespace dalam Dokumen XML