This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

HttpSimpleClientProtocol الفئة

Visual Studio 2010

تمثل فئة الأساس للاتصال مع خدمة ويب XML استخدام HTTP يحصل بسيطة و HTTP ينشر البروتوكولات الروابط.

مساحة الاسم:  System.Web.Services.Protocols
التجميع:  System.Web.Services (في System.Web.Services.dll)

[ComVisibleAttribute(true)]
public abstract class HttpSimpleClientProtocol : HttpWebClientProtocol

تعين هذه الفئة معظم تطبيق للاتصال بخدمة ويب XML عبر HTTP باستخدام encoders في يرمّز المعلمات وإرجاع قيم في في التنسيقات MIME عام. هذه encoders ينحدر من MimeFormatterفئة. افتراضياً، يكون لفئة وكيل اشتقاق من HttpSimpleClientProtocolبترميز معلمات باستخدام نوع MIME تطبيق/س-www-النموذج-urlencoded و الاستجابة في XML عادي. يمكن تعيين formatters mime مخصصة باستخدام HttpMethodAttributeالسمة، على الرغم من ذلك، هناك هو لا يوجد دعم تكامل th هو إلى الخدمة وصف والوكيل الجيل.

Notes to Inheritors: عند تجاوز هذه الفئة، يمكن تقديم وظائف خاصة في فئة مشتقة إلى نوع معين على الخدمة ويب ل XML. الأساليب ببساطة يلتقط المعلمات، واستدعاء الفئة الأساسية إلى القيام بأعمال الاتصال بالموقع. إذا كانت وظائف الموفرة غير متزامن، استدعاء BeginInvokeو EndInvokeالوظائف. إذا s أسلوب الموفرة غير متزامن، باستدعاء Invokeأسلوب. ويعين construcإلىr تم عادة Urlخاصية إلى URI لأسلوب الخدمة ويب ل XML.

أداة اللغة وصف "الخدمات ويب" (Wsdl.exe) بإنشاء الفئات المشتقة من HttpSimpleClientProtocolلالخدمة معينة وصف.

مثال التعليمة البرمجية التالية هو فئة وكيل التي تم إنشاؤها بواسطة Wsdl.exe ل Mathالخدمة ويب XML أدناه. مشتقة فئة الوكيل من HttpGetClientProtocol، التي مشتقة من الملخص HttpSimpleClientProtocolclass.


using System.Diagnostics;
using System.Xml.Serialization;
using System;
using System.Web.Services.Protocols;
using System.Web.Services;


public class MyMath : System.Web.Services.Protocols.HttpGetClientProtocol {

    [System.Diagnostics.DebuggerStepThroughAttribute()]
    public MyMath() {
        this.Url = "http://www.contoso.com/math.asmx";
    }

    [System.Diagnostics.DebuggerStepThroughAttribute()]
    [System.Web.Services.Protocols.HttpMethodAttribute(typeof(System.Web.Services.Protocols.XmlReturnReader), typeof(System.Web.Services.Protocols.UrlParameterWriter))]
    [return: System.Xml.Serialization.XmlRootAttribute("int", Namespace="http://www.contoso.com/", IsNullable=false)]
    public int Add(string num1, string num2) {
        return ((int)(this.Invoke("Add", (this.Url + "/Add"), new object[] {num1,
                    num2})));
    }

    [System.Diagnostics.DebuggerStepThroughAttribute()]
    public System.IAsyncResult BeginAdd(string num1, string num2, System.AsyncCallback callback, object asyncState) {
        return this.BeginInvoke("Add", (this.Url + "/Add"), new object[] {num1,
                    num2}, callback, asyncState);
    }

    [System.Diagnostics.DebuggerStepThroughAttribute()]
    public int EndAdd(System.IAsyncResult asyncResult) {
        return ((int)(this.EndInvoke(asyncResult)));
    }
}


يلي تعليمات برمجية المثال هو Mathالخدمة ويب ل XML، الذي تم تاريخ الإنشاء فئة الوكيل السابق.


 using System.Web.Services;
 using System;

 public class Math {
      [ WebMethod ]
      public int Add(int num1, int num2) {
          return num1+num2;
          }
 }



هذا النوع هو مسار التنفيذ آمن.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0, 1.1, 1.0

NET Framework. Client Profile

مدعوم في: 4
إظهار: