Cer Enumeration

  • Referenz

Definition

Namespace:
System.Runtime.ConstrainedExecution
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Achtung

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

Gibt das Verhalten einer Methode beim Aufruf innerhalb eines eingeschränkten Ausführungsbereichs an.

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
Vererbung
Object
ValueType
Enum
Cer
Attribute
ObsoleteAttribute SerializableAttribute

Felder

MayFail 1

Unter Ausnahmebedingungen könnte die Methode fehlschlagen. In diesem Fall signalisiert die Methode der aufrufenden Methode, ob die Ausführung erfolgreich war oder fehlgeschlagen ist. Der Rumpf der Methode muss in einen eingeschränkten Ausführungsbereich eingeschlossen werden, um sicherzustellen, dass der Rückgabewert ausgegeben werden kann.
None 0

Die Methode, der Typ oder die Assembly verfügt über keinen eingeschränkten Ausführungsbereich. CER-Garantien können nicht genutzt werden.
Success 2

Unter Ausnahmebedingungen wird die Methode garantiert erfolgreich ausgeführt. Sie sollten immer einen eingeschränkten Ausführungsbereich um die aufgerufene Methode herum erstellen, auch wenn diese aus einem nicht eingeschränkten Ausführungsbereich heraus aufgerufen wird. Die Ausführung einer Methode ist erfolgreich, wenn dabei das erreicht wird, was beabsichtigt wurde. Das Markieren Count mit ReliabilityContractAttribute(Cer.Success) impliziert beispielsweise, dass beim Ausführen unter einer CER immer die Anzahl der Elemente in der ArrayList zurückgegeben wird und die internen Felder nie in einem unbestimmten Zustand bleiben können.

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung der Cer Enumeration beim Angeben eines eingeschränkten Ausführungsbereichs für eine Methode. Dieses Codebeispiel ist Teil eines größeren Beispiels für den ReliabilityContractAttribute Konstruktor.

[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

Hinweise

Die Cer Enumeration gibt das Verhalten einer Methode, eines Typs oder einer Assembly innerhalb einer eingeschränkten Ausführungsregion (CER) an. Verwenden Sie einen der drei verfügbaren Werte, um anzugeben, dass die Entität erfolgreich ist, keine Kenntnis von einer CER hat oder (deterministisch) Erfolg oder Fehler melden kann.

Eine CER garantiert, dass der Codebereich auch dann ohne Unterbrechung ausgeführt wird, wenn eine asynchrone Ausnahme wie eine abgebrochene Threadausnahme außerhalb des Arbeitsspeichers oder der Stapelüberlauf ausgelöst wird.

Der Cer.None Enumerationswert gibt jedoch an, dass die Methode, der Typ oder die Assembly kein Konzept einer CER hat. CER-Garantien können nicht genutzt werden. Dies impliziert Folgendes:

  • Unter außergewöhnlichen Bedingungen kann die Methode fehlschlagen.

  • Die Methode meldet möglicherweise einen Fehler (nicht deterministisch).

  • Die Methode wird nicht unter Berücksichtigung von CERs geschrieben (was das wahrscheinlichste Szenario ist).

Wenn eine Methode, ein Typ oder eine Assembly nicht explizit als erfolgreich markiert ist, wird sie implizit als Cer.Nonegekennzeichnet.

Gilt für:

Weitere Informationen