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.

WebClientProtocol الفئة

Visual Studio 2010

تعين فئة الأساس لكافة الخدمة ويب XML وكلاء العميل التي تم إنشاؤها باستخدام ASP.NET.

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

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

الخصائص WebClientProtocolتستخدم الفئة إلى التحكم في سلوك نقل المستالخدمة إلى إرسال طلب الخدمة ويب ل XML واستجابة. تعيين الخصائص في هذه الفئة تشغيل الخصائص التي تم العثور عليها تشغيل WebRequest. Instances of فئات deriving من WebRequest, such كـ HttpWebRequest, are used كـ the نقل mechanism for XML ويب الخدمات تاريخ الإنشاء using ASP.NET.

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

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

ملاحظة الأمانملاحظة الأمان

يحتوي هذا المثال على مربع نص يقبل إدخال المستخدم و الذي يعد تهديد أمان محتمل. بشكل افتراضي، تتحقق صفحات ويب ASP.NET من أن مُدخلات المستخدم لا تتضمن برنامج نصي أو عناصر HTML. لمزيد من المعلومات، راجع نظرة عامة حول عمليات استغلال البرنامج النصي.


<%@ 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();

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

             // Do not allow the server to redirect the request.
             math.AllowAutoRedirect = false;

             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مثيل من عمليات جزئية المختلفة في نفس الوقت، هناك لا المزامنة للتأكد من أن لقطة سريعة ثابتة خصائص سيتم الحصول تشغيل نقل إلى 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
إظهار: