AsymmetricAlgorithm.Create Метод

Определение

Пространство имен:

System.Security.Cryptography

Сборка:

System.Security.Cryptography.dll

Создает криптографический объект, используемый для выполнения алгоритма асимметричного шифрования.

Перегрузки

Create()	Устаревшие.. Создает криптографический объект по умолчанию, используемый для выполнения алгоритма асимметричного шифрования.
Create(String)	Устаревшие.. Создает экземпляр заданной реализации алгоритма асимметричного шифрования.

Create()

Исходный код:

AsymmetricAlgorithm.cs

Внимание!

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}")>]
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 isinstalled 
    // 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" />

public:
    static CustomCrypto^ Create() 
    {
        return Create("CustomCrypto");
    }

// 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

Внимание!

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.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);

[<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

Public Shared Function Create (algName As String) As AsymmetricAlgorithm

Параметры

algName

String

Реализация асимметричного алгоритма, которую требуется использовать. В следующей таблице представлены допустимые значения параметра algName и алгоритмы, с которыми они сопоставляются.

Значение параметра	Инструменты
System.Security.Cryptography.AsymmetricAlgorithm	AsymmetricAlgorithm
RSA	RSA
System.Security.Cryptography.RSA	RSA
DSA	DSA
System.Security.Cryptography.DSA	DSA
ECDsa	ECDsa
ECDsaCng	ECDsaCng
System.Security.Cryptography.ECDsaCng	ECDsaCng
ECDH	ECDiffieHellman
ECDiffieHellman	ECDiffieHellman
ECDiffieHellmanCng	ECDiffieHellmanCng
System.Security.Cryptography.ECDiffieHellmanCng	ECDiffieHellmanCng

Возвращаемое значение

AsymmetricAlgorithm

Новый экземпляр заданной реализации алгоритма асимметричного шифрования.

Атрибуты

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" />

public:
    static CustomCrypto^ Create(String^ algorithmName) 
    {
        return (CustomCrypto^) 
            CryptoConfig::CreateFromName(algorithmName);
    }

// 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

См. также раздел

• службы шифрования