SoapExtension.Initialize(Object) Metoda

Definice

Obor názvů:

System.Web.Services.Protocols

Sestavení:

System.Web.Services.dll

Při přepsání v odvozené třídě umožňuje rozšíření SOAP inicializovat sám sebe pomocí dat uložených v mezipaměti v GetInitializer(LogicalMethodInfo, SoapExtensionAttribute) metodě.

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

Hodnota Object vrácená z GetInitializer(LogicalMethodInfo, SoapExtensionAttribute) uložená ASP.NET.

Příklady

Následující příklad ukazuje, jak můžete použít data uložená v mezipaměti během GetInitializer 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

Poznámky

Rozšíření SOAP má tři příležitosti k inicializaci dat a všechny mají různé účely:

• Konstruktor třídy – Konstruktor třídy se volá při každém vytvoření instance rozšíření SOAP a obvykle se používá k inicializaci proměnných členů.

• GetInitializer - Tato metoda se volá jen jednou, při prvním provedení požadavku SOAP na metodu webových služeb XML. Pokud se pro metodu webové služby XML použije vlastní atribut, GetInitializer vyvolá se metoda. To umožňuje rozšíření SOAP interrogate LogicalMethodInfo of an XML Web service method for prototype information or to access extension-specific data předané třídou odvozené z SoapExtensionAttribute. Návratová hodnota je uložena do mezipaměti ASP.NET a předána do následných metod Initialize. Inicializace provedená v GetInitializer důsledku toho je zapouzdřena v podstatě do jednorázového dosažení výkonu.

• Initialize - Tato metoda se volá při každém požadavku SOAP na metodu webové služby XML, ale má výhodu oproti konstruktoru třídy, v tom, že Object inicializované inicializace GetInitializer je předána do ní.

Note

Rozšíření SOAP můžete také přidat bez odvození pomocí SoapExtensionAttribute<soapExtensionTypes> Element v konfiguračním souboru. Podrobnosti naleznete v tématu< soapExtensionTypes> Element a SOAP Message Úpravy pomocí rozšíření SOAP.