X509AsymmetricSecurityKey.GetAsymmetricAlgorithm(String, Boolean) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得指定的非對稱密碼編譯演算法。
public:
override System::Security::Cryptography::AsymmetricAlgorithm ^ GetAsymmetricAlgorithm(System::String ^ algorithm, bool privateKey);
public override System.Security.Cryptography.AsymmetricAlgorithm GetAsymmetricAlgorithm (string algorithm, bool privateKey);
override this.GetAsymmetricAlgorithm : string * bool -> System.Security.Cryptography.AsymmetricAlgorithm
Public Overrides Function GetAsymmetricAlgorithm (algorithm As String, privateKey As Boolean) As AsymmetricAlgorithm
參數
- algorithm
- String
要建立的非對稱演算法。
- privateKey
- Boolean
如果需要使用私密金鑰來建立演算法,則為 true
,否則為 false
。
傳回
AsymmetricAlgorithm,表示指定的非對稱密碼編譯演算法。
例外狀況
privateKey
是 true
,而且建構函式所指定的 X.509 憑證沒有私密金鑰。
-或-
algorithm
是 XmlDsigDSAUrl,而且建構函式中所指定 X.509 憑證之公開金鑰或私密金鑰的類型不是 DSA。
-或-
algorithm
是 XmlEncRSA15Url、XmlEncRSAOAEPUrl、XmlDsigRSASHA1Url 或 RsaSha256Signature,而且建構函式中所指定 X.509 憑證之公開金鑰或私密金鑰的類型不是 RSA。
-或-
不支援 algorithm
。 支援的演算法為 XmlDsigDSAUrl、XmlEncRSA15Url、XmlEncRSAOAEPUrl、XmlDsigRSASHA1Url 和 RsaSha256Signature。
備註
使用 XmlDsigDSAUrl、XmlEncRSA15Url、XmlEncRSAOAEPUrl、XmlDsigRSASHA1Url 或 RsaSha256Signature 欄位,即可指定 algorithm
參數。
由於 SHA1 的衝突問題,Microsoft 建議您使用以 SHA256 或更好的加密方式為基礎的安全性模型。