SYSLIB0026: X509Certificate と X509Certificate2 は変更できない

  • [アーティクル]

.NET 6 以降、次の変更可能な X509 証明書 API は古い形式としてマークされています。 コードでこれらの API を使用すると、コンパイル時に警告 SYSLIB0026 が生成されます。

回避策

入力として証明書を受け取るコンストラクターのオーバーロードを使用して、X509Certificate と X509Certificate2 の新しいインスタンスを作成します。 次に例を示します。

// Change this:
cert.Import("/path/to/certificate.crt");

// To this:
cert.Dispose();
cert = new X509Certificate2("/path/to/certificate.crt");

警告を抑制する

古い API を使う必要がある場合は、コードまたはプロジェクト ファイルで警告を抑制することができます。

単一の違反だけを抑制するには、ソース ファイルにプリプロセッサ ディレクティブを追加して警告を無効にしてから、再度有効にします。

// Disable the warning.
#pragma warning disable SYSLIB0026

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

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

プロジェクトですべての SYSLIB0026 警告を抑制するには、プロジェクト ファイルに <NoWarn> プロパティを追加します。

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

詳細については、「警告を表示しない」を参照してください。