逐步解說：連接至 Web 服務中的資料 (Windows Form)

發行項
08/12/2011

本逐步解說說明如何使用資料來源組態精靈將您的應用程式連接至 Web 服務。您將連接至 Live Search Web 服務，並從應用程式執行搜尋查詢。接著在 Windows Form 顯示從服務所傳回的資料 (搜尋結果)。

逐步解說將說明的工作包括：

建立新的 [Windows 應用程式] 專案。
將服務參考加入至應用程式 (連接至 Live Search 服務)。
加入用來執行搜尋查詢的控制項 (服務所公開的呼叫方法)。
撰寫存取服務及傳回資料的程式碼。
將服務傳回的資料繫結至 BindingSource。
在格線中顯示從服務傳回的資料。

取得 AppID

來自 Live Search 的 AppID 為免費提供，可對 Live Search 服務唯一識別您的應用程式。 AppID 為存取此服務所需。

若要取得 AppID

巡覽至 http://search.live.com/developer 並取得免費 AppID

注意事項
AppID 可能需要一些時間 (30-60 分鐘) 才能完成服務驗證。如果您在這段時間內執行應用時遇到一般的「用戶端錯誤」，AppID 可能仍在 Live Search 伺服器上啟用中。

建立專案

若要建立新專案

從 [檔案] 功能表中，建立新專案。
選取 [Windows Form 應用程式]，並為它命名為 WebServiceWalkthrough。
按一下 [確定]。

建立專案並將其加入至 [方案總管]。

連接至服務

執行 [資料來源組態精靈] 來連接至 Web 服務。

若要連接至 Live Search Web 服務

按一下 [資料] 功能表上的 [顯示資料來源]。
在 [資料來源] 視窗中，選取 [加入新資料來源]。
選取 [選擇資料來源類型] 頁面上的 [服務]，再按 [下一步]。
在 [加入服務參考] 對話方塊的 [URL] 方塊中，輸入 https://soap.search.msn.com/webservices.asmx?wsdl。
按一下 [移至]。
找到 Web 服務之後，將命名空間變更為：LiveSearchService。
按一下 [確定]，然後按一下 [完成]，將服務參考加入至專案。

服務參考隨即加入至專案，而且 [資料來源] 視窗會根據服務所傳回的項目來填入。

注意事項
因為不同的 Web 服務會公開不同的功能，本逐步解說中的後續步驟是 Live Search Web 服務專用。若要使用從服務傳回的資料，一般程序是建立服務的執行個體，接著呼叫服務所公開的方法。從 [資料來源] 視窗拖曳項目之後，您的表單應該包含 BindingSource 元件；請將 DataSource 屬性設為服務所傳回的資料。

建立 DataGridView 以顯示從服務傳回的資料

從 [資料來源] 視窗將項目拖曳至表單上，藉以建立資料繫結的資料格。加入格線之後，將資料行設定為只顯示您想要呈現的資料行。接著將 Url 資料行設為連結，讓使用者可以按一下 URL 並巡覽至搜尋查詢所傳回的網站。

若要建立資料繫結的 DataGridView

在 [資料來源] 視窗中，展開 [SearchResponse] 節點。
展開 [Responses] 節點。
將 [Results] 節點拖曳至表單上。

DataGridView、BindingSource 和 BindingNavigator 隨即加入至表單。
選取已加入至表單的 resultsDataGridView。
在 [屬性] 視窗中選取 [Columns] 屬性，然後按一下省略符號 (...) 開啟編輯資料行對話方塊 (設計檢視)。
選取 [URL] 資料行並進行下列設定：
1. 將 ColumnType 屬性設為 DataGridViewLinkColumn。
2. 將 AutoSizeMode 屬性設為 AllCells。
除了 [標題]、[描述] 和 [Url] 資料行之外，移除所有資料行。
按一下 [確定]。

加入用來輸入搜尋準則及執行搜尋查詢的控制項

將用來執行搜尋查詢的控制項加入至現有的 Toolstrip。

若要將文字方塊和按鈕加入至表單

以滑鼠右鍵按一下表單 Toolstrip 上的灰色磁碟圖示，選取 [插入] 並接著選取 TextBox。
在 [屬性] 視窗中，將 [Name] 屬性設定為 searchCriteriaTextBox。
將 [Text] 屬性設定為 Visual Studio。
將 Button 控制項加入至 Toolstrip，並且將它命名為 searchButton。
在 [屬性] 視窗中，將 [DisplayStyle] 屬性設定為 Text。
將 [Text] 屬性設定為 Search。

建立事件處理常式以開啟在格線中按一下的網站

加入 CellContentClick 事件的事件處理常式。

若要建立 CellContentClick 事件處理常式

選取表單上的 resultsDataGridView，然後按一下 [屬性] 視窗中的 [事件] 按鈕。 [事件] 按鈕是有閃電圖示的按鈕。
按兩下 [CellContentClick] 事件，建立並巡覽至處理常式 Stub。

加入程式碼，以檢查哪個資料行已按下並在按一下 Url 資料行時巡覽至網頁：

Private Sub ResultsDataGridView_CellContentClick( _
    ByVal sender As System.Object, _
    ByVal e As System.Windows.Forms.DataGridViewCellEventArgs) _
    Handles ResultsDataGridView.CellContentClick

    ' When the content in a cell is clicked check to see if it is the Url column.
    ' If it is, pass the url to the Process.Start method to open the web page.
    If ResultsDataGridView.Columns(e.ColumnIndex).DataPropertyName = "Url" Then
        System.Diagnostics.Process.Start(ResultsDataGridView.SelectedCells(0).Value)
    End If
End Sub

private void resultsDataGridView_CellContentClick(object sender, DataGridViewCellEventArgs e)
{
    // When the content in a cell is clicked check to see if it is the Url column.
    // If it is, pass the url to the Process.Start method to open the web page.
    if (resultsDataGridView.Columns[e.ColumnIndex].DataPropertyName == "Url")
    {
        System.Diagnostics.Process.Start(resultsDataGridView.SelectedCells[0].Value.ToString());
    }
}

加入用來存取 Live Search 服務及執行搜尋查詢的程式碼

藉由在應用程式具現化服務的執行個體並呼叫服務所公開的方法，來存取服務。

若要存取及使用服務

在程式碼編輯器中開啟 Form1。

將下列方法加入至 Form1：

Private Sub RunSearchRequest()

    ' Create an instance of the service.
    Dim searchService As New LiveSearchService.MSNSearchPortTypeClient

    ' Instantiate a new SearchRequest.
    Dim searchRequest As New LiveSearchService.SearchRequest

    ' Create a new SourceRequest.
    Dim sourceRequest(1) As LiveSearchService.SourceRequest
    sourceRequest(0) = New LiveSearchService.SourceRequest

    ' To search the web, set the SourceType to Web.
    sourceRequest(0).Source = LiveSearchService.SourceType.Web

    ' Set the columns you want the query to return.
    sourceRequest(0).ResultFields = _
        LiveSearchService.ResultFieldMask.Description And _
        LiveSearchService.ResultFieldMask.Url And _
        LiveSearchService.ResultFieldMask.Title

    ' Search for the text in the textbox.
    searchRequest.Query = searchCriteriaTextBox.Text

    ' Set the SearchRequest to the SourceRequest array.
    searchRequest.Requests = sourceRequest


    ' Replace with a valid AppID. Obtain a free AppID at:
    ' http://search.live.com/developer 
    searchRequest.AppID = "AppID"
    searchRequest.CultureInfo = "en-US"

    ' Create a SearchResponse, then call the Search method
    ' and assign the return value to the response object.
    Dim searchResponse As LiveSearchService.SearchResponse = _
        searchService.Search(searchRequest)

    ' Bind the results to the form's BindingSource.
    ResultsBindingSource.DataSource = searchResponse.Responses(0).Results
End Sub

private void RunSearchRequest()
{
    // Create an instance of the service.
    LiveSearchService.MSNSearchPortTypeClient searchService =
        new LiveSearchService.MSNSearchPortTypeClient();

    // Instantiate a new search request.
    LiveSearchService.SearchRequest searchRequest = new LiveSearchService.SearchRequest();

    // Create a new SourceRequest.
    LiveSearchService.SourceRequest[] sourceRequest = new LiveSearchService.SourceRequest[1];
    sourceRequest[0] = new LiveSearchService.SourceRequest();

    // Set the number of results to return.
    sourceRequest[0].Count = 7;

    // To search the web, set the SourceType to Web.
    sourceRequest[0].Source = LiveSearchService.SourceType.Web;

    // Set the columns to be returned from the search query.
    sourceRequest[0].ResultFields = LiveSearchService.ResultFieldMask.Description |
        LiveSearchService.ResultFieldMask.Url |
        LiveSearchService.ResultFieldMask.Title;

    // Set the search query to the value in the text box.
    searchRequest.Query = searchCriteriaTextBox.Text;

    // Set the search request to the array of source requests.
    searchRequest.Requests = sourceRequest;

    // Replace with a valid AppID. Obtain a free AppID at:
    // http://search.live.com/developer 
    searchRequest.AppID = "AppID";
    searchRequest.CultureInfo = "en-US";

    // Create a SearchResponse, then call the search method
    // and assign the return value to the response object.
    LiveSearchService.SearchResponse searchResponse = searchService.Search(searchRequest);

    // Bind the results from the search query to the form's BindingSource.
    resultsBindingSource.DataSource = searchResponse.Responses[0].Results;
}

注意事項
務必將 searchRequest.AppID = "AppID" 取代成從 Live Search 服務取得的 AppID 值。

建立可在按一下搜尋按鈕時執行搜尋的事件處理常式

為 searchButton.Click 事件建立事件處理常式並呼叫 RunSearchRequest 方法。

若要在按一下按鈕時實作搜尋

在設計檢視中開啟 [Form1]。
按兩下 [搜尋] 按鈕。

在產生的處理常式中加入下列一行程式碼：

Private Sub searchButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles searchButton.Click
    RunSearchRequest()
End Sub

private void searchButton_Click(object sender, EventArgs e)
{
    RunSearchRequest();
}

執行應用程式

執行應用程式和搜尋。

若要執行應用程式和搜尋

執行應用程式 (按下 F5)。
按一下 [搜尋]，在 Web 搜尋 Visual Studio (searchCriteriaTextBox 中的預設文字)。

格線隨即顯示前十個搜尋結果。
按一下其中一個 URL，巡覽至該網站。
在文字方塊中輸入 Redmond WA Weather，然後按一下 [搜尋]。

格線隨即以新的搜尋結果來更新。

後續步驟

存取 Live Search 服務的是做為起點，可以了解如何利用 Windows Form 應用程式中的資料繫結功能，顯示從服務傳回的資料。連接至不同的服務以及從 [資料來源] 視窗拖曳項目之後，您的表單應該包含 BindingSource 元件；請將 DataSource 屬性設為服務所傳回的資料。如需詳細資訊，請參閱 BindingSource 元件概觀。

注意事項
[資料來源] 視窗中出現的項目視 Web 服務傳回的資訊而定。某些 Web 服務可能不會提供足夠的資訊，讓 [資料來源組態精靈] 建立可繫結的物件。例如，如果 Web 服務傳回未提供可搜尋之結構描述的物件，則完成精靈之後，在 [資料來源] 視窗中不會出現任何項目。

若要將功能加入至應用程式中

在 [資料來源] 視窗中選取項目，然後將其拖曳到表單上。如需詳細資訊，請參閱將 Windows Form 控制項繫結至 Visual Studio 中的資料。
在表單上建立服務的執行個體。
將產生的 DataSource 屬性設定為 Web 服務傳回的資料。

請參閱

概念

將控制項繫結至 Visual Studio 中的資料

其他資源

共用方式為

逐步解說：連接至 Web 服務中的資料 (Windows Form)

取得 AppID

若要取得 AppID

建立專案

若要建立新專案

連接至服務

若要連接至 Live Search Web 服務

建立 DataGridView 以顯示從服務傳回的資料

若要建立資料繫結的 DataGridView

加入用來輸入搜尋準則及執行搜尋查詢的控制項

若要將文字方塊和按鈕加入至表單

建立事件處理常式以開啟在格線中按一下的網站

若要建立 CellContentClick 事件處理常式

加入用來存取 Live Search 服務及執行搜尋查詢的程式碼

若要存取及使用服務

建立可在按一下搜尋按鈕時執行搜尋的事件處理常式

若要在按一下按鈕時實作搜尋

執行應用程式

若要執行應用程式和搜尋

後續步驟

若要將功能加入至應用程式中

請參閱

概念

其他資源

其他資源