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.

HttpWebClientProtocol الفئة

Visual Studio 2010

فئة الأساس لكافة ويب ل XML الخدمة العميل وكلاء التي تستخدم البروتوكول HTTP نقل.

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

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

يتم استخدام الخصائص في هذه الفئة إلى تتحكم بسلوك الكائن طلب HTTP المستخدم في إلى إرسال طلب الخدمة ويب ل XML واستجابة. خصائص المخطط إلى العثور تشغيل الخصائص تشغيل HttpWebRequest.

إلى الاتصال بخدمة ويب XML استخدام HTTP، يجب عليك إنشاء فئة وكيل اشتقاق بشكل مباشر أو غير مباشر من HttpWebClientProtocolلخدمة ويب XML. بدلاً من إنشاء الفئة الوكيل يدوياً، يمكنك استخدام Wsdl.exe إلى ol إلى إنشاء فئة وكيل لوصف الخدمة لخدمة ويب XML المعطى.

منذ HttpWebClientProtocol هو فئة Base لكافة فئات الوكيل، خصائصه غير تشغيل فئات الوكيل الخاص بك. وتفيد هذه الخصائص في التحكم في سلوك طلب نقل الأساسي. على سبيل المثال، استخدام Proxyخاصية للاتصال بويب من XML الخدمات من خلال جدار حماية. تستخدم العديد من هذه الخصائص إلى تهيئة HttpWebRequestالأمر الذي يجعل طلب ويب.

SoapHttpClientProtocol ,HttpGetClientProtocol، وHttpPostClientProtocolينحدر بشكل مباشر أو غير مباشر منHttpWebClientProtocolإلى تقديم الدعم بروتوكول بروتوكول SOAP،-HTTP يحصل و HTTP ينشر على التوالي.

المثال التالي هو نموذج ويب ASP.NET، وقم باستدعاء الخدمة ويب XML يسمى Math. داخل EnterBtn_Clickدالة، "نموذج ويب" يسمح الخادم بإعادة التوجيه التلقائي العميل إلى مواقع غير ذلك. يقوم بتعيين العميل أيضا مصادقة بيانات اعتماد وإعدادات الوكيل، ترميز الطلب وانقضاء المهلة المحددة للطلب قبل استدعاء ويب XML الخدمة الأسلوب.


<%@ Page Language="C#" %>
<%@ Import Namespace="System.Net" %>

<html>
    <script language="C#" runat="server">
       void EnterBtn_Click(Object Src, EventArgs E) 
          {
             MyMath.Math math = new MyMath.Math();

             // Allow the server to redirect the request.
             math.AllowAutoRedirect = true;

             // Set the client-side credentials using the Credentials property.
             ICredentials credentials =
                new NetworkCredential("Joe","password","mydomain");
             math.Credentials = credentials;

             // Set the proxy server to proxyserver, set the port to 80, and specify to bypass
             // the proxy server for local addresses.
             IWebProxy proxyObject = new WebProxy("http://proxyserver:80",true);
             math.Proxy = proxyObject;

             // Set the encoding to utf-8.
             math.RequestEncoding = System.Text.Encoding.UTF8;

             // Set the time out to 15 seconds
             math.Timeout = 15000;

             int total = math.Add(Convert.ToInt32(Num1.Text),
                Convert.ToInt32(Num2.Text));
             Total.Text = "Total: " + total.ToString();
         }

    </script>

    <body>
       <form action="MathClient.aspx" runat=server>

          Enter the two numbers you want to add and then press the Total button.
          <p>
          Number 1: <asp:textbox id="Num1" runat=server/>  +
          Number 2: <asp:textbox id="Num2" runat=server/> =
          <asp:button text="Total" Onclick="EnterBtn_Click" runat=server/>
          <p>
          <asp:label id="Total"  runat=server/>

       </form>
    </body>
 </html>
   


الخصائص على هذه فئة يتم نسخ نسخة جديدة من WebRequestالكائن لكل ويب ل XML الخدمة أسلوب الاستدعاء. بينما يمكنك استدعاء أساليب خدمة ويب ل XML تشغيل نفس WebClientProtocolمثيل من عمليات جزئية المختلفة في نفس الوقت، هناك هو لا المزامنة للتأكد من أنه يتم نقل لقطة سريعة consهوtent الخصائص WebRequestالكائن. ولذلك، إذا كنت تحتاج إلى تعديل خصائص ثم قم بإجراء استدعاء الأسلوب المتزامنة من عمليات جزئية المختلفة يجب عليك استخدام مثيل آخر لوكيل الخدمة ويب ل XML وتوفير المزامنة الخاصة بك.

نظام التشغيل 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
إظهار: