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.

SoapHttpClientProtocol.Invoke أسلوب

Visual Studio 2010

استدعاء الخدمة ويب XML أسلوب استخدام بروتوكول بروتوكول SOAP بشكل متزامن.

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

protected Object[] Invoke(
	string methodName,
	Object[] parameters
)

المعلمات

methodName
النوع: System.String
اسم الخدمة ويب XML أسلوب.
parameters
النوع: System.Object[]
صفيفة من الكائنات التي يحتوي على معلمات لتمريرها إلى الخدمة ويب XML. ترتيب قيم في الصفيف يتطابق مع إلى معلمات في استدعاء أسلوب من فئة مشتقة.

القيمة المُرجعة

النوع: System.Object[]
صفيفة من الكائنات التي يحتوي على القيمة الإرجاع أي referenceأو outمعلمات أسلوب فئة مشتقة.

استثناء:شرط
SoapException

الوصول إلى كمبيوتر الملقم الطلب، ولكن لم تتم معالجة بنجاح.

بشكل عام، يمكنك القيام باستدعاء لا Invokeأسلوب مباشرة، إلا إذا كنت تقوم بإنشاء فئة الوكيل الخاص بك خدمة ويب XML.

وكيل فئة تم إنشاؤها بواسطة أداة "اللغة الوصفية لخدمات ويب" (Wsdl.exe) لالخدمة ويب XML كشف وظائف الخدمة ويب XML كأسماء الوكيل فئة. باستدعاء الفئة الوكيل Invokeأسلوب إلى استدعاء على ويب من XML الخدمة أسلوب الاستدعاء. على سبيل المثال، إذا كانت الخدمة ويب XML الكشف عن أسلوب الخدمة ويب XML يسمى Add، الوكيل فئة ويحتوي أيضا على أسلوب المسمى Add. في التعليمة البرمجية ل Addأسلوب في فئة الوكيل، واستدعاء متزامن هو التي تم إجراؤها على أسلوب الخدمة ويب ل XML من خلال Invokeالأسلوب والنتائج ثم توضع في نوع الإرجاع المتوقع ل Add.

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

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



namespace MyMath {
    using System.Diagnostics;
    using System.Xml.Serialization;
    using System;
    using System.Web.Services.Protocols;
    using System.Web.Services;


    [System.Web.Services.WebServiceBindingAttribute(Name="MyMathSoap", Namespace="http://www.contoso.com/")]
    public class MyMath : System.Web.Services.Protocols.SoapHttpClientProtocol {

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

        [System.Diagnostics.DebuggerStepThroughAttribute()]
        [System.Web.Services.Protocols.SoapDocumentMethodAttribute("http://www.contoso.com/Add", RequestNamespace="http://www.contoso.com/", ResponseNamespace="http://www.contoso.com/", Use=System.Web.Services.Description.SoapBindingUse.Literal, ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped)]
        public int Add(int num1, int num2) {
            object[] results = this.Invoke("Add", new object[] {num1,
                        num2});
            return ((int)(results[0]));
        }

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

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



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


<%@ WebService Language="C#" Class="MyMath"%>
 using System.Web.Services;
 using System;

 [WebService(Namespace="http://www.contoso.com/")] 
 public class MyMath {
      [ 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
إظهار: