SoapExtension.Initialize(Object) Yöntem

Tanım

Ad Alanı:

System.Web.Services.Protocols

Bütünleştirilmiş Kod:

System.Web.Services.dll

Türetilmiş bir sınıfta geçersiz kılındığında, soap uzantısının yönteminde önbelleğe alınan verileri kullanarak kendisini başlatmasına GetInitializer(LogicalMethodInfo, SoapExtensionAttribute) izin verir.

public:
 abstract void Initialize(System::Object ^ initializer);

public abstract void Initialize (object initializer);

abstract member Initialize : obj -> unit

Public MustOverride Sub Initialize (initializer As Object)

Parametreler

initializer

Object

ASP.NET Object tarafından önbelleğe alınan tarafından GetInitializer(LogicalMethodInfo, SoapExtensionAttribute) döndürülen.

Örnekler

Aşağıdaki örnekte, yöntemi sırasında önbelleğe alınan verileri nasıl kullanabileceğiniz gösterilmektedir GetInitializer .

   // Receive the file name stored by GetInitializer and store it in
   // a member variable for this specific instance.
public:
   virtual void Initialize( Object^ initializer ) override
   {
      filename = dynamic_cast<String^>(initializer);
   }

// 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;
}

' Receive the file name stored by GetInitializer and store it in a 
' member variable for this specific instance.
Public Overrides Sub Initialize(initializer As Object)
    m_filename = CStr(initializer)
End Sub

Açıklamalar

SOAP uzantısının verileri başlatmak için üç fırsatı vardır ve hepsinin farklı amaçları vardır:

• Sınıf oluşturucu - Bir SOAP uzantısının örneği her başlatıldığında sınıf oluşturucu çağrılır ve genellikle üye değişkenlerini başlatmak için kullanılır.

• GetInitializer - Bu yöntem, BIR XML Web hizmetleri yöntemine ilk kez SOAP isteği yapıldığında yalnızca bir kez çağrılır. XML Web hizmeti yöntemine özel bir öznitelik uygulanırsa yöntemi GetInitializer çağrılır. Bu, SOAP uzantısının prototip bilgileri için bir XML Web hizmeti yöntemini sorgulamasını LogicalMethodInfo veya öğesinden SoapExtensionAttributetüretilen bir sınıf tarafından geçirilen uzantıya özgü verilere erişmesini sağlar. Dönüş değeri ASP.NET tarafından önbelleğe alınır ve sonraki Initialize yöntemlere geçirilir. Bu nedenle, içinde GetInitializer yapılan başlatma temelde tek seferlik bir performans isabetine kapsüllenir.

• Initialize- Bir XML Web hizmeti yöntemine soap isteği her yapıldığında bu yöntem çağrılır, ancak içinde başlatılan GetInitializer öğesine geçirildiğinden sınıf oluşturucusunun Object avantajı vardır.

Not

Ayrıca, öğesinden SoapExtensionAttribute türetilmeden bir SOAP uzantısını yapılandırma dosyasında kullanarak <soapExtensionTypes> da ekleyebilirsiniz. Ayrıntılar için bkz<soapExtensionTypes>. SOAP Uzantılarını Kullanarak Öğe ve SOAP İleti Değişikliği.