ContextUtil.DeactivateOnReturn プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ContextUtil.DeactivateOnReturn プロパティ

COM+ コンテキストの done ビットを取得または設定します。

名前空間: System.EnterpriseServices
アセンブリ: System.EnterpriseServices (system.enterpriseservices.dll 内)
構文

Visual Basic (宣言)

Public Shared Property DeactivateOnReturn
 As Boolean

Visual Basic (使用法)

Dim value As Boolean

value = ContextUtil.DeactivateOnReturn

ContextUtil.DeactivateOnReturn = value

public static bool DeactivateOnReturn
 { get; set; }

C++

public:
static property bool DeactivateOnReturn {
    bool get ();
    void set (bool value);
}

/** @property */
public static boolean get_DeactivateOnReturn
 ()

/** @property */
public static void set_DeactivateOnReturn
 (boolean value)

JScript

public static function get
 DeactivateOnReturn () : boolean

public static function set
 DeactivateOnReturn (value : boolean)

プロパティ値
メソッドが返されるとこのオブジェクトが非アクティブになる場合は true。それ以外の場合は false。既定値は false です。

例外

例外の種類	条件
COMException	使用できる COM+ コンテキストがありません。
PlatformNotSupportedException	プラットフォームが Windows 2000 以降ではありません。

解説

COM+ の done ビットは、処理が完了したオブジェクトをいつまでアクティブにしておくかを制御し、トランザクションの終了までの期間を決めることができます。メソッドの呼び出しが返されると、COM+ は done ビットを検査します。done ビットが true の場合、COM+ はオブジェクトを非アクティブにします。done ビットが false の場合、オブジェクトは非アクティブにされません。

使用例

DeactivateOnReturn プロパティを使用して、メソッド呼び出しの後に、確実に ServicedComponent を非アクティブ化する方法のコード例を次に示します。

Visual Basic

<Transaction()>  _
Public Class TransactionalComponent
    Inherits ServicedComponent
    
    
    Public Sub TransactionalMethod(ByVal
 data As String) 
        
        ContextUtil.DeactivateOnReturn = True
        ContextUtil.MyTransactionVote = TransactionVote.Abort
        
        ' Do work with data. Return if any errors occur.
        ' Vote to commit. If any errors occur, this code will not execute.
        ContextUtil.MyTransactionVote = TransactionVote.Commit
    
    End Sub 'TransactionalMethod
 
End Class 'TransactionalComponent

[Transaction]
public class TransactionalComponent : ServicedComponent
{

    public void TransactionalMethod (string
 data)
    {

      ContextUtil.DeactivateOnReturn = true;
      ContextUtil.MyTransactionVote = TransactionVote.Abort;

      // Do work with data. Return if any errors occur.

      // Vote to commit. If any errors occur, this code will not execute.
      ContextUtil.MyTransactionVote = TransactionVote.Commit;

    }

}

C++

[assembly:System::Reflection::AssemblyKeyFile("Transaction.snk")];
[Transaction]
public ref class TransactionalComponent: public
 ServicedComponent
{
public:
   void TransactionalMethod( String^ data )
   {
      ContextUtil::DeactivateOnReturn = true;
      ContextUtil::MyTransactionVote = TransactionVote::Abort;
      
      // do work with data
      ContextUtil::MyTransactionVote = TransactionVote::Commit;
   }

};

/** @attribute Transaction()
 */
public class TransactionalComponent extends
 ServicedComponent
{
    public void TransactionalMethod(String
 data)
    {
        ContextUtil.set_DeactivateOnReturn(true);
        ContextUtil.set_MyTransactionVote(TransactionVote.Abort);

        // Do work with data. Return if any errors occur.
        // Vote to commit. If any errors occur, this code will not execute.
        ContextUtil.set_MyTransactionVote(TransactionVote.Commit);
    } //TransactionalMethod 
} //TransactionalComponent