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 samotné pomocí dat uložených 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

Vrácený Object z GetInitializer(LogicalMethodInfo, SoapExtensionAttribute) mezipaměti 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 členských proměnných.

• GetInitializer - Tato metoda se volá jen jednou, při prvním provedení požadavku SOAP do metody webových služeb XML. Pokud se pro metodu webové služby XML použije vlastní atribut, vyvolá se GetInitializer metoda. To umožňuje rozšíření SOAP projít LogicalMethodInfo metodu webové služby XML pro prototypové informace nebo získat přístup k datům specifických pro rozšíření předávaná třídou odvozenou z SoapExtensionAttribute. Návratová hodnota je uložena do mezipaměti ASP.NET a předána do dalších Initialize metod. Inicializace se GetInitializer proto zapouzdří v podstatě do jednorázového dosažení výkonu.

• Initialize - Tato metoda se volá pokaždé, když se požadavek SOAP provádí do metody 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í.

Poznámka

Rozšíření SOAP můžete také přidat bez odvození z SoapExtensionAttribute elementu<soapExtensionTypes> v konfiguračním souboru. Podrobnosti najdete v tématu <soapExtensionTypes> Úpravy elementů a zpráv SOAP pomocí rozšíření SOAP.