TransactionFlowAttribute クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
クライアントからの受信トランザクションをサービス操作が受け入れるかどうかを指定します。
public ref class TransactionFlowAttribute sealed : Attribute, System::ServiceModel::Description::IOperationBehavior
[System.AttributeUsage(System.AttributeTargets.Method)]
public sealed class TransactionFlowAttribute : Attribute, System.ServiceModel.Description.IOperationBehavior
[<System.AttributeUsage(System.AttributeTargets.Method)>]
type TransactionFlowAttribute = class
inherit Attribute
interface IOperationBehavior
Public NotInheritable Class TransactionFlowAttribute
Inherits Attribute
Implements IOperationBehavior
- 継承
- 属性
- 実装
例
次のコード例は、操作レベルで TransactionFlowOption クラスと共にこの列挙体を使用しています。
using System;
using System.ServiceModel;
using System.Transactions;
namespace Microsoft.WCF.Documentation
{
[ServiceContract(
Namespace="http://microsoft.wcf.documentation",
SessionMode=SessionMode.Required
)]
public interface IBehaviorService
{
[OperationContract]
[TransactionFlow(TransactionFlowOption.Mandatory)]
string TxWork(string message);
}
// Note: To use the TransactionIsolationLevel property, you
// must add a reference to the System.Transactions.dll assembly.
/* The following service implementation:
* -- Processes messages on one thread at a time
* -- Creates one service object per session
* -- Releases the service object when the transaction commits
*/
[ServiceBehavior(
ConcurrencyMode=ConcurrencyMode.Single,
InstanceContextMode=InstanceContextMode.PerSession,
ReleaseServiceInstanceOnTransactionComplete=true
)]
public class BehaviorService : IBehaviorService, IDisposable
{
Guid myID;
public BehaviorService()
{
myID = Guid.NewGuid();
Console.WriteLine(
"Object "
+ myID.ToString()
+ " created.");
}
/*
/ * The following operation-level behaviors are specified:
/ * Always executes under a transaction scope.
/ * The transaction scope is completed when the operation
/ * terminates without an unhandled exception.
/*
[OperationBehavior(
TransactionAutoComplete = true,
TransactionScopeRequired = true
)]
public string TxWork(string message)
{
// Do some transactable work.
Console.WriteLine("TxWork called with: " + message);
// Display transaction information.
TransactionInformation info = Transaction.Current.TransactionInformation;
Console.WriteLine("The distributed tx ID: {0}.", info.DistributedIdentifier);
Console.WriteLine("The tx status: {0}.", info.Status);
return String.Format("Hello. This was object {0}.",myID.ToString()) ;
}
public void Dispose()
{
Console.WriteLine(
"Service "
+ myID.ToString()
+ " is being recycled."
);
}
}
}
注釈
TransactionFlowAttribute は、特定のトランザクション フロー ポリシーをサービス操作に対して宣言的に関連付けるために使用されます。 この属性の TransactionFlowOption プロパティは、該当する操作が、クライアントからフローされるトランザクションを受け入れるかどうか、または、操作がクライアントに、トランザクションを常にフローするように要求するかどうかを指定します。
TransactionFlowAttribute は、特定の操作に対してプログラムによって関連付ける操作動作として、トランザクション フロー ポリシーを使用することもできます。 この場合は、操作の説明の Behaviors
コレクションに追加する必要があります。
注意
OperationContract
を使用する各メソッドの TransactionFlowAttribute には、完全修飾された Action
文字列を用意する必要があります。 値 "*" はサポートされません。
コンストラクター
TransactionFlowAttribute(TransactionFlowOption) |
TransactionFlowAttribute クラスの新しいインスタンスを初期化します。 |
プロパティ
Transactions |
受信トランザクションがサポートされるかどうかを示す値を取得します。 |
TypeId |
派生クラスで実装されると、この Attribute の一意の識別子を取得します。 (継承元 Attribute) |
メソッド
Equals(Object) |
このインスタンスが、指定されたオブジェクトと等価であるかどうかを示す値を返します。 (継承元 Attribute) |
GetHashCode() |
このインスタンスのハッシュ コードを返します。 (継承元 Attribute) |
GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
IsDefaultAttribute() |
派生クラスでオーバーライドされるとき、このインスタンスの値が派生クラスの既定値であるかどうかを示します。 (継承元 Attribute) |
Match(Object) |
派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (継承元 Attribute) |
MemberwiseClone() |
現在の Object の簡易コピーを作成します。 (継承元 Object) |
ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
明示的なインターフェイスの実装
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
一連の名前を対応する一連のディスパッチ識別子に割り当てます。 (継承元 Attribute) |
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
オブジェクトの型情報を取得します。この情報はインターフェイスの型情報の取得に使用できます。 (継承元 Attribute) |
_Attribute.GetTypeInfoCount(UInt32) |
オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。 (継承元 Attribute) |
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
オブジェクトによって公開されたプロパティおよびメソッドへのアクセスを提供します。 (継承元 Attribute) |
IOperationBehavior.AddBindingParameters(OperationDescription, BindingParameterCollection) |
この操作の動作をサポートするための追加パラメーター (設定) をバインド コンテキストに追加します。 このメソッドは継承できません。 |
IOperationBehavior.ApplyClientBehavior(OperationDescription, ClientOperation) |
属性がマークするメソッドの |
IOperationBehavior.ApplyDispatchBehavior(OperationDescription, DispatchOperation) |
属性がマークするメソッドの DispatchOperation オブジェクトに、属性の機能を結び付けます。 このメソッドは継承できません。 |
IOperationBehavior.Validate(OperationDescription) |
操作がこの動作をサポートできることを検証します。 このメソッドは継承できません。 |
適用対象
こちらもご覧ください
.NET