既定のサービスの動作

[アーティクル]
12/07/2010

このサンプルでは、サービスの動作設定を構成する方法を示します。このサンプルは、ICalculator サービスコントラクトを実装する「入門サンプル」に基づいています。このサンプルは、ServiceBehaviorAttribute 属性と OperationBehaviorAttribute 属性を使用して、サービスの動作と操作の動作を明示的に定義しています。動作の構成は、このサンプルに示すように、構成ファイルで行うことも、コード内で強制的に行うこともできます。

この例では、クライアントはコンソールアプリケーション (.exe) で、サービスはインターネットインフォメーションサービス (IIS) によってホストされます。

注 :
このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。

サービスクラスは、ServiceBehaviorAttribute と OperationBehaviorAttribute を使用して動作を指定します。次のサンプルコードを参照してください。指定されたすべての値は、既定値です。

[ServiceBehavior(
    AutomaticSessionShutdown=true,
    ConcurrencyMode=ConcurrencyMode.Single,
    InstanceContextMode=InstanceContextMode.PerSession,
    IncludeExceptionDetailInFaults=false,
    UseSynchronizationContext=true,
    ValidateMustUnderstand=true)]
public class CalculatorService : ICalculator
{
    [OperationBehavior(
        TransactionAutoComplete=true,
        TransactionScopeRequired=false,
        Impersonation=ImpersonationOption.NotAllowed)]
    public double Add(double n1, double n2)
    {
        System.Threading.Thread.Sleep(1600);
        return n1 + n2;
    }
    ...
}

サービスの動作は、ServiceBehaviorAttribute 属性で指定されます。これらの動作のいくつかを次の表に示します。

サービスの動作	説明
AutomaticSessionShutdown	セッションをクライアントの要求で自動的にシャットダウンします。
ConcurrencyMode	各サービスインスタンスの同時実行モードを指定します。
InstanceContextMode	インスタンスコンテキストモードを指定します。
UseSynchronizationContext	同期コンテキストが設定されている場合、その同期コンテキストを使用するかどうかを判断します。Windows フォームアプリケーションで WindowsFormsSynchronizationContext を使用するかどうかを制御する場合に、これを使用します。
IncludeExceptionDetailInFaults	一般的な未処理の実行例外を Fault<string> に変換してエラーメッセージとして送信するかどうかを判断します。
TransactionIsolationLevel	トランザクションの分離レベルを指定します。
ValidateMustUnderstand	予期しないメッセージのヘッダーがエラーの原因であるかどうかを判断します。

操作の動作は OperationBehaviorAttribute 属性を使用して指定されます。これらの動作のいくつかを次の表に示します。

操作の動作	説明
TransactionAutoComplete	現在のトランザクションがサービス操作の完了によってコミットされるかどうかを判断します。
TransactionScopeRequired	サービス操作がクライアントからフローされたトランザクションに参加するかどうかを判断します。
Impersonation	サービス操作が呼び出し元の ID を偽装するかどうかを判断します。
ReleaseInstanceMode	サービス操作の呼び出しの開始時または終了時に、サービスインスタンスが再利用されるかどうかを判断します。

このサンプルを実行する場合は、操作要求および応答はクライアントのコンソールウィンドウに表示されます。呼び出し間の遅延は、サービス操作で System.Threading.Thread.Sleep() が呼び出されることによるものです。以降の動作サンプルでは、これらの動作の詳細について説明します。クライアントをシャットダウンするには、クライアントウィンドウで Enter キーを押します。

Add(100,15.99) = 115.99
Subtract(145,76.54) = 68.46
Multiply(9,81.25) = 731.25
Divide(22,7) = 3.14285714285714

Press <ENTER> to terminate client.

サンプルを設定、ビルド、および実行するには

「Windows Communication Foundation サンプルの 1 回限りのセットアップの手順」が実行済みであることを確認します。
ソリューションの C# 版または Visual Basic .NET 版をビルドするには、「Windows Communication Foundation サンプルのビルド」の手順に従います。
単一コンピューター構成か複数コンピューター構成かに応じて、「Running the Windows Communication Foundation Samples」の手順に従います。

注 :
サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の (既定の) ディレクトリを確認してください。 `<InstallDrive>:\WF_WCF_Samples` このディレクトリが存在しない場合は、「.NET Framework 4 向けの Windows Communication Foundation (WCF) および Windows Workflow Foundation (WF) のサンプル」にアクセスして、Windows Communication Foundation (WCF) および WF のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。 `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Behaviors\Default`

注 :

サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の (既定の) ディレクトリを確認してください。

<InstallDrive>:\WF_WCF_Samples

このディレクトリが存在しない場合は、「.NET Framework 4 向けの Windows Communication Foundation (WCF) および Windows Workflow Foundation (WF) のサンプル」にアクセスして、Windows Communication Foundation (WCF) および WF のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。

<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Behaviors\Default

次の方法で共有

既定のサービスの動作

サンプルを設定、ビルド、および実行するには

その他のリソース