SYSLIB0065:AsnEncodedData.RawData 設定式已過時

從 .NET 11 開始,AsnEncodedData.RawData 的 set 存取子已淘汰。 在程式碼中設定此屬性會在編譯時產生警告 SYSLIB0065 。

淘汰的原因

AsnEncodedData 代表一個 ASN.1 編碼的物件。 許多類型都衍生自它,例如 X509BasicConstraintsExtension,並會快取其解碼後的表示形式,以避免在存取屬性時重複解碼 ASN.1。

由於 RawData 不是 virtual,將它設在衍生實例上會導致快取解碼狀態與新的原始資料之間出現差異。 派生型別無法偵測原始資料的變動,因此持續回傳陳舊的解碼值。 例如:

X509BasicConstraintsExtension extension = new(
    certificateAuthority: true,
    hasPathLengthConstraint: true,
    pathLengthConstraint: 3,
    critical: true);

X509BasicConstraintsExtension decoded = new();
decoded.RawData = extension.RawData;
Console.WriteLine(decoded.CertificateAuthority);      // Unexpectedly prints False
Console.WriteLine(decoded.HasPathLengthConstraint);   // Unexpectedly prints False
Console.WriteLine(decoded.PathLengthConstraint);      // Unexpectedly prints 0

Workaround

為了維持解碼狀態與底層資料之間的一致性,請使用適當類型的建構子來解碼資料。 將實例視為唯讀——建構一個新實例,而非重複使用現有實例。

// Instead of setting RawData, use the constructor.
X509BasicConstraintsExtension decoded = new(extension, extension.Critical);

如果你需要可變的行為,可以使用 AsnEncodedData.CopyFrom(AsnEncodedData)。 該 CopyFrom 方法為 virtual,因此當原始資料改變時,導出型別可以使其解碼狀態失效。

隱藏警告

如果你必須使用過時的設定器,可以在程式碼或專案檔案中抑制警告。

若要只隱藏單一違規,請將前置處理器指示詞新增至原始程式碼檔案,以停用並重新啟用警告。

// Disable the warning.
#pragma warning disable SYSLIB0065

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

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

要抑制專案中的所有 SYSLIB0065 警告,請在專案檔案中新增一個 <NoWarn> 屬性。

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

如需詳細資訊,請參閱隱藏警告。