Cer 列挙体とは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

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

Cer 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

制約された実行領域内で呼び出されたときのメソッドの動作を指定します。

名前空間: System.Runtime.ConstrainedExecution
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
Public Enumeration Cer

Visual Basic (使用法)

Dim instance As Cer

[SerializableAttribute] 
public enum Cer

C++

[SerializableAttribute] 
public enum class Cer

/** @attribute SerializableAttribute() */ 
public enum Cer

JScript

SerializableAttribute 
public enum Cer

メンバ

メンバ名説明

MayFail 例外条件が発生した場合、メソッドが失敗する可能性があります。この場合、メソッドは、成功したか失敗したかの報告を呼び出し元のメソッドに戻します。このメソッドで確実に戻り値を報告できるようにするためには、メソッド本体を CER 内に含める必要があります。

	メンバ名	説明
	MayFail	例外条件が発生した場合、メソッドが失敗する可能性があります。この場合、メソッドは、成功したか失敗したかの報告を呼び出し元のメソッドに戻します。このメソッドで確実に戻り値を報告できるようにするためには、メソッド本体を CER 内に含める必要があります。
	None	メソッド、型、またはアセンブリには、CER の概念はありません。CER の保証を利用しません。これは次のことを意味します。例外条件が発生すると、メソッドが失敗する場合があります。メソッドは、失敗という報告ができる場合も、できない場合もあります (非確定的です)。メソッドは、CER の使用を考慮して作成されていません (最も可能性の高いシナリオ)。メソッド、型、またはアセンブリは、成功したことが明示的にマークされていない場合、暗黙的に Cer.None としてマークされます。
	Success	例外条件が発生しても、メソッドは必ず成功します。非 CER 領域内から呼び出された場合でも、呼び出されるメソッドの周囲には常に CER を構築する必要があります。期待どおりに実行された場合、メソッドは成功です。たとえば、Count を `ReliabilityContractAttribute(Cer.Success)` とマークすると、CER で実行された場合に常に ArrayList の要素数を返し、内部フィールドを未確定の状態にしておけないことを意味します。

None

メソッド、型、またはアセンブリには、CER の概念はありません。CER の保証を利用しません。これは次のことを意味します。

例外条件が発生すると、メソッドが失敗する場合があります。
メソッドは、失敗という報告ができる場合も、できない場合もあります (非確定的です)。
メソッドは、CER の使用を考慮して作成されていません (最も可能性の高いシナリオ)。

メソッド、型、またはアセンブリは、成功したことが明示的にマークされていない場合、暗黙的に Cer.None としてマークされます。

Success 例外条件が発生しても、メソッドは必ず成功します。非 CER 領域内から呼び出された場合でも、呼び出されるメソッドの周囲には常に CER を構築する必要があります。期待どおりに実行された場合、メソッドは成功です。たとえば、Count を ReliabilityContractAttribute(Cer.Success) とマークすると、CER で実行された場合に常に ArrayList の要素数を返し、内部フィールドを未確定の状態にしておけないことを意味します。

解説

Cer 列挙体は、制約された実行領域 (CER) 内のメソッド、型、またはアセンブリの動作を指定します。利用できる 3 つの値のいずれかを使用して、エンティティが成功する、エンティティが CER を確認できない、またはエンティティが成功か失敗を報告できる可能性が (確定的に) あるということを示します。

CER は、中止されたスレッドのメモリ不足例外やスタックオーバーフローなどの非同期例外が発生しても、コードの領域が中断されることなく実行されることを保証します。

使用例

Cer 列挙体を使用してメソッドの制約された実行領域を指定するコード例を次に示します。次のコード例は、ReliabilityContractAttribute コンストラクタの例の一部です。

[ReliabilityContract(Consistency.WillNotCorruptState, Cer.Success)]
[MethodImpl(MethodImplOptions.NoInlining)]
void StackDepth2()
{
    try
    {
        consistentLevel2 = false;
        if (depth == 2)
            Thread.Sleep(-1);
        StackDepth3();
    }
    finally
    {
        consistentLevel2 = true;
    }
}