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

Object GetInitializer(LogicalMethodInfo, SoapExtensionAttribute) tarafından ASP.NET tarafından önbelleğe alındı.

Örnekler

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

   // 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ı 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ğinde bulunularak 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 XML Web hizmeti yöntemini sorgulamasına LogicalMethodInfo veya öğesinden SoapExtensionAttributetüretilen bir sınıf tarafından geçirilen uzantıya özgü verilere erişmesine olanak tanır. Dönüş değeri ASP.NET tarafından önbelleğe alınır ve sonraki Initialize yöntemlerine geçirilir. Bu nedenle, içinde GetInitializer yapılan başlatma temelde tek seferlik bir performans isabetine kapsüllenir.

• Initialize- Bu yöntem, bir XML Web hizmeti yöntemine her SOAP isteği yapıldığında çağrılır, ancak içinde başlatılan Object öğesinin bu yönteme geçirilmesinde sınıf oluşturucusunun GetInitializer avantajı vardır.

Note

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