WsdCodeGen 組態檔

  • 發行項

WsdCodeGen 組態檔通常是由 WsdCodeGen 工具產生。 您可以手動建立組態檔，但檔案的複雜度和長度通常排除手寫程式碼。 強烈建議使用 WsdCodeGen 來產生檔案。 如需產生組態檔的詳細資訊，請參閱 使用 WsdCodeGen 和 WsdCodeGen 命令列語法。

您應該檢查產生的組態檔，如有必要，請先修改它，再使用它來建立原始程式碼。 WsdCodeGen 所產生的組態檔通常足以用於大部分的用戶端開發。

若要使用組態檔進行伺服器開發，需要一些修改。 如果啟用裝載 (亦即，如果選取 [全部] 或 [主機] 模式) ，請視需要修改 ThisModelMetadata 元素及其子項目的內容。 此外，視需要修改或移除ThisModelMetadata元素或Hosted元素內的PnPXDeviceCategory、PnPXHardwareId和PnPXCompatibleId元素。

組態檔包含一連串元素，提供程式碼產生的輸入資料，後面接著描述要產生之檔案的任意數目 檔案 元素。 輸入資料包含一些全域屬性，以及以 WSDL、XSD 和 Managed 元件表示的類型參考。 檔案專案中的文字和 CDATA 會寫入產生的檔案，而不需修改。 檔案專案中的其他元素會以產生的程式碼取代產生的檔案中。

XML 組態檔必須遵循一些一般規則，才能正確格式化以便與程式碼產生器公用程式搭配使用。 這些節點為：

  • 任何組態檔的根項目都是 wsdCodeGen。

  • 包含單一資料型別的專案可與屬性交換。 例如：

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

    相當於：

    <wsdCodeGen layerNumber="1"/>

  • 一般而言，元素順序沒有任何條件約束。 例如：

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

    相當於：

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

    不過，程式碼產生器會以單一階段處理組態檔，而排序確實有一些相關性。 例如，產生與特定埠類型相關之程式碼的 檔案 元素必須在指示程式碼產生器讀取埠類型合約的專案之後發生。

如需 WsdCodeGen 組態檔中使用的專案完整清單，請參閱 WsdCodeGen 組態檔 XML 參考。

Windows SDK 隨附範例組態檔。 如需詳細資訊，請參閱 WSDAPI 範例。

關於 WsdCodeGen

WSDAPI 範例