SYSLIB0004: Das Feature „Eingeschränkte Ausführungsregion“ (Constrained Execution Region, CER) wird nicht unterstützt.

  • Artikel

Das Feature Eingeschränkte Ausführungsregion (Constrained Execution Region, CER) wird nur in .NET Framework unterstützt. Daher sind verschiedene CER-bezogene APIs ab .NET 5 als veraltet markiert. Die Verwendung dieser APIs ruft zur Kompilierzeit die Warnung SYSLIB0004 hervor.

Die folgenden CER-bezogenen APIs sind veraltet:

Die folgenden CER-bezogenen APIs sind jedoch nicht veraltet:

Problemumgehung

  • Wenn Sie ein CER-Attribut auf eine Methode angewendet haben, entfernen Sie das Attribut. Diese Attribute haben keine Auswirkung auf .NET 5 und höher.

    // REMOVE the attribute below.
[ReliabilityContract(Consistency.WillNotCorruptState, Cer.Success)]
public void DoSomething()
{
}

// REMOVE the attribute below.
[PrePrepareMethod]
public void DoSomething()
{
}

  • Wenn Sie RuntimeHelpers.ProbeForSufficientStack oder RuntimeHelpers.PrepareContractedDelegate aufrufen, entfernen Sie den Aufruf. Diese Aufrufe haben keine Auswirkung auf .NET 5 und höher.

    public void DoSomething()
{
    // REMOVE the call below.
    RuntimeHelpers.ProbeForSufficientStack();

    // (Remainder of your method logic here.)
}

  • Wenn Sie RuntimeHelpers.PrepareConstrainedRegions aufrufen, entfernen Sie den Aufruf. Dieser Aufruf hat keine Auswirkung auf .NET 5 und höher.

    public void DoSomething_Old()
{
    // REMOVE the call below.
    RuntimeHelpers.PrepareConstrainedRegions();
    try
    {
        // try code
    }
    finally
    {
        // cleanup code
    }
}

public void DoSomething_Corrected()
{
    // There is no call to PrepareConstrainedRegions. It's a normal try / finally block.

    try
    {
        // try code
    }
    finally
    {
        // cleanup code
    }
}

  • Wenn Sie RuntimeHelpers.ExecuteCodeWithGuaranteedCleanup aufrufen, ersetzen Sie den Aufruf durch einen Standardblock try/catch/finally.

    // The sample below produces warning SYSLIB0004.
public void DoSomething_Old()
{
    RuntimeHelpers.ExecuteCodeWithGuaranteedCleanup(MyTryCode, MyCleanupCode, null);
}
public void MyTryCode(object state) { /* try code */ }
public void MyCleanupCode(object state, bool exceptionThrown) { /* cleanup code */ }

// The corrected sample below does not produce warning SYSLIB0004.
public void DoSomething_Corrected()
{
    try
    {
        // try code
    }
    catch (Exception ex)
    {
        // exception handling code
    }
    finally
    {
        // cleanup code
    }
}

Unterdrücken einer Warnung

Wenn Sie die veralteten APIs verwenden müssen, können Sie die Warnung im Code oder in Ihrer Projektdatei unterdrücken.

Um nur einen einzelnen Verstoß zu unterdrücken, fügen Sie der Quelldatei Präprozessoranweisungen hinzu, um die Warnung zu deaktivieren und dann wieder zu aktivieren.

// Disable the warning.
#pragma warning disable SYSLIB0004

// Code that uses obsolete API.
// ...

// Re-enable the warning.
#pragma warning restore SYSLIB0004

Um alle SYSLIB0004-Warnungen in Ihrem Projekt zu unterdrücken, fügen Sie ihrer Projektdatei eine <NoWarn>-Eigenschaft hinzu.

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
   ...
   <NoWarn>$(NoWarn);SYSLIB0004</NoWarn>
  </PropertyGroup>
</Project>

Weitere Informationen finden Sie unter Unterdrücken von Warnungen.

Siehe auch