Pkcs12KeyBag(ReadOnlyMemory<Byte>, Boolean) 建構函式

定義

命名空間:

System.Security.Cryptography.Pkcs

組件:

System.Security.Cryptography.Pkcs.dll

套件:

System.Security.Cryptography.Pkcs v9.0.0-preview.5.24306.7

來源:

Pkcs12KeyBag.cs

從現有的編碼 PKCS#8 PrivateKeyInfo 值，初始化 Pkcs12KeyBag 的新執行個體。

public Pkcs12KeyBag (ReadOnlyMemory<byte> pkcs8PrivateKey, bool skipCopy = false);

new System.Security.Cryptography.Pkcs.Pkcs12KeyBag : ReadOnlyMemory<byte> * bool -> System.Security.Cryptography.Pkcs.Pkcs12KeyBag

Public Sub New (pkcs8PrivateKey As ReadOnlyMemory(Of Byte), Optional skipCopy As Boolean = false)

參數

pkcs8PrivateKey

ReadOnlyMemory<Byte>

BER 編碼的 PKCS#8 PrivateKeyInfo 值。

skipCopy

Boolean

true 表示儲存 pkcs8PrivateKey 而不建立防禦性複本，否則為 false。 預設為 false。

例外狀況

CryptographicException

pkcs8privateKey 參數不代表單一 ASN.1 BER 編碼值。

備註

這個方法會驗證是否 pkcs8PrivateKey 為單一 BER 編碼的值，但不會驗證此值是否為適當的 PKCS#8 PrivateKeyInfo 值。

PKCS#12 標準允許在 KeyBag 中傳輸私鑰，但並非所有 PFX 讀取器都支援將憑證與 KeyBag 中的金鑰配對。 為了獲得最佳支援，ShroudedKeyBag 中的傳輸密鑰 (Pkcs12ShroudedKeyBag) 。

這個方法的預設行為是建立的 pkcs8PrivateKey防禦性複本。 skipCopy當 參數為 true時，會略過此防禦性複本。 如果略過防禦性複本，且傳回值存留期或其方法或屬性所產生的任何對象的內容 pkcs8PrivateKey 有所變更，則這些物件上的方法和屬性可能會產生無效的結果，或因損毀狀態而擲回例外狀況。 因此，建議呼叫端只在可以合理確保數據保持不變時，才使用 true 參數的值 skipCopy 。

另請參閱

• AddKeyUnencrypted(AsymmetricAlgorithm)