ContextUtil.DeactivateOnReturn プロパティ

.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

C#

public static bool DeactivateOnReturn
 { get; set; }

C++

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

J#

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

C#

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

};

J#

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

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ContextUtil クラス
ContextUtil メンバ
System.EnterpriseServices 名前空間