在配接器開發期間,或從 LOB 系統傳回的元數據變更時,檢視從配接器傳回的 Web 服務描述語言 (WSDL) 通常會很有用,以確認作業的元數據已正確產生。 有數種方法可以產生 WSDL。 本主題提供使用 svcutil.exe 和元數據搜尋流覽控件的相關信息。
使用 svcutil.exe
Svcutil.exe 是隨附於 Windows SDK 的命令行公用程式,可接受 URL 和選擇性參數,並傳回 WSDL。 以下是使用 svcutil.exe 傳回 Echo 配接器 WSDL 的範例:
Svcutil.exe “echov2://lobhostname/lobapplication?enableAuthentication=False” /target:metadata
這會將元數據儲存為 Microsoft.Adapters.Samples.Echov2.wsdl。 如果您的配接器有許多作業,您可以選擇只使用 'op=OperationName' 作為 URI 的一部分傳回所需的作業。 以下是使用這個 只傳回 EchoStrings 資訊的範例:
SvcUtil.exe “echov2://lobhostname/lobapplication?enableAuthentication=False&op=Echo/EchoStrings” /target:metadata
使用元數據搜尋瀏覽控制項
元數據搜尋與瀏覽控制項是在 WCF LOB 配接器 SDK 中包含的精靈中使用的 Windows 控制項。 您可以將此控件新增至 Visual Studio 中的任何 Windows Forms 專案,並使用它來選取配接器、所需的作業,然後產生 WSDL。
開啟 Visual Studio 命令提示字元。
在 [ 檔案] 功能表上,選取 [ 新增],然後按兩下 [ 專案]。
在 [新增專案] 對話框中,從 [範本] 中選取 [Windows 應用程式]。 輸入專案名稱,然後按兩下 [ 確定]。
開啟 [工具箱],展開 [ 通用控件],以滑鼠右鍵按兩下 [工具箱],然後按兩下 [ 選擇專案]。
在 [選擇工具箱專案] 對話框中,在 [.NET Framework 元件] 索引卷標上尋找 MetadataUserControl,選取此專案旁邊的複選框,然後按兩下 [確定]。
從 [工具箱] 將 MetadataUserControl 拖曳至 Form1。 您可能需要調整表單的大小,才能看到整個控件。 您現在應該能夠執行專案,並確認控件是否正常運作,讓您能夠選取配接器和作業。
若要使用此控件產生 WSDL,您必須將程式代碼新增至表單,以呼叫此控制件的 GetWsdl 方法。 下列範例示範如何呼叫 GetWsdl 並將數據儲存至檔案:
private void button1_Click(object sender, EventArgs e) { ServiceDescription sd = mdUserControl.GetWsdl(); FileStream myFileStream = new FileStream(tbWsdlFileName.Text, FileMode.OpenOrCreate, FileAccess.Write); StreamWriter myStreamWriter = new StreamWriter(myFileStream); sd.Write(myStreamWriter); myStreamWriter.Flush(); myStreamWriter.Close(); MessageBox.Show("WSDL file " + tbWsdlFileName.Text + " is created."); }