共用方式為

WsdCodeGen 組態檔

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

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

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

組態檔是由一系列元素所組成，這些元素會提供程式代碼產生的輸入數據，後面接著任何數目的 檔案， 描述要產生的檔案。 輸入數據包含一些全域屬性，以及 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 範例

 

 

  • Last updated on