ObjectPoolingAttribute Klasse

Referenz

Definition

Namespace:: System.EnterpriseServices

Assembly:: System.EnterpriseServices.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Aktiviert und konfiguriert Objektpooling für eine Komponente. Diese Klasse kann nicht vererbt werden.

public ref class ObjectPoolingAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class, Inherited=true)]
[System.Runtime.InteropServices.ComVisible(false)]
public sealed class ObjectPoolingAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class, Inherited=true)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
type ObjectPoolingAttribute = class
    inherit Attribute

Public NotInheritable Class ObjectPoolingAttribute
Inherits Attribute

Vererbung: Object

Attribute
ObjectPoolingAttribute

Attribute: AttributeUsageAttribute ComVisibleAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Attributs veranschaulicht.

#using <System.Windows.Forms.dll>
#using <System.Transactions.dll>
#using <System.EnterpriseServices.dll>

using namespace System;
using namespace System::EnterpriseServices;
using namespace System::Windows::Forms;


[assembly:ApplicationName("ObjectInspector")];
[assembly:ApplicationActivation(ActivationOption::Server)];
[assembly:System::Reflection::AssemblyKeyFile("Inspector.snk")];
[JustInTimeActivation]
[ObjectPooling(MinPoolSize=2,MaxPoolSize=100,CreationTimeout=1000)]
public ref class ObjectInspector: public ServicedComponent
{
public:
   String^ IdentifyObject( Object^ obj )
   {
      // Return this object to the pool after use.
      ContextUtil::DeactivateOnReturn = true;

      // Get the supplied object's type.        
      Type^ objType = obj->GetType();

      // Return its name.
      return (objType->FullName);
   }

protected:
   virtual void Activate() override
   {
      MessageBox::Show( String::Format( "Now entering...\nApplication: {0}\nInstance: {1}\nContext: {2}\n", ContextUtil::ApplicationId.ToString(), ContextUtil::ApplicationInstanceId.ToString(), ContextUtil::ContextId.ToString() ) );
   }

   virtual void Deactivate() override
   {
      MessageBox::Show( "Bye Bye!" );
   }

   // This object can be pooled.
   virtual bool CanBePooled() override
   {
      return (true);
   }
};

using System;
using System.EnterpriseServices;
using System.Windows.Forms;

[assembly: ApplicationName("ObjectInspector")]
[assembly: ApplicationActivation(ActivationOption.Server)]
[assembly: System.Reflection.AssemblyKeyFile("Inspector.snk")]

[JustInTimeActivation]
[ObjectPooling(MinPoolSize=2, MaxPoolSize=100, CreationTimeout=1000)]
public class ObjectInspector : ServicedComponent
{

    public string IdentifyObject (Object obj)
    {
        // Return this object to the pool after use.
        ContextUtil.DeactivateOnReturn = true;

        // Get the supplied object's type.
        Type objType = obj.GetType();

        // Return its name.
        return(objType.FullName);
    }

    protected override void Activate()
    {
        MessageBox.Show( String.Format("Now entering...\nApplication: {0}\nInstance: {1}\nContext: {2}\n",
                                       ContextUtil.ApplicationId.ToString(), ContextUtil.ApplicationInstanceId.ToString(),
                                       ContextUtil.ContextId.ToString() ) );
    }

    protected override void Deactivate()
    {
        MessageBox.Show("Bye Bye!");
    }

    // This object can be pooled.
    protected override bool CanBePooled()
    {
        return(true);
    }
}

Imports System.EnterpriseServices
Imports System.Windows.Forms



<Assembly: ApplicationName("ObjectInspector")> 
<Assembly: ApplicationActivation(ActivationOption.Server)> 
<Assembly: System.Reflection.AssemblyKeyFile("Inspector.snk")> 
 
<JustInTimeActivation(), ObjectPooling(MinPoolSize := 2, MaxPoolSize := 100, CreationTimeout := 1000)>  _
Public Class ObjectInspector
    Inherits ServicedComponent
    
    
    Public Function IdentifyObject(ByVal obj As [Object]) As String 
        ' Return this object to the pool after use.
        ContextUtil.DeactivateOnReturn = True
        
        ' Get the supplied object's type.        
        Dim objType As Type = obj.GetType()
        
        ' Return its name.
        Return objType.FullName
    
    End Function 'IdentifyObject

    Protected Overrides Sub Activate() 
        MessageBox.Show(String.Format("Now entering..." + vbLf + "Application: {0}" + vbLf + "Instance: {1}" + vbLf + "Context: {2}" + vbLf, ContextUtil.ApplicationId.ToString(), ContextUtil.ApplicationInstanceId.ToString(), ContextUtil.ContextId.ToString()))
    
    End Sub

    Protected Overrides Sub Deactivate() 
        MessageBox.Show("Bye Bye!")
    
    End Sub

    ' This object can be pooled.
    Protected Overrides Function CanBePooled() As Boolean 
        Return True
    
    End Function 'CanBePooled

End Class

Hinweise

Wenn Objektpooling angegeben ist, darf es im COM+-Katalog nicht deaktiviert werden. wenn sie im COM+-Katalog aktiviert ist, muss er für die Komponente angegeben werden.

Eine Liste der anfänglichen Eigenschaftswerte für eine instance von ObjectPoolingAttributefinden Sie im ObjectPoolingAttribute Konstruktor.

Weitere Informationen zur Verwendung von Attributen finden Sie unter Attribute.

Konstruktoren

ObjectPoolingAttribute()	Initialisiert eine neue Instanz der ObjectPoolingAttribute-Klasse und legt die Enabled-Eigenschaft, die MaxPoolSize-Eigenschaft, die MinPoolSize-Eigenschaft und die CreationTimeout-Eigenschaft auf die jeweiligen Standardwerte fest.
ObjectPoolingAttribute(Boolean)	Initialisiert eine neue Instanz der ObjectPoolingAttribute-Klasse und legt die Enabled-Eigenschaft fest.
ObjectPoolingAttribute(Boolean, Int32, Int32)	Initialisiert eine neue Instanz der ObjectPoolingAttribute-Klasse und legt die Enabled-Eigenschaft, die MaxPoolSize-Eigenschaft und die MinPoolSize-Eigenschaft fest.
ObjectPoolingAttribute(Int32, Int32)	Initialisiert eine neue Instanz der ObjectPoolingAttribute-Klasse und legt die MaxPoolSize-Eigenschaft und die MinPoolSize-Eigenschaft fest.

Eigenschaften

CreationTimeout	Ruft die Zeitdauer ab, die gewartet werden soll, bis ein Objekt im Pool verfügbar wird, bevor eine Ausnahme ausgelöst wird, oder legt diese fest. Dieser Wert wird in Millisekunden angegeben.
Enabled	Ruft einen Wert ab, der angibt, ob Objektpooling aktiviert ist, oder legt diesen fest.
MaxPoolSize	Ruft den Wert für die maximale Poolgröße ab oder legt diesen fest.
MinPoolSize	Ruft den Wert für die minimale Poolgröße ab oder legt diesen fest.
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)

Methoden

AfterSaveChanges(Hashtable)	Wird intern von der .NET Framework-Infrastruktur beim Installieren und Konfigurieren von Assemblys im COM+-Katalog aufgerufen.
Apply(Hashtable)	Wird intern von der .NET Framework-Infrastruktur beim Anwenden des ObjectPoolingAttribute-Klassenattributs auf eine Serviced Component aufgerufen.
Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
IsValidTarget(String)	Wird intern von der .NET Framework-Infrastruktur beim Installieren und Konfigurieren von Assemblys im COM+-Katalog aufgerufen.
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Geerbt von Attribute)

Gilt für:

Freigeben über