Pkcs12KeyBag(ReadOnlyMemory<Byte>, Boolean) Konstruktor

Definicja

Przestrzeń nazw:

System.Security.Cryptography.Pkcs

Zestaw:

System.Security.Cryptography.Pkcs.dll

Pakiet:

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

Źródło:

Pkcs12KeyBag.cs

Inicjuje nowe wystąpienie Pkcs12KeyBag klasy z istniejącej zakodowanej wartości PKCS#8 PrivateKeyInfo.

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)

Parametry

pkcs8PrivateKey

ReadOnlyMemory<Byte>

Wartość PKCS#8 PrivateKeyInfo zakodowana w formacie BER.

skipCopy

Boolean

truedo przechowywania pkcs8PrivateKey bez tworzenia kopii defensywnej; w przeciwnym razie . false Wartość domyślna to false.

Wyjątki

CryptographicException

Parametr pkcs8privateKey nie reprezentuje pojedynczej wartości zakodowanej w formacie BER ASN.1.

Uwagi

Ta metoda sprawdza, czy pkcs8PrivateKey jest to pojedyncza wartość zakodowana w formacie BER, ale nie sprawdza, czy wartość jest właściwą wartością PKCS#8 PrivateKeyInfo.

Transport kluczy prywatnych w usłudze KeyBag jest dozwolony przez standard PKCS#12, ale nie wszystkie czytniki PFX obsługują parowanie certyfikatów z kluczami z usługi KeyBag. Aby uzyskać najlepszą obsługę, klucze transportu w ShroudedKeyBag (Pkcs12ShroudedKeyBag).

Domyślnym zachowaniem tej metody jest utworzenie defensywnej kopii elementu pkcs8PrivateKey. skipCopy Gdy parametr ma truewartość , ta kopia defensywna jest pomijana. Jeśli kopia defensywna zostanie pominięta, a zawartość pkcs8PrivateKey zmiany w okresie istnienia zwracanej wartości lub dowolnego obiektu utworzonego przez jego metody lub właściwości, metody i właściwości tych obiektów mogą generować wyniki bzdur lub zgłaszać wyjątki z powodu uszkodzonego stanu. W związku z tym zaleca się używanie true wartości parametru skipCopy tylko wtedy, gdy mogą być uzasadnione, że dane pozostaną nienaruszone.

Zobacz też

• AddKeyUnencrypted(AsymmetricAlgorithm)