共用方式為


WsdCodeGen 組態檔

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

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

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

組態檔包含一連串元素,提供程式碼產生的輸入資料,後面接著描述要產生之檔案的任意數目 檔案 元素。 輸入資料包含一些全域屬性,以及以 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 範例