SYSLIB0011: Serializace BinaryFormatter je zastaralá

Z důvodu zranitelností zabezpečení v BinaryFormatter byla následující rozhraní API v .NET 5 označena jako zastaralá. Použití v kódu generuje upozornění nebo chybu SYSLIB0011 v době kompilace.

• System.Exception.SerializeObjectState
• BinaryFormatter.Serialize
• BinaryFormatter.Deserialize
• Formatter.Serialize(Stream, Object)
• Formatter.Deserialize(Stream)
• IFormatter.Serialize(Stream, Object)
• IFormatter.Deserialize(Stream)

Počínaje rozhraním .NET 8, BinaryFormatter.Serialize a BinaryFormatter.Deserialize vyvolají NotSupportedException při běhu u většiny typů projektů. Kromě toho PreserializedResourceWriter.AddBinaryFormattedResource(String, Byte[], String) je zastaralé jako upozornění a následující rozhraní API jsou zastaralá jako chyba:

• System.Runtime.Serialization.Formatter
• System.Runtime.Serialization.IFormatter
• System.Runtime.Serialization.Formatters.Binary.BinaryFormatter

Alternativní řešení

Pokud používáte BinaryFormatter, měli byste z ní migrovat kvůli chybám zabezpečení a spolehlivosti. Další informace naleznete v tématu Rizika deserializace při použití BinaryFormatter a souvisejících typů a preferovaných alternativ.

Potlačte upozornění

Pokud musíte použít zastaralá rozhraní API, můžete potlačit upozornění nebo chybu v kódu nebo v souboru projektu.

Chcete-li potlačit pouze jedno porušení, přidejte do zdrojového souboru direktivy preprocesoru, které chcete zakázat a znovu povolit upozornění.

// Disable the warning.
#pragma warning disable SYSLIB0011

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

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

Pokud chcete potlačit všechna SYSLIB0011 upozornění v projektu, přidejte <NoWarn> do souboru projektu vlastnost.

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

Další informace naleznete v tématu Potlačení upozornění.

Viz také

• Řešení chyb zastarání a zakázání BinaryFormatter
• Metody serializace BinaryFormatter jsou zastaralé a zakázané v aplikacích ASP.NET (.NET 5)
• API BinaryFormatter pro serializaci vytvářejí chyby kompilátoru (.NET 7)
• BinaryFormatter zakázaná ve většině typů projektů (.NET 8)