X509Certificate.GetCertHash Метод

Определение

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

System.Security.Cryptography.X509Certificates

Сборка:

System.Security.Cryptography.dll

Возвращает хэш-значение для объекта X509Certificate.

Перегрузки

GetCertHash()	Возвращает хэш-значение для сертификата X.509v3 в виде массива байтов.
GetCertHash(HashAlgorithmName)	Возвращает хэш-значение для сертификата X.509v3, который вычисляется с помощью указанного криптографического хэш-алгоритма.

GetCertHash()

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

X509Certificate.cs

Возвращает хэш-значение для сертификата X.509v3 в виде массива байтов.

public:
 virtual cli::array <System::Byte> ^ GetCertHash();

public virtual byte[] GetCertHash ();

abstract member GetCertHash : unit -> byte[]
override this.GetCertHash : unit -> byte[]

Public Overridable Function GetCertHash () As Byte()

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

Byte[]

Хэш-значение для сертификата X.509.

Примеры

В следующем примере метод используется GetCertHash для заполнения массива байтов хэш-значением для сертификата X.509.

using namespace System;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
   
   // The path to the certificate.
   String^ Certificate = "Certificate.cer";
   
   // Load the certificate into an X509Certificate object.
   X509Certificate^ cert = X509Certificate::CreateFromCertFile( Certificate );
   
   // Get the value.
   array<Byte>^results = cert->GetCertHash();
}

using System;
using System.Security.Cryptography.X509Certificates;

public class X509
{

    public static void Main()
    {

        // The path to the certificate.
        string Certificate =  "Certificate.cer";

        // Load the certificate into an X509Certificate object.
        X509Certificate cert = X509Certificate.CreateFromCertFile(Certificate);

        // Get the value.
        byte[] results = cert.GetCertHash();
    }
}

Imports System.Security.Cryptography.X509Certificates




Public Class X509
   
   
   Public Shared Sub Main()
      
      ' The path to the certificate.
      Dim Certificate As String = "Certificate.cer"
      
      ' Load the certificate into an X509Certificate object.
      Dim cert As X509Certificate = X509Certificate.CreateFromCertFile(Certificate)
      
      ' Get the value.
      Dim results As Byte() = cert.GetCertHash()
   End Sub 
End Class

GetCertHash(HashAlgorithmName)

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

X509Certificate.cs

Возвращает хэш-значение для сертификата X.509v3, который вычисляется с помощью указанного криптографического хэш-алгоритма.

public:
 virtual cli::array <System::Byte> ^ GetCertHash(System::Security::Cryptography::HashAlgorithmName hashAlgorithm);

public virtual byte[] GetCertHash (System.Security.Cryptography.HashAlgorithmName hashAlgorithm);

abstract member GetCertHash : System.Security.Cryptography.HashAlgorithmName -> byte[]
override this.GetCertHash : System.Security.Cryptography.HashAlgorithmName -> byte[]

Public Overridable Function GetCertHash (hashAlgorithm As HashAlgorithmName) As Byte()

Параметры

hashAlgorithm

HashAlgorithmName

Имя используемого криптографического хэш-алгоритма.

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

Byte[]

Массив байтов, содержащий хэш-значение для сертификата X.509.

Исключения

ArgumentException

hashAlgorithm.Параметр Name имеет значение null или является пустой строкой.

CryptographicException

hashAlgorithm — неизвестный алгоритм хэширования.

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

• TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)