SoapExtension.Initialize(Object) Metoda

Definicja

Przestrzeń nazw:

System.Web.Services.Protocols

Zestaw:

System.Web.Services.dll

Po przesłonięciu w klasie pochodnej umożliwia rozszerzenie SOAP inicjowanie się przy użyciu danych przechowywanych w pamięci podręcznej w metodzie GetInitializer(LogicalMethodInfo, SoapExtensionAttribute) .

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)

Parametry

initializer

Object

Zwrócony Object z GetInitializer(LogicalMethodInfo, SoapExtensionAttribute) pamięci podręcznej przez ASP.NET.

Przykłady

W poniższym przykładzie pokazano, jak można używać danych przechowywanych w pamięci podręcznej GetInitializer podczas metody .

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

Uwagi

Rozszerzenie SOAP ma trzy możliwości inicjowania danych i wszystkie mają różne cele:

• Konstruktor klasy — konstruktor klasy jest wywoływany za każdym razem, gdy rozszerzenie SOAP jest tworzone i jest zwykle używane do inicjowania zmiennych składowych.

• GetInitializer — Ta metoda jest wywoływana tylko raz, po raz pierwszy żądanie PROTOKOŁU SOAP jest wykonywane do metody usług sieci Web XML. Jeśli atrybut niestandardowy jest stosowany do metody usługi sieci Web XML, GetInitializer metoda jest wywoływana. Dzięki temu rozszerzenie SOAP umożliwia przesłuchiwane LogicalMethodInfo metody usługi sieci Web XML na potrzeby prototypowych informacji lub uzyskiwania dostępu do danych specyficznych dla rozszerzenia przekazywanych przez klasę pochodzącą z SoapExtensionAttributeklasy . Wartość zwracana jest buforowana przez ASP.NET i przekazywana do kolejnych Initialize metod. W związku z tym inicjowanie wykonywane w pliku GetInitializer jest hermetyzowane zasadniczo w jednorazowym trafieniu wydajności.

• Initialize — Ta metoda jest wywoływana za każdym razem, gdy żądanie PROTOKOŁU SOAP jest wykonywane do metody usługi sieci Web XML, ale ma przewagę nad konstruktorem klasy, w tym, że Object zainicjowane polecenie jest GetInitializer przekazywane do niego.

Uwaga

Można również dodać rozszerzenie PROTOKOŁU SOAP bez wyprowadzania z SoapExtensionAttribute elementu<soapExtensionTypes> w pliku konfiguracji. Aby uzyskać szczegółowe informacje, zobacz <soapExtensionTypes> Modyfikowanie elementów i komunikatów PROTOKOŁU SOAP przy użyciu rozszerzeń PROTOKOŁU SOAP.