Cer 列舉

  • 參考

定義

命名空間:
System.Runtime.ConstrainedExecution
組件:
System.Runtime.dll
組件:
mscorlib.dll
組件:
netstandard.dll

警告

The Constrained Execution Region (CER) feature is not supported.

指定在限制之執行區域內呼叫時的方法行為。

public enum class Cer
[System.Obsolete("The Constrained Execution Region (CER) feature is not supported.", DiagnosticId="SYSLIB0004", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public enum Cer
public enum Cer
[System.Serializable]
public enum Cer
[<System.Obsolete("The Constrained Execution Region (CER) feature is not supported.", DiagnosticId="SYSLIB0004", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
type Cer = 
type Cer = 
[<System.Serializable>]
type Cer = 
Public Enum Cer
繼承
Object
ValueType
Enum
Cer
屬性
ObsoleteAttribute SerializableAttribute

欄位

MayFail 1

在例外條件下，此方法可能失敗。 在這種情況下，此方法會向呼叫方法報告成功或失敗。 此方法必須在方法主體的週圍具備 CER 以確保它可以報告傳回值。
None 0

方法、型別或組件沒有 CER 概念。 它不會利用 CER 保證。
Success 2

在例外條件下，此方法會保證成功。 應永遠在呼叫的方法週圍建構 CER，即使它是從非 CER 區域中呼叫的也如此。 如果完成其預定要做的，則方法會成功。 例如，以標記CountReliabilityContractAttribute(Cer.Success)表示在 CER 下執行時，它一律會傳回 中ArrayList元素數目的計數，而且永遠不會讓內部欄位處於不確定的狀態。

範例

下列程式代碼範例示範在指定方法的限制執行區域時，列舉的使用 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;
    }
}

<ReliabilityContract(Consistency.WillNotCorruptState, Cer.Success)>
<MethodImpl(MethodImplOptions.NoInlining)>
Sub StackDepth2()
   Try
      consistentLevel2 = False
      If depth = 2 Then Thread.Sleep(-1)
      StackDepth3()
   Finally
      consistentLevel2 = True
   End Try
End Sub

備註

列舉 Cer 會指定限制執行區域內的方法、類型或元件的行為， (CER) 。 使用三個可用值的其中一個，表示實體將成功、不知道 CER，或可能具決定性地 () 能夠回報成功或失敗。

CER 提供保證即使引發異步例外狀況之類的異步例外狀況，程式代碼區域仍會執行不中斷，或引發堆棧溢位。

不過， Cer.None 列舉值表示方法、類型或元件沒有 CER 的概念。 它不會利用 CER 保證。 這具有如下表示：

  • 在遇到例外狀況時，方法可能會失敗。

  • 方法可能或可能不會回報失敗， (它是不具決定性的) 。

  • 方法不會以 CER 撰寫， (這是最可能的情況) 。

如果方法、類型或元件未明確標示為成功，則會隱含標示為 Cer.None。

適用於

另請參閱