WsdCodeGen Yapılandırma Dosyası

WsdCodeGen yapılandırma dosyası genellikle WsdCodeGen aracı tarafından oluşturulur. Yapılandırma dosyalarını el ile oluşturabilirsiniz, ancak dosyanın karmaşıklığı ve uzunluğu genellikle el ile kodlamanın önüne çıkar. Dosyayı oluşturmak için WsdCodeGen kullanmanızı kesinlikle öneririz. Yapılandırma dosyaları oluşturma hakkında daha fazla bilgi için bkz. WsdCodeGen kullanma ve WsdCodeGen Komut Satırı Sözdizimi.

Oluşturulan yapılandırma dosyasını incelemeniz ve gerekirse kaynak kodu oluşturmak için kullanmadan önce değiştirmeniz gerekir. WsdCodeGen tarafından oluşturulan yapılandırma dosyası genellikle çoğu istemci geliştirmesi için yeterlidir.

Sunucu geliştirme için yapılandırma dosyasını kullanmak için bazı değişiklikler gereklidir. Barındırma etkinse (örneğin, "tümü" veya "ana bilgisayar" modu seçiliyse), ThisModelMetadataöğesinin ve alt öğelerininiçeriğini gerektiği gibi değiştirin. Ayrıca, PnPXDeviceCategory, PnPXHardwareIdve ThisModelMetadata öğesi içindeki PnPXCompatibleId öğelerini veya Barındırılan öğelerini gerektiği şekilde değiştirin veya kaldırın.

Yapılandırma dosyası, kod oluşturma için giriş verileri sağlayan ve ardından oluşturulacak dosyaları açıklayan çeşitli dosya öğelerden oluşan bir dizi öğeden oluşur. Giriş verileri, WSDL, XSD ve yönetilen derlemelerde ifade edilen türlere yönelik birkaç genel özellik ve başvuru içerir. dosya öğelerindeki metin ve CDATA, oluşturulan dosyalara değiştirilmeden yazılır. dosya öğelerindeki diğer öğeler, oluşturulan dosyalarda oluşturulan kodla değiştirilir.

XML yapılandırma dosyalarının kod oluşturucu yardımcı programıyla kullanılmak üzere düzgün biçimlendirilebilmesi için birkaç genel kurala uyması gerekir. Bunlar şunlardır:

  • Herhangi bir yapılandırma dosyasının kök öğesi wsdCodeGen.

  • Basit veri türleri içeren öğeler özniteliklerle değiştirilebilir. Mesela:

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

    eşdeğerdir:

    <wsdCodeGen layerNumber="1"/>
    
  • Genel olarak, öğelerin sıralanmasında bir kısıtlama yoktur. Mesela:

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

    eşdeğerdir:

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

    Ancak, kod oluşturucu yapılandırma dosyasını tek bir geçişte işler ve sıralamanın biraz ilgisi vardır. Örneğin, belirli bir bağlantı noktası türüyle ilgili kod oluşturan dosya öğeleri, kod oluşturucuya bağlantı noktası türü sözleşmesini okumasını belirten öğeden sonra gerçekleşmelidir.

WsdCodeGen yapılandırma dosyalarında kullanılan öğelerin tam listesi için bkz. WsdCodeGen Yapılandırma Dosyası XML Başvurusu.

Örnek yapılandırma dosyaları Windows SDK'sı ile birlikte sunulur. Daha fazla bilgi için bkz. WSDAPI Örnekleri.

WsdCodeGen Hakkında

WSDAPI Örnekleri