كائن My.WebServices

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

ملاحظات

يوفر كائن My.WebServices مثيل لكل خدمة ويب يشير إليها المشروع الحالي. و كل مثيل يتم إنشاؤه حسب الطلب . و يمكنك الوصول إلى خدمات الويب هذه من خلال خصائص كائن My.WebServices . اسم الخاصية هو نفس اسم خدمة الويب التي تقوم بالوصول إلى الخاصية. أي فئة ترث من SoapHttpClientProtocol تعتبر خدمة الويب. لمزيد من المعلومات حول إضافة الخدمات ويب إلى مشروع راجع الوصول إلى خدمات ويب التطبيق.

كائن My.WebServices يعرض خدمات ويب المقترنة بالمشروع الحالي فقط. لا يوفر وصول إلى خدمات ويب التي تم تعريفها في ملفات DLL المشار إليه. للوصول لخدمة ويب التي توفر DLL يجب عليك استخدام الاسم المؤهل لخدمة ويب في نموذج DllName.WebServiceName. لمزيد من المعلومات، راجع الوصول إلى خدمات ويب التطبيق.

الكائن والخصائص الخاصة به غير متوفرة لتطبيقات ويب.

Properties

لكل خاصية الكائن My.WebServices يوفر الوصول إلى مثيل لخدمة ويب مشار إليه بواسطة المشروع الحالي. اسم الخاصية هو نفس اسم خدمات ويب الذي يقوم بالوصول إلى الخاصية و نوع الخاصية هو نفسه نوع خدمات الويب.

ملاحظة

في حالة حدوث تضارب اسم، اسم الخاصية للوصول إلى خدمة ويب هو RootNamespace_مساحة الاسم_اسم الخدمة. على سبيل المثال، ضع في الاعتبار اثنين من خدمات ويب باسم Service1. إذا كان أحد هذه الخدمات في مساحة اسم الجذر WindowsApplication1 و في مساحة الاسم Namespace1، ستصل لتلك الخدمة باستخدام My.WebServices.WindowsApplication1_Namespace1_Service1.

عندما تصل أول مرة لأحد خصائص كائن My.WebServices فإنه يقوم بإنشاء مثيل جديد من خدمة ويب وتخزينه. محاولات وصول اللاحقة لتلك الخاصية تقوم بإرجاع ذلك المثيل من خدمة الويب.

يمكنك التخلص من خدمة ويب عن طريق تعيين Nothing إلى خاصية خدمة الويب. يعين مُعين الخاصية Nothing إلى القيمة المخزنة. إذا قمت بتعيين أية قيمة أخرى غير Nothing إلى الخاصية، يطرح المعين استثناء ArgumentException.

يمكنك اختبار ما إذا كانت خاصية كائن My.WebServices تخزن مثيل في خدمة ويب عن طريق استخدام عامل تشغيل Is أو IsNot. يمكنك استخدام عوامل التشغيل تلك لفحص إذا كانت قيمة الخاصية هي Nothing.

ملاحظة

عادةً، عوامل التشغيل Is أو IsNot يجب أن تقرأ قيمة الخاصية لإجراء المقارنة. ومع ذلك، إذا كانت الخاصية تخزن حالياً Nothing، الخاصية تنشئ مثيل جديد لخدمات ويب ومن ثم ترجع ذلك المثيل. على الرغم من ذلك، يعامل برنامج التحويل البرمجي Visual Basic خصائص كائن My.WebServices بشكل خاص ويسمح لعامل تشغيل Is أو IsNot للتحقق من حالة الخاصية بدون تبديل القيمة الخاصة به.

المهام

يسرد الجدول التالي مثال لمهمه تتضمن كائن My.Forms.

لعمل

راجع

يستدعي خدمة الويب بشكل غير متزامن و يعالج الحدث عند إكتماله

كيفية: استدعاء خدمة ويب بشكل غير متزامن

مثال

يستدعي هذا المثال أسلوب FahrenheitToCelsius لخدمة ويب XML TemperatureConverter وإرجاع النتيجة.

Function ConvertFromFahrenheitToCelsius( 
    ByVal dFahrenheit As Double) As Double

    Return My.WebServices.TemperatureConverter.FahrenheitToCelsius(dFahrenheit)
End Function

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

هذه التعليمات البرمجية لا تعمل في مشروع تطبيق ويب.

المتطلبات

الإتاحة حسب نوع مشروع

نوع المشروع

متوفرة

تطبيقات Windows

نعم

مكتبة الفئات

نعم

تطبيق لوحة المراقبة

نعم

مكتبة عنصر تحكم Windows

نعم

مكتبة عنصر تحكم الويب

نعم

خدمات Windows

نعم

موقع الويب

لا

راجع أيضًا:

المرجع

SoapHttpClientProtocol

ArgumentException

المبادئ

الوصول إلى خدمات ويب التطبيق