InterfaceQueuingAttribute Osztály

Definíció

Névtér:

System.EnterpriseServices

Szerelvény:

System.EnterpriseServices.dll

Lehetővé teszi a várólisták támogatását a megjelölt felülethez. Ez az osztály nem örökölhető.

public ref class InterfaceQueuingAttribute sealed : Attribute

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

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

Public NotInheritable Class InterfaceQueuingAttribute
Inherits Attribute

Öröklődés

Object

Attribute

InterfaceQueuingAttribute

Attribútumok

AttributeUsageAttribute ComVisibleAttribute

Példák

Az alábbi példakód bemutatja az InterfaceQueuingAttribute attribútum használatát.

public interface class IQueuedComponent
{
   void QueuedTask();
};


// Mark IQueuedComponent interface as queued
// Create the queued component class by inheriting the 
// System.EnterpriseServices.ServicedComponent class and an
// interface that is marked as queued with the InterfaceQueuing attribute

[InterfaceQueuing(true,Interface="IQueuedComponent")]
public ref class QueuedComponent sealed: public ServicedComponent, public IQueuedComponent
{
public:
   virtual void QueuedTask()
   {
      // Perform queued task here
   }

};

public interface IQueuedComponent
{
    void QueuedTask();
}
// Mark IQueuedComponent interface as queued
[InterfaceQueuing(true, Interface="IQueuedComponent")]
// Create the queued component class by inheriting the
// System.EnterpriseServices.ServicedComponent class and an
// interface that is marked as queued with the InterfaceQueuing attribute
public class QueuedComponent : ServicedComponent, IQueuedComponent
{
    public void QueuedTask()
    {
        // Perform queued task here
    }
}

Az alábbi példakód bemutatja, hogyan jelölhet meg egy COM+ alkalmazást várólistára fordításkor az ApplicationQueuing attribútum használatával, és hogyan engedélyezheti a COM+ figyelőt a QueueListenerEnabled true (igaz) értékre állításával

// Mark the COM+ application as queued at compile time by using the 
// ApplicationQueuing attribute. Enable the COM+ listener by 
// setting the QueueListenerEnabled to true
[assembly:ApplicationQueuing(Enabled=true,QueueListenerEnabled=true)];

// Mark the COM+ application as queued at compile time by using the
// ApplicationQueuing attribute. Enable the COM+ listener by
// setting the QueueListenerEnabled to true
[assembly: ApplicationQueuing(Enabled=true, QueueListenerEnabled=true)]

Az alábbi példakód bemutatja, hogyan futtatható BindToMoniker az üzenetsoros moniker, hogyan szerezheti be a felvevő egy példányát, hogyan hívhatja meg a rögzíteni kívánt metódust, és hogyan kényszerítheti a rögzítőobjektum kiadását az üzenetsorba való küldéséhez.

// Use BindToMoniker to run the queued moniker, to get an instance of the recorder
IQueuedComponent ^ qc = dynamic_cast<IQueuedComponent^>(System::Runtime::InteropServices::Marshal::BindToMoniker( "queue:/new:QueuedComponent" ));

// Call the method that will be recorded
qc->QueuedTask();

// Force the release of the recorder object, to send the message to the queue
System::Runtime::InteropServices::Marshal::ReleaseComObject( qc );

// Use BindToMoniker to run the queued moniker, to get an instance of the recorder
IQueuedComponent qc =
    (IQueuedComponent)System.Runtime.InteropServices.Marshal.BindToMoniker("queue:/new:QueuedComponent");
// Call the method that will be recorded
qc.QueuedTask();

// Force the release of the recorder object, to send the message to the queue
System.Runtime.InteropServices.Marshal.ReleaseComObject(qc);

Megjegyzések

Az ezen a felületen lévő hívások üzenetsorba kerülnek a Message Queuing használatával.

Ha várólistára szeretne jelölni egy felületet, alkalmazza ezt az attribútumot a felületre a következő szintaxissal: [InterfaceQueuing].

Az üzenetsoros felület tagmetódusainak meg kell felelniük az üzenetsoros metódushívások követelményeinek, például nem out vagy ref paraméterekkel.

Az attribútumok használatáról további információt az Attribútumok című témakörben talál.

Konstruktorok

Name	Description
InterfaceQueuingAttribute()	Inicializálja az InterfaceQueuingAttribute osztály új példányát, amely Enabled az alapértelmezett értékre állítja a Interface tulajdonságokat.
InterfaceQueuingAttribute(Boolean)	Inicializálja az osztály új példányát, opcionálisan letiltva a InterfaceQueuingAttribute sorba állítási támogatást.

Tulajdonságok

Name	Description
Enabled	Lekéri vagy beállít egy értéket, amely jelzi, hogy engedélyezve van-e a sorba állítás támogatása.
Interface	Lekéri vagy beállítja annak a felületnek a nevét, amelyen a sorba állítás engedélyezve van.
TypeId	Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute)

Metódusok

Name	Description
Equals(Object)	Olyan értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e egy adott objektummal. (Öröklődés forrása Attribute)
GetHashCode()	A példány kivonatkódját adja vissza. (Öröklődés forrása Attribute)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsDefaultAttribute()	Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke. (Öröklődés forrása Attribute)
Match(Object)	Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Explicit interfész-implementációk

Name	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Névkészletet képez le a küldési azonosítók megfelelő készletére. (Öröklődés forrása Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Lekéri egy objektum típusadatait, amelyek a felület típusadatainak lekérésére használhatók. (Öröklődés forrása Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Lekéri az objektumok által biztosított típusinformációs felületek számát (0 vagy 1). (Öröklődés forrása Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Hozzáférést biztosít az objektumok által közzétett tulajdonságokhoz és metódusokhoz. (Öröklődés forrása Attribute)