InterfaceQueuingAttribute クラス

定義

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

継承

Object

Attribute

InterfaceQueuingAttribute

属性

AttributeUsageAttribute ComVisibleAttribute

例

次のコード例は、 InterfaceQueuingAttribute 属性の使用方法を示しています。

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

次のコード例は、 ApplicationQueuing 属性を使用して COM+ アプリケーションをコンパイル時にキューに登録し、 QueueListenerEnabled を true に設定して COM+ リスナーを有効にする方法を示しています。

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

次のコード例では、 BindToMoniker を使用してキューに登録されたモニカーを実行し、レコーダーのインスタンスを取得し、記録されるメソッドを呼び出し、レコーダー オブジェクトの解放を強制してメッセージをキューに送信する方法を示します。

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

注釈

このインターフェイスの呼び出しは、メッセージ キューを使用してキューに入れられます。

インターフェイスをキューに登録するには、次の構文を使用してこの属性をインターフェイスに適用します: [InterfaceQueuing]。

キューに登録されたインターフェイスのメンバー メソッドは、 out や ref パラメーターがないなど、キューに登録されたメソッド呼び出しの要件を満たす必要があります。

属性の使用の詳細については、「 属性」を参照してください。