Bagikan melalui

Kelas System.Runtime.Serialization.XsdDataContractExporter

  • Artikel

Artikel ini menyediakan keterangan tambahan untuk dokumentasi referensi untuk API ini.

XsdDataContractExporter Gunakan kelas saat Anda telah membuat layanan Web yang menggabungkan data yang diwakili oleh jenis runtime bahasa umum (CLR) dan kapan Anda perlu mengekspor skema XML untuk setiap jenis yang akan digunakan oleh layanan Web lainnya. Artinya, XsdDataContractExporter mengubah sekumpulan jenis CLR menjadi skema XML. (Untuk informasi selengkapnya tentang jenis yang dapat digunakan, lihat Jenis yang Didukung oleh Serializer Kontrak Data.) Skema kemudian dapat diekspos melalui dokumen Web Services Description Language (WSDL) untuk digunakan oleh orang lain yang perlu beroperasi dengan layanan Anda.

Sebaliknya, jika Anda membuat layanan Web yang harus beroperasi dengan layanan Web yang ada, gunakan XsdDataContractImporter untuk mengubah skema XML dan membuat jenis CLR yang mewakili data dalam bahasa pemrograman yang dipilih.

XsdDataContractExporter menghasilkan XmlSchemaSet objek yang berisi kumpulan skema. Akses set skema melalui Schemas() properti .

Catatan

Untuk menghasilkan file definisi skema XML (XSD) dengan cepat yang dapat digunakan layanan Web lainnya, gunakan XsdDataContractExporter.

Mengekspor skema ke xmlSchemaSet

Untuk membuat instans XmlSchemaSet kelas yang berisi file skema XML, Anda harus mengetahui hal berikut.

Kumpulan jenis yang Anda ekspor dicatat sebagai kumpulan kontrak data internal. Dengan demikian, Anda dapat memanggil CanExport metode beberapa kali untuk menambahkan jenis baru ke set skema tanpa menurunkan performa karena hanya jenis baru yang akan ditambahkan ke set. Export Selama operasi, skema yang ada dibandingkan dengan skema baru yang ditambahkan. Jika ada konflik, pengecualian akan dilemparkan. Konflik biasanya terdeteksi jika dua jenis dengan nama kontrak data yang sama tetapi kontrak yang berbeda (anggota yang berbeda) diekspor oleh instans yang sama XsdDataContractExporter .

Menggunakan pengekspor

Cara yang direkomendasikan untuk menggunakan kelas ini adalah sebagai berikut:

  1. Gunakan salah CanExport satu kelebihan beban untuk menentukan apakah jenis atau set jenis yang ditentukan dapat diekspor. Gunakan salah satu kelebihan beban yang sesuai dengan kebutuhan Anda.

  2. Panggil metode yang Export sesuai.

  3. Ambil skema dari Schemas properti .