DSA.VerifyData Method

Definition

Namespace:: System.Security.Cryptography

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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.

Verifies that a digital signature is valid.

Overloads

Name	Description
VerifyData(Byte[], Byte[], HashAlgorithmName)	Verifies that a digital signature is valid by calculating the hash value of the specified data using the specified hash algorithm and comparing it to the provided signature.
VerifyData(Stream, Byte[], HashAlgorithmName)	Verifies that a digital signature is valid by calculating the hash value of the specified stream using the specified hash algorithm and comparing it to the provided signature.
VerifyData(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, HashAlgorithmName)	Verifies that a digital signature is valid by calculating the hash value of the data in a byte span using the specified hash algorithm and comparing it to the provided signature.
VerifyData(Byte[], Int32, Int32, Byte[], HashAlgorithmName)	Verifies that a digital signature is valid by calculating the hash value of the data in a portion of a byte array using the specified hash algorithm and comparing it to the provided signature.

VerifyData(Byte[], Byte[], HashAlgorithmName)

Verifies that a digital signature is valid by calculating the hash value of the specified data using the specified hash algorithm and comparing it to the provided signature.

public:
 bool VerifyData(cli::array <System::Byte> ^ data, cli::array <System::Byte> ^ signature, System::Security::Cryptography::HashAlgorithmName hashAlgorithm);

public bool VerifyData(byte[] data, byte[] signature, System.Security.Cryptography.HashAlgorithmName hashAlgorithm);

member this.VerifyData : byte[] * byte[] * System.Security.Cryptography.HashAlgorithmName -> bool

Public Function VerifyData (data As Byte(), signature As Byte(), hashAlgorithm As HashAlgorithmName) As Boolean

Parameters

data: Byte[]

The signed data.

signature: Byte[]

The signature data to be verified.

hashAlgorithm: HashAlgorithmName

The hash algorithm used to create the hash value of the data.

Returns

Boolean

true if the digital signature is valid; otherwise, false.

Exceptions

ArgumentNullException

data is null.

-or-

signature is null.

CryptographicException

The implementation type only supports legacy DSA (FIPS 186-2), and the hash algorithm is not SHA-1.

-or-

Verifying the signature otherwise failed.

ArgumentException

hashAlgorithm.Name is null or Empty.

Applies to

VerifyData(Stream, Byte[], HashAlgorithmName)

Verifies that a digital signature is valid by calculating the hash value of the specified stream using the specified hash algorithm and comparing it to the provided signature.

public:
 virtual bool VerifyData(System::IO::Stream ^ data, cli::array <System::Byte> ^ signature, System::Security::Cryptography::HashAlgorithmName hashAlgorithm);

public virtual bool VerifyData(System.IO.Stream data, byte[] signature, System.Security.Cryptography.HashAlgorithmName hashAlgorithm);

abstract member VerifyData : System.IO.Stream * byte[] * System.Security.Cryptography.HashAlgorithmName -> bool
override this.VerifyData : System.IO.Stream * byte[] * System.Security.Cryptography.HashAlgorithmName -> bool

Public Overridable Function VerifyData (data As Stream, signature As Byte(), hashAlgorithm As HashAlgorithmName) As Boolean

Parameters

data: Stream

The signed data.

signature: Byte[]

The signature data to be verified.

hashAlgorithm: HashAlgorithmName

The hash algorithm used to create the hash value of the data.

Returns

Boolean

true if the digital signature is valid; otherwise, false.

Exceptions

ArgumentNullException

data is null.

-or-

signature is null.

ArgumentException

hashAlgorithm.Name is null or Empty.

CryptographicException

The implementation type only supports legacy DSA (FIPS 186-2), and the hash algorithm is not SHA-1.

-or-

Verifying the signature otherwise failed.

Applies to

VerifyData(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, HashAlgorithmName)

Verifies that a digital signature is valid by calculating the hash value of the data in a byte span using the specified hash algorithm and comparing it to the provided signature.

public:
 virtual bool VerifyData(ReadOnlySpan<System::Byte> data, ReadOnlySpan<System::Byte> signature, System::Security::Cryptography::HashAlgorithmName hashAlgorithm);

public virtual bool VerifyData(ReadOnlySpan<byte> data, ReadOnlySpan<byte> signature, System.Security.Cryptography.HashAlgorithmName hashAlgorithm);

abstract member VerifyData : ReadOnlySpan<byte> * ReadOnlySpan<byte> * System.Security.Cryptography.HashAlgorithmName -> bool
override this.VerifyData : ReadOnlySpan<byte> * ReadOnlySpan<byte> * System.Security.Cryptography.HashAlgorithmName -> bool

Public Overridable Function VerifyData (data As ReadOnlySpan(Of Byte), signature As ReadOnlySpan(Of Byte), hashAlgorithm As HashAlgorithmName) As Boolean

Parameters

data: ReadOnlySpan<Byte>

The signed data.

signature: ReadOnlySpan<Byte>

The signature to be verified.

hashAlgorithm: HashAlgorithmName

The hash algorithm used to create the hash value of the data.

Returns

Boolean

true if the digital signature is valid; otherwise, false.

Exceptions

ArgumentException

hashAlgorithm.Name is null or Empty.

CryptographicException

The implementation type only supports legacy DSA (FIPS 186-2), and the hash algorithm is not SHA-1.

-or-

Verifying the signature otherwise failed.

Applies to

VerifyData(Byte[], Int32, Int32, Byte[], HashAlgorithmName)

Verifies that a digital signature is valid by calculating the hash value of the data in a portion of a byte array using the specified hash algorithm and comparing it to the provided signature.

public:
 virtual bool VerifyData(cli::array <System::Byte> ^ data, int offset, int count, cli::array <System::Byte> ^ signature, System::Security::Cryptography::HashAlgorithmName hashAlgorithm);

public virtual bool VerifyData(byte[] data, int offset, int count, byte[] signature, System.Security.Cryptography.HashAlgorithmName hashAlgorithm);

abstract member VerifyData : byte[] * int * int * byte[] * System.Security.Cryptography.HashAlgorithmName -> bool
override this.VerifyData : byte[] * int * int * byte[] * System.Security.Cryptography.HashAlgorithmName -> bool

Public Overridable Function VerifyData (data As Byte(), offset As Integer, count As Integer, signature As Byte(), hashAlgorithm As HashAlgorithmName) As Boolean

Parameters

data: Byte[]

The signed data.

offset: Int32

The starting index at which to compute the hash.

count: Int32

The number of bytes to hash.

signature: Byte[]

The signature data to be verified.

hashAlgorithm: HashAlgorithmName

The hash algorithm used to create the hash value of the data.

Returns

Boolean

true if the digital signature is valid; otherwise, false.

Exceptions

ArgumentNullException

data is null.

-or-

signature is null.

ArgumentException

hashAlgorithm.Name is null or Empty.

ArgumentOutOfRangeException

offset is less than zero.

-or-

count is less than zero.

-or-

offset + count - 1 results in an index that is beyond the upper bound of data.

CryptographicException

The implementation type only supports legacy DSA (FIPS 186-2), and the hash algorithm is not SHA-1.

-or-

Verifying the signature otherwise failed.

Applies to

反馈

此页面是否有帮助？