AsymmetricAlgorithm.Create 方法

定義

命名空間:: System.Security.Cryptography

組件:: netstandard.dll, System.Security.Cryptography.dll

組件:: netstandard.dll, System.Security.Cryptography.Primitives.dll

組件:: System.Security.Cryptography.Primitives.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

建立一個用於執行非對稱演算法的密碼物件。

多載

名稱	Description
Create()	已淘汰. 已淘汰. 建立一個預設密碼物件，用於執行非對稱演算法。
Create(String)	已淘汰. 建立指定非對稱演算法實作的實例。

Create()

來源:: AsymmetricAlgorithm.cs

來源:: AsymmetricAlgorithm.cs

來源:: AsymmetricAlgorithm.cs

來源:: AsymmetricAlgorithm.cs

來源:: AsymmetricAlgorithm.cs

警告

The default implementation of this cryptography algorithm is not supported.

警告

The default implementation of this cryptography algorithm is not supported

建立一個預設密碼物件，用於執行非對稱演算法。

public:
 static System::Security::Cryptography::AsymmetricAlgorithm ^ Create();

[System.Obsolete("The default implementation of this cryptography algorithm is not supported.", DiagnosticId="SYSLIB0007", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Security.Cryptography.AsymmetricAlgorithm Create();

[System.Obsolete("The default implementation of this cryptography algorithm is not supported", DiagnosticId="SYSLIB0007", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Security.Cryptography.AsymmetricAlgorithm Create();

public static System.Security.Cryptography.AsymmetricAlgorithm Create();

[<System.Obsolete("The default implementation of this cryptography algorithm is not supported.", DiagnosticId="SYSLIB0007", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member Create : unit -> System.Security.Cryptography.AsymmetricAlgorithm

[<System.Obsolete("The default implementation of this cryptography algorithm is not supported", DiagnosticId="SYSLIB0007", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member Create : unit -> System.Security.Cryptography.AsymmetricAlgorithm

static member Create : unit -> System.Security.Cryptography.AsymmetricAlgorithm

Public Shared Function Create () As AsymmetricAlgorithm

傳回

AsymmetricAlgorithm

一個新的 RSACryptoServiceProvider 實例，除非預設設定被修改了 <cryptoClass> 元素。

屬性: ObsoleteAttribute

例外狀況

PlatformNotSupportedException

.NET Core 2.0 - 3.1 及 .NET 5 及以後版本：適用於所有版本。

備註

此方法在 .NET 5 及更新版本中已過時。

範例

以下程式碼範例示範如何在擴展類別中實作此 Create 方法。此程式碼範例是本類別更大範例 AsymmetricAlgorithm 的一部分。

// The create function attempts to create a CustomCrypto object using
// the assembly name. This functionality requires modification of the
// machine.config file. Add the following section to the configuration
// element and modify the values of the cryptoClass to reflect what is
// installed in your machines GAC.
//        <cryptoClass CustomCrypto="Contoso.CustomCrypto, 
//          CustomCrypto, 
//          Culture=neutral, 
//          PublicKeyToken=fdb9f9c4851028bf, 
//          Version=1.0.1448.27640" />
//      <nameEntry name="Contoso.CustomCrypto" class="CustomCrypto" />
//      <nameEntry name="CustomCrypto" class="CustomCrypto" />
new static public CustomCrypto Create() 
{
    return Create("CustomCrypto");
}

' The create function attempts to create a vbCustomCrypto object using
' the assembly name. This functionality requires modification of the
' machine.config file. Add the following section to the configuration
' element and modify the values of the cryptoClass to reflect what is
' installed in your machines GAC.
'          <cryptoClass vbCustomCrypto="Contoso.vbCustomCrypto, 
'            vbCustomCrypto, 
'            Culture=neutral, 
'            PublicKeyToken=fdb9f9c4851028bf, 
'            Version=1.0.1448.27640" />
'        <nameEntry name="Contoso.vbCustomCrypto" 
'                   class="vbCustomCrypto" />
'        <nameEntry name="vbCustomCrypto" class="vbCustomCrypto" />
Public Shadows Function Create() As vbCustomCrypto
    Return Create("vbCustomCrypto")
End Function

另請參閱

密碼編譯服務

適用於

Create(String)

來源:: AsymmetricAlgorithm.cs

來源:: AsymmetricAlgorithm.cs

來源:: AsymmetricAlgorithm.cs

來源:: AsymmetricAlgorithm.cs

來源:: AsymmetricAlgorithm.cs

警告

Cryptographic factory methods accepting an algorithm name are obsolete. Use the parameterless Create factory method on the algorithm type instead.

建立指定非對稱演算法實作的實例。

public:
 static System::Security::Cryptography::AsymmetricAlgorithm ^ Create(System::String ^ algName);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The default algorithm implementations might be removed, use strong type references like 'RSA.Create()' instead.")]
[System.Obsolete("Cryptographic factory methods accepting an algorithm name are obsolete. Use the parameterless Create factory method on the algorithm type instead.", DiagnosticId="SYSLIB0045", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Security.Cryptography.AsymmetricAlgorithm? Create(string algName);

public static System.Security.Cryptography.AsymmetricAlgorithm? Create(string algName);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The default algorithm implementations might be removed, use strong type references like 'RSA.Create()' instead.")]
public static System.Security.Cryptography.AsymmetricAlgorithm? Create(string algName);

public static System.Security.Cryptography.AsymmetricAlgorithm Create(string algName);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The default algorithm implementations might be removed, use strong type references like 'RSA.Create()' instead.")>]
[<System.Obsolete("Cryptographic factory methods accepting an algorithm name are obsolete. Use the parameterless Create factory method on the algorithm type instead.", DiagnosticId="SYSLIB0045", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member Create : string -> System.Security.Cryptography.AsymmetricAlgorithm

static member Create : string -> System.Security.Cryptography.AsymmetricAlgorithm

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The default algorithm implementations might be removed, use strong type references like 'RSA.Create()' instead.")>]
static member Create : string -> System.Security.Cryptography.AsymmetricAlgorithm

Public Shared Function Create (algName As String) As AsymmetricAlgorithm

參數

algName: String

非對稱演算法實作。下表顯示參數 algName 的有效值及其映射演算法。

參數值	工具
系統.安全.密碼學.非對稱演算法	AsymmetricAlgorithm
RSA	RSA
System.Security.Cryptography.RSA	RSA
DSA	DSA
系統安全。密碼學.DSA	DSA
ECDsa	ECDsa
ECDsaCng	ECDsaCng
系統.安全.密碼學.ECDsaCng	ECDsaCng
ECDH	ECDiffieHellman
ECDiffieHellman	ECDiffieHellman
ECDiffieHellmanCng	ECDiffieHellmanCng
系統.安全.密碼學.ECDiffieHellmanCng	ECDiffieHellmanCng

傳回

AsymmetricAlgorithm

指定非對稱演算法實作的新實例。

屬性: RequiresUnreferencedCodeAttribute ObsoleteAttribute

範例

以下程式碼範例示範如何在擴展類別中實作此 Create 方法。此程式碼範例是本類別更大範例 AsymmetricAlgorithm 的一部分。

// The create function attempts to create a CustomCrypto object using
// the assembly name. This functionality requires modification of the
// machine.config file. Add the following section to the configuration
// element and modify the values of the cryptoClass to reflect what is
// installed in your machines GAC.
//       <cryptoClass CustomCrypto="Contoso.CustomCrypto, 
//         CustomCrypto, 
//         Culture=neutral, 
//         PublicKeyToken=fdb9f9c4851028bf, 
//         Version=1.0.1448.27640" />
//     <nameEntry name="Contoso.CustomCrypto" class="CustomCrypto" />
//     <nameEntry name="CustomCrypto" class="CustomCrypto" />
new static public CustomCrypto Create(String algorithmName) 
{
    return (CustomCrypto) CryptoConfig.CreateFromName(algorithmName);
}

' The create function attempts to create a vbCustomCrypto object using
' the assembly name. This functionality requires modification of the
' machine.config file. Add the following section to the configuration
' element and modify the values of the cryptoClass to reflect what is
' installed in your machines GAC.
'          <cryptoClass vbCustomCrypto="Contoso.vbCustomCrypto, 
'            vbCustomCrypto, 
'            Culture=neutral, 
'            PublicKeyToken=fdb9f9c4851028bf, 
'            Version=1.0.1448.27640" />
'        <nameEntry name="Contoso.vbCustomCrypto" 
'                   class="vbCustomCrypto" />
'        <nameEntry name="vbCustomCrypto" class="vbCustomCrypto" />
Public Shadows Function Create( _
    ByVal algorithmName As String) As vbCustomCrypto

    Return CType( _
        CryptoConfig.CreateFromName(algorithmName), _
        vbCustomCrypto)

End Function

另請參閱

密碼編譯服務

適用於

意見反應

此頁面對您有幫助嗎？