Bagikan melalui

File Konfigurasi WsdCodeGen

  • Artikel

File konfigurasi WsdCodeGen biasanya dihasilkan oleh alat WsdCodeGen. Anda dapat membuat file konfigurasi secara manual, tetapi kompleksitas dan panjang file biasanya menghalangi pengodean tangan. Kami sangat menyarankan penggunaan WsdCodeGen untuk menghasilkan file. Untuk informasi selengkapnya tentang membuat file konfigurasi, lihat Menggunakan WsdCodeGen dan Sintaks Baris Perintah WsdCodeGen.

Anda harus memeriksa file konfigurasi yang dihasilkan, dan jika perlu, ubah sebelum menggunakannya untuk membuat kode sumber. File konfigurasi yang dihasilkan oleh WsdCodeGen biasanya cukup untuk sebagian besar pengembangan klien.

Untuk menggunakan file konfigurasi untuk pengembangan server, diperlukan beberapa modifikasi. Jika hosting diaktifkan (yaitu, jika mode "semua" atau "host" dipilih), ubah konten elemen ThisModelMetadata dan elemen turunannya seperlunya. Selain itu, ubah atau hapus elemen PnPXDeviceCategory, PnPXHardwareId, dan PnPXCompatibleId di dalam elemen ThisModelMetadata atau elemen Hosted seperlunya.

File konfigurasi terdiri dari urutan elemen yang menyediakan data input untuk pembuatan kode diikuti oleh sejumlah elemen file yang menjelaskan file yang akan dihasilkan. Data input mencakup beberapa properti global dan referensi ke jenis yang dinyatakan dalam WSDL, XSD, dan rakitan terkelola. Teks dan CDATA dalam elemen file ditulis ke file yang dihasilkan tanpa modifikasi. Elemen lain dalam elemen file diganti dalam file yang dihasilkan dengan kode yang dihasilkan.

File konfigurasi XML harus mengikuti beberapa aturan umum agar diformat dengan benar untuk digunakan dengan utilitas generator kode. Ini adalah:

  • Elemen akar dari file konfigurasi apa pun adalah wsdCodeGen.

  • Elemen yang berisi jenis data sederhana dapat dipertukarkan dengan atribut. Contohnya:

    <wsdCodeGen>
    <layerNumber>1</layerNumber>
</wsdCodeGen>

    setara dengan:

    <wsdCodeGen layerNumber="1"/>

  • Secara umum, tidak ada batasan pada urutan elemen. Contohnya:

    <wsdCodeGen>
    <layerNumber>1</layerNumber>
    <layerPrefix>MEDIA_</layerPrefix>
</wsdCodeGen>

    setara dengan:

    <wsdCodeGen>
    <layerPrefix>MEDIA_</layerPrefix>
    <layerNumber>1</layerNumber>
</wsdCodeGen>

    Namun, generator kode memproses file konfigurasi dalam satu pass, dan pemesanan memang memiliki beberapa relevansi. Misalnya, elemen file yang menghasilkan kode yang berkaitan dengan jenis port tertentu harus terjadi setelah elemen yang menginstruksikan generator kode untuk membaca kontrak jenis port.

Untuk daftar lengkap elemen yang digunakan dalam file konfigurasi WsdCodeGen, lihat Referensi XML File Konfigurasi WsdCodeGen.

File konfigurasi sampel disertakan dengan Windows SDK. Untuk informasi selengkapnya, lihat Sampel WSDAPI.

Tentang WsdCodeGen

Sampel WSDAPI