工作 3：建立長期服務用戶端

發行項
09/12/2008

在這個工作中，您將建立簡易的用戶端以叫用您的長期服務上的作業。測試工具 WcfTestClient.exe 由 WCF 服務程式庫範本使用。

建立用戶端

在 SimpleDurableService 方案中，以滑鼠右鍵按一下 [方案總管] 窗格中的方案節點。
巡覽至 [新增]，然後選取 [新增專案]。
在 [新增專案] 對話方塊中，在 [Windows] 下選取 [主控台應用程式]。
將您的專案命名為 DurableServiceTestClient，然後按一下 [確定]。
以滑鼠右鍵按一下 DurableServiceTestClient 專案節點，然後選取 [加入參考]。
在 [加入參考] 對話方塊中，在 [.NET] 索引標籤中，選取 [System.ServiceModel] 組件，然後按一下 [確定]。
將下列 using 陳述式加入至您的 C# 原始程式檔：

如果您建立 Visual Basic 方案，請以滑鼠右鍵按一下 DurableServiceTestClient 專案節點，然後選取 [屬性]。選取 [參考] 索引標籤，在 [匯入的命名空間] 下核取 [System.ServiceModel]。

使用 SvcUtil.exe 產生您長期服務所需的 Proxy 程式碼和組態檔。
使用 SvcUtil.exe
若要使用 SvcUtil.exe，請參閱 ServiceModel Metadata Utility Tool。
產生 Proxy 程式碼與組態檔之後，執行下列操作，將那些檔案新增至您的 DurableServiceTestClient 專案中：
1. 巡覽至 [方案總管] 窗格。
2. 以滑鼠右鍵按一下 [DurableServiceTestClient] 專案節點。
3. 反白顯示 [新增] 並選取 [現有項目]。
4. 巡覽至 SvcUtil.exe 產生之組態檔和 Proxy 程式碼檔案所在的資料夾。
5. 選取檔案，然後按一下 [確定]。
6. 如果組態檔名稱不是 App.config，請將它重新命名為 App.config。
將下列程式碼加入您的 Main 方法實作：

長期服務用戶端的建立方式和一般 WCF 服務用戶端相同。用戶端的新執行個體會依據服務的 Proxy 程式碼建立。接下來會進行對 Open 的呼叫，接著就會叫用服務作業。最後，會進行對 Close 的呼叫，以關閉用戶端。

若要使用這個用戶端搭配您在 SimpleDurableService 方案中的長期服務，則必須由 SimpleDurableService 專案屬性中刪除命令列引數。若要這麼做，請執行下列步驟：
1. 以滑鼠右鍵按一下 [SimpleDurableService] 專案節點，然後選取 [屬性]。
2. 選取 [偵錯] 索引標籤，然後在 [起始選項] 下的詳細資料窗格中，將 /client:"WfcTestClient.exe" 從文字方塊中移除。
以滑鼠右鍵按一下 [SimpleDurableService] 方案節點，然後選取 [屬性]。
在 [屬性頁] 對話方塊中，選取 [多個啟始專案]。
如果 SimpleDurableService 不是清單中的第一個項目，請使用清單方塊旁邊的箭號將它移到清單中的第一個項目。這是必要的動作，可讓您的服務先開始執行，然後用戶端應用程式再嘗試針對服務叫用任何作業。
對於清單中的每個專案，將動作從 [無] 變更為 [開始]。
按一下 [套用]，然後按一下 [確定]。
建置服務和用戶端專案。您可以將長期服務裝載於 IIS 中、Windows 應用程式中，或任何其他主機處理序中，但為了用於本教學課程，請裝載於 WfcSvcHost.exe 中。WcfSvcHost.exe 是一種開發人員工具，可裝載用於測試用途的服務。
在用戶端命令列介面的輸出中，應該會出現下列內容：
```
The current value is 3
The current value is -1
The current value is -5
Press <ENTER> to shut down the client.
```
在每次作業後 (除了 EndPersistence 以外) 觀察是否有發生保存的方法之一，是從 https://www.microsoft.com/downloads 安裝 Microsoft SQL Server Management Studio Express，然後在您的整個用戶端應用程式中設定偵錯點。您點擊這些點後，觀察 NetFx35Samples_DurableServiceStore 資料庫中的 InstanceData 表格。您應該會看到在表格中加入了新的項目，然後在每個作業之後都會更新，直到 EndPersistence 呼叫完成，此時這個表格項目就會移除。
另一個觀察長期服務之值的方法，是由您的用戶端對服務做首次作業叫用，然後在 Visual Studio 中對作業叫用放置中斷點。在執行第三個作業叫用前，關閉服務並重新啟動服務。現在進行作業叫用。服務的狀態現在會由持續性資料庫還原，且您將可以看到服務回覆您所想要的目前值。

請參閱

工作

工作 1：定義和實作長期服務合約
 工作 2：啟用長期服務的持續性

其他資源

教學課程：建立長期服務

共用方式為

工作 3：建立長期服務用戶端

建立用戶端

請參閱

工作

其他資源

其他資源