SoapExtension.Initialize(Object) Méthode

Définition

Espace de noms:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

En cas de substitution dans une classe dérivée, permet à une extension SOAP de s'auto-initialiser à l'aide des données mises en cache dans la méthode 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)

Paramètres

initializer

Object

Object retourné par GetInitializer(LogicalMethodInfo, SoapExtensionAttribute) mis en cache par ASP.NET.

Exemples

L’exemple suivant montre comment utiliser les données mises en cache pendant la GetInitializer méthode.

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

Remarques

Une extension SOAP offre trois occasions d’initialiser les données et elles ont tous des objectifs différents :

• Constructeur de classe : le constructeur de classe est appelé chaque fois qu’une extension SOAP est instanciée et est généralement utilisée pour initialiser les variables membres.

• GetInitializer - Cette méthode est appelée une seule fois, la première fois qu’une requête SOAP est effectuée à une méthode de services Web XML. Si un attribut personnalisé est appliqué à la méthode de service Web XML, la GetInitializer méthode est appelée. Cela permet à l’extension SOAP d’interroger la LogicalMethodInfo méthode de service web XML pour les informations prototypes ou d’accéder aux données spécifiques à l’extension passées par une classe dérivant de SoapExtensionAttribute. La valeur de retour est mise en cache par ASP.NET et passée dans les méthodes suivantesInitialize. Par conséquent, l’initialisation effectuée est GetInitializer encapsulée essentiellement dans un accès à performances unique.

• Initialize - Cette méthode est appelée chaque fois qu’une requête SOAP est effectuée à une méthode de service Web XML, mais a un avantage sur le constructeur de classe, dans ce cas, que le Object composant initialisé GetInitializer est transmis à celui-ci.

Notes

Vous pouvez également ajouter une extension SOAP sans dériver à l’aide de SoapExtensionAttribute l’élément<soapExtensionTypes> dans un fichier de configuration. Pour plus d’informations, consultez <soapExtensionTypes> Modification d’élément et de message SOAP à l’aide d’extensions SOAP.