مشاركة عبر

الإرشادات التفصيلية: الاتصال إلى البيانات في الخدمة ويب (Windows Forms)

  • مقالة

توضح هذه معاينة كيفية يعيّن بك تطبيق إلى الخدمة ويب تستخدم معالج تكوين مصدر البيانات. أنت تتصل إلى بحث مباشرة بخدمة ويب ثم قم بتشغيل استعلامات بحث من تطبيق الخاص بك. سيتم عرض بيانات التي تم إرجاعها بواسطة الخدمة (نتائج بحث) تشغيل نموذج Windows.

تتضمن المهام الموضحة في هذه الإرشادات التفصيلية ما يلي:

  • إنشاء جديد مشروع تطبيق Windows.

  • إضافة "مرجع الخدمة" إلى تطبيق (يعيّن إلى الخدمة "بحث مباشرة".)

  • إضافة عناصر تحكم إلى تشغيل استعلامات بحث (استدعاء وظائف كشف بواسطة الخدمة).

  • كتابة تعليمة برمجية الوصول إلى الخدمة و بإرجاع بيانات.

  • ربط بيانات التي يتم إرجاعها من الخدمة إلى مصدر الربط.

  • عرض بيانات التي تم إرجاعها من الخدمة في شبكة.

كيفية الحصول على معرف التطبيق

معرف تطبيق من "البحث مباشرة" هو متوفرة مجاناً، وفريد تعريف تطبيق الخاص بك لخدمة "البحث مباشرة". معرف التطبيق هو المطلوبة للوصول إلى الخدمة.

إلى الحصول على معرف التطبيق

  • انتقل إلى http://بحث.live.com/developer و الحصول على معرف التطبيق حرة

    ملاحظة

    قد تستغرق بعض الوقت (30-60 دقائق) لمعرف التطبيق للتحقق من صحة مع الخدمة. إذا واجهتك العام '"العميل خطأ"' داخل هذا الوقت عند تشغيل تطبيق فمن المحتمل أن معرف تطبيق قيد مازالت عملية ممكّن على الخوادم "بحث مباشرة".

إنشاء المشروع

إلى إنشاء مشروع جديد

  1. من قائمة ملف، إنشاء مشروع جديد.

  2. تحديد تطبيق Windows Forms وقم بتسميته من WebServiceWalkthrough.

  3. انقر فوق موافق.

    مشروع هو التي تم إنشاؤها وإضافتها إلى من مستكشف الحل.

الاتصال إلى الخدمة

يعيّن إلى خدمة ويب بواسطة تشغيل معالج تكوين مصدر بيانات.

إلى الاتصال إلى خدمة ويب Live بحث

  1. في قائمة بيانات ، انقر فوقإظهار مصادر البيانات.

  2. في الإطار المصادر البيانات ، تحديد إضافة مصدر بيانات جديد .

  3. الخدمة في الصفحة اختيار "نوع مصدر بيانات" ، تحديد و انقر فوق التالي.

  4. اكتب http://بروتوكول بروتوكول SOAP.بحث.msn.com/webservices.asmx?wsdl في المربع URL في صندوق الحوار إضافة مرجع الخدمة.

  5. انقر فوق انتقال.

  6. بعد الخدمة ويب هو العثور على، قم بتغيير مساحة أسماء المصادر إلى: LiveSearchService.

  7. انقر فوق ‏‏موافق ، ومن ثم انقر فوق إنهاء إلى إضافة مرجع الخدمة إلى المشروع الخاص بك.

    مرجع خدمة هو إضافتها إلى المشروع، والإطار Data Sources هو تعبئة استناداً إلى عناصر التي تم إرجاعها من قبل الخدمة.

ملاحظة

لأن الخدمات ويب أخرى تعرض وظائف مختلفة، تكون الخطوات التالية في هذه معاينة خاصة إلى التي تستخدم الخدمة ويب Live بحث. عملية النموذجية التي تستخدم بيانات من خدمة هو لإنشاء مثيل للخدمة، قم باستدعاء وظائف كشف بواسطة الخدمة. بعد سحب عناصر من الإطار "المصادر بيانات" يجب أن يحتوي على النموذج الخاص بك مكون مصدر الربط؛ تعيين DataSourceخاصية إلى بيانات التي يتم إرجاعها بواسطة الخدمة.

قم بإنشاء عرض شبكة بيانات إلى عرض بيانات المطلوب إرجاعها بواسطة الخدمة

إنشاء شبكة بيانات مرتبطة للبيانات بواسطة سحب عناصر من الإطار المصادر البيانات إلى النموذج. بعد إضافة الشبكة، قم بتكوين أعمدة إلى عرض أعمدة نحن إلى موجودة. قم بتعيين العمود URL على ارتباط بحيث يمكن للمستخدمين النقر فوق URL و التنقل إلى مواقع ويب التي يتم إرجاعها بواسطة استعلام بحث.

إلى إنشاء عرض شبكة بيانات حدود بيانات

  1. توسيع من SearchResponse عقدة في الإطار المصادر بيانات.

  2. توسيع الاستجابات عقدة.

  3. قم بسحب العقدة نتائج إلى نموذج.

    عرض شبكة البيانات، مصدر الربط، و متصفح الربط تضاف إلى النموذج.

  4. تحديد resultsDataGridView تمت إضافتها إلى نموذج.

  5. في الإطار خصائص تحديد أعمدة خاصية وانقر فوق علامات الحذف (…) إلى فتح تحرير مربع الحوار "أعمدة" (طريقة العرض "تصميم").

  6. تحديد متحديد موقع المعلومات عمود وتعيين:

    1. ColumnType خاصية إلى من DataGridViewLinkColumn.

    2. AuإلىSizeMode خاصية إلى من AllCells.

  7. قم بإزالة الجميع أعمدة عدا عنوانو الوصف وأعمدة محدد موقع معلومات .

  8. انقر فوق موافق.

إضافة عناصر التحكم لإدخال خصائص بحث، والتي تستخدم في استعلام بحث

إضافة عناصر التحكم على شريط الأدوات الموجود لتشغيل استعلامات بحث.

لإضافة صندوق نص و زر إلى النموذج

  1. زر الماوس الأيمن فوق رمز قرص الرمادية تشغيل شريط الأدوات الخاص بالنموذج و حدد إدراج متبوعاً بمربع النص.

  2. في الإطار خصائص ، قم بتعيين اسم خاصية إلى searchCriteriaTextBox .

  3. قم بتعيين نص خاصية إلى ‏‫Visual Studio.

  4. إضافة زر إلى شريط الأدوات وتسميته searchButton .

  5. في الإطار خصائص ، قم بتعيين DisplayStyle خاصية إلى نص.

  6. قم بتعيين نص خاصية إلى بحث.

قم بإنشاء الأحداث معالج إلى فتح موقع ويب عند النقر في شبكة

إضافة معالج حدث ل CellContentClickالحدث.

إلى إنشاء معالج الأحداث CellContentClick

  1. تحديد resultsDataGridView في النموذج، انقر فوق الأحداث زر في النافذة خصائص. الأحداث زر هو زر مع رمز bolt lightning.

  2. نقر مزدوج حدث CellContentClick لإنشاء و التنقل إلى يقوم كعب روتين معالج.

  3. قم بإضافة تعليمات برمجية للتحقق من الأعمدة التي تم النقر فوقه للانتقال إلى صفحة ويب إذا كان العمود 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());
    }
}

قم بإضافة تعليمات برمجية الوصول إلى بحث مباشرة الخدمة و تشغيل استعلام بحث

الوصول إلى الخدمة بواسطة instantiating مثيل للخدمة في تطبيق الخاص بك و استدعاء وظائف كشف بواسطة الخدمة.

للوصول إلى و استهلاك الخدمة

  1. فتح Form1 في محرر البرنامج.

  2. قم بإضافة ما يلي أسلوب إلى 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 = "معرف التطبيق" بقيمة معرف التطبيق تم الحصول عليه من الخدمة "بحث مباشرة".

إنشاء معالج أحداث تشغيل بحث عند زر البحث هو عند النقر

قم بإنشاء معالج حدث للحدث searchButton.انقر ثم استدعاء الأسلوب RunSearchRequest.

لتطبيق يتم الآن البحث عند النقر فوق الزر

  1. افتح Form1 في عرض "تصميم".

  2. نقر مزدوج الزر بحث.

  3. قم بإضافة السطر التالي من تعليمات برمجية في معالج الذي تم إنشاؤه:

    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();
}

قم بتشغيل تطبيق

قم بتشغيل تطبيق و إجراء بحث.

إلى تشغيل تطبيق ثم قم بتنفيذ عملية بحث

  1. قم بتشغيل تطبيق (ضغط F5).

  2. انقر فوق بحث إلى بحث في الويب عن ‏‫Visual Studio ، نص الافتراضي في searchCriteriaTextBox.

    شبكة يعرض نتائج بحث العشرة الأولى.

  3. انقر فوق واحد Urls للانتقال إلى موقع ويب هذا.

  4. اكتب الطقس القاهرة Redmond في صندوق نص و انقر فوق بحث.

    تحديث الشبكة مع نتائج بحث الجديدة.

الخطوات التالية

الوصول إلى الخدمة "بحث مباشرة" هو تعني فقط كنقطة بداية لفهم كيفية إلى dهوplay إرجاع بيانات من الخدمة الاستفادة من ميزات ربط بيانات في تطبيقات Windows Forms. بعد الاتصال إلى خدمة مختلفة، وبعد سحب عناصر من الإطار موارد بيانات يجب أن يحتوي على النموذج الخاص بك مكون مصدر الربط؛ تعيين DataSourceخاصية إلى بيانات التي يتم إرجاعها بواسطة الخدمة. لمزيد من المعلومات، راجع نظرة عامة حول مكوّن BindingSource.

ملاحظة

عناصر التي تظهر في الإطار المصادر بيانات معتمدة تشغيل المعلومات التي الخدمة ويب إرجاع. قد لا لبعض الخدمات ويب يوفر معلومات كافية ل معالج إعداد مصدر بيانات لإنشاء الكائنات يمكن ربطها. على سبيل المثال، إذا كانت الخدمة ويب إرجاع كائن لا يوفر أي مخطط يمكن اكتشافه، ثم يظهر لا توجد عناصر في الإطار موارد بيانات بعد إتمام معالج.

لإضافة وظيفة إلى تطبيق الخاص بك

راجع أيضًا:

المبادئ

قم بربط عناصر التحكم إلى البيانات في ‏‫Visual Studio

موارد أخرى

‏‏تحرير بيانات في تطبيق الخاص بك

التحقق من صحة بيانات

حفظ بيانات

الإرشادات التفصيلية الخاصة بالبيانات