閱讀英文

共用方式為

Cer 列舉

  • 參考

定義

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

警告

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

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

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

欄位

名稱 值 Description
MayFail 1

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

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

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

範例

下列程式代碼範例示範在指定方法的限制執行區域時，列舉的使用 Cer 方式。 此程式代碼範例是建構函式所提供較大範例的 ReliabilityContractAttribute 一部分。

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

備註

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

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

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

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

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

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

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

適用於

產品 版本 (已淘汰)
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1 (5, 6, 7, 8, 9)
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

另請參閱