Udostępnij za pośrednictwem

SYSLIB0036: Regex.CompileToAssembly jest przestarzałe

  • Artykuł

Metoda Regex.CompileToAssembly jest oznaczona jako przestarzała, począwszy od platformy .NET 7. Użycie tego interfejsu API w kodzie generuje ostrzeżenie SYSLIB0036 w czasie kompilacji.

W programie .NET 5, .NET 6 i wszystkich wersjach platformy .NET Core Regex.CompileToAssembly jest zgłaszany element PlatformNotSupportedException. W programie .NET Framework Regex.CompileToAssembly umożliwia kompilowanie wystąpienia wyrażenia regularnego w zestawie.

Rozwiązanie

Użyj atrybutu GeneratedRegexAttribute , który wywołuje generator źródła wyrażeń regularnych. W czasie kompilacji generator źródła generuje interfejs API specyficzny dla wzorca wyrażenia regularnego i jego opcji.

// This attribute causes the regular expression pattern to be compiled into your assembly,
// which enables it to start up and run more quickly.
[GeneratedRegex("abc|def", RegexOptions.IgnoreCase)]
private static partial Regex MyRegex();

// ...

// Use the regular expression
if (MyRegex().IsMatch(text) { ... }

Pomijanie ostrzeżenia

Jeśli musisz używać przestarzałych interfejsów API, możesz pominąć ostrzeżenie w kodzie lub w pliku projektu.

Aby pominąć tylko jedno naruszenie, dodaj dyrektywy preprocesora do pliku źródłowego, aby wyłączyć, a następnie ponownie włączyć ostrzeżenie.

// Disable the warning.
#pragma warning disable SYSLIB0036

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

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

Aby pominąć wszystkie SYSLIB0036 ostrzeżenia w projekcie, dodaj <NoWarn> właściwość do pliku projektu.

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

Aby uzyskać więcej informacji, zobacz Pomijanie ostrzeżeń.