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.

SoapExtension.Initialize أسلوب

Visual Studio 2010

عند تجاوز في فئة مشتقة، يسمح بملحق بروتوكول بروتوكول SOAP إلى يهيّئ نفسه باستخدام بيانات المخزنة مؤقتاً في GetInitializerالأسلوب.

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

public abstract void Initialize(
	Object initializer
)

المعلمات

initializer
النوع: System.Object
Object التي يتم إرجاعها من GetInitializerالمخزنة مؤقتاً بواسطة ASP.NET.

A بروتوكول بروتوكول ملحق SOAP has three opportunities إلى يهيّئ بيانات و they الجميع have different purposes:

  • فئة الدالة الإنشائية - The فئة الدالة الإنشائية هو called every الوقت a بروتوكول بروتوكول ملحق SOAP هو instantiated و هو typically used إلى يهيّئ عضو متغيرات.

  • GetInitializer - GetInitializer , however, هو called just once, the أول الوقت a بروتوكول بروتوكول SOAP طلب هو made إلى an XML ويب الخدمات أسلوب. إذا تم تطبيق سمة مخصصة على خدمة ويب XML الأسلوب، GetInitializerاستدعاء الأسلوب. This allows the بروتوكول بروتوكول ملحق SOAP إلى interrogate the LogicalMethodInfo of an XML ويب الخدمة أسلوب for نموذج أولي معلومات أو إلى الوصول extension-specific بيانات passed بواسطة a فئة deriving من SoapExtensionAttribute. The return القيمة هو cached بواسطة ASP.NET و passed في subsequent Initialize وظائف. Therefore, تهيئة done in GetInitializer هو encapsulated essentially في a واحد-الوقت الأداء hit.

  • Initialize - Initialize هو تسمى كل مرة طلب بروتوكول بروتوكول SOAP هو التي تم إجراؤها على أسلوب الخدمة ويب ل XML، ولكن له ميزة على الدالة الإنشائية الفئة، في تلكObjectتهيئة فيGetInitializerهو التي تم تمريرها إلى it.

ملاحظةملاحظة

يمكنك أيضا إضافة ملحق بروتوكول بروتوكول SOAP دون اشتقاق من SoapExtensionAttributeبواسطة استخدام <soapExtensionTypes> Elementفي ملف تكوين. لمزيد التفاصيل , راجع <soapExtensionTypes> Element و SOAP Message Modification Using SOAP Extensions.

يوضح المثال التالي كيف يمكنك استخدام بيانات المخزنة مؤقتاً أثناء GetInitializerأسلوب.


// Receive the file name stored by GetInitializer and store it in
// a member variable for this specific instance.
public override void Initialize(object initializer) {
    filename = (string) initializer;
}


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