X509Certificate.GetCertHash Method
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Returns the hash value for an X509Certificate object.
| GetCertHash() |
Returns the hash value for the X.509v3 certificate as an array of bytes. |
| GetCertHash(HashAlgorithmName) |
Returns the hash value for the X.509v3 certificate that is computed by using the specified cryptographic hash algorithm. |
- Source:
- X509Certificate.cs
- Source:
- X509Certificate.cs
- Source:
- X509Certificate.cs
Returns the hash value for the X.509v3 certificate as an array of bytes.
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()Returns
The hash value for the X.509 certificate.
Examples
The following example uses the GetCertHash method to fill an array of bytes with the hash value for an X.509 certificate.
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
Applies to
.NET 9 and other versions
| Product | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.3, 1.4, 1.6, 2.0, 2.1 |
- Source:
- X509Certificate.cs
- Source:
- X509Certificate.cs
- Source:
- X509Certificate.cs
Returns the hash value for the X.509v3 certificate that is computed by using the specified cryptographic hash algorithm.
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()Parameters
- hashAlgorithm
- HashAlgorithmName
The name of the cryptographic hash algorithm to use.
Returns
A byte array that contains the hash value for the X.509 certificate.
Exceptions
hashAlgorithm.Name is null or an empty string.
hashAlgorithm is not a known hash algorithm.
See also
Applies to
.NET 9 and other versions
| Product | Versions |
|---|---|
| .NET | Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 4.8, 4.8.1 |
| .NET Standard | 2.1 |
.NET feedback
.NET is an open source project. Select a link to provide feedback: