X509Certificate.GetCertHashString 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 a hexadecimal string that contains the hash value for the X.509v3 certificate.
GetCertHashString() |
Returns the SHA1 hash value for the X.509v3 certificate as a hexadecimal string. |
GetCertHashString(HashAlgorithmName) |
Returns a hexadecimal string containing the hash value for the X.509v3 certificate computed using the specified cryptographic hash algorithm. |
- Source:
- X509Certificate.cs
- Source:
- X509Certificate.cs
- Source:
- X509Certificate.cs
Returns the SHA1 hash value for the X.509v3 certificate as a hexadecimal string.
public:
virtual System::String ^ GetCertHashString();
public virtual string GetCertHashString ();
abstract member GetCertHashString : unit -> string
override this.GetCertHashString : unit -> string
Public Overridable Function GetCertHashString () As String
Returns
The hexadecimal string representation of the X.509 certificate hash value.
Examples
The following example uses the GetCertHashString method to get an X.509 certificate hash value, convert it to a string, and display it to the console.
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.
String^ results = cert->GetCertHashString();
// Display the value to the console.
Console::WriteLine( results );
}
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.
string results = cert.GetCertHashString();
// Display the value to the console.
Console.WriteLine(results);
}
}
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 String = cert.GetCertHashString()
' Display the value to the console.
Console.WriteLine(results)
End Sub
End Class
Applies to
.NET 9 and other versions
Product | Versions |
---|---|
.NET | 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 | 2.0, 2.1 |
- Source:
- X509Certificate.cs
- Source:
- X509Certificate.cs
- Source:
- X509Certificate.cs
Returns a hexadecimal string containing the hash value for the X.509v3 certificate computed using the specified cryptographic hash algorithm.
public:
virtual System::String ^ GetCertHashString(System::Security::Cryptography::HashAlgorithmName hashAlgorithm);
public virtual string GetCertHashString (System.Security.Cryptography.HashAlgorithmName hashAlgorithm);
abstract member GetCertHashString : System.Security.Cryptography.HashAlgorithmName -> string
override this.GetCertHashString : System.Security.Cryptography.HashAlgorithmName -> string
Public Overridable Function GetCertHashString (hashAlgorithm As HashAlgorithmName) As String
Parameters
- hashAlgorithm
- HashAlgorithmName
The name of the cryptographic hash algorithm to use.
Returns
The hexadecimal string representation of the X.509 certificate hash value.
Exceptions
hashAlgorithm
.Name is null
or an empty string.
hashAlgorithm
is not a known hash algorithm.
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: