SignedCms.CheckSignature 方法

定义

命名空间:

System.Security.Cryptography.Pkcs

程序集:

System.Security.Cryptography.Pkcs.dll

包:

System.Security.Cryptography.Pkcs v9.0.0-preview.4.24266.19

验证签名 CMS/PKCS #7 消息上的数字签名。

重载

CheckSignature(Boolean)	CheckSignature(Boolean) 方法验证签名 CMS/PKCS #7 消息上的数字签名，并验证签名者的证书（可选）。
CheckSignature(X509Certificate2Collection, Boolean)	CheckSignature(X509Certificate2Collection, Boolean) 方法通过使用指定的证书集合对签名 CMS/PKCS #7 消息的数字签名进行验证，并对签名者的证书进行验证（可选）。

CheckSignature(Boolean)

Source:

SignedCms.cs

CheckSignature(Boolean) 方法验证签名 CMS/PKCS #7 消息上的数字签名，并验证签名者的证书（可选）。

public:
 void CheckSignature(bool verifySignatureOnly);

public void CheckSignature (bool verifySignatureOnly);

member this.CheckSignature : bool -> unit

Public Sub CheckSignature (verifySignatureOnly As Boolean)

参数

verifySignatureOnly

Boolean

一个 Boolean 值，指定是否只验证数字签名而不验证签名者的证书。

如果 verifySignatureOnly 为 true，则仅验证数字签名。 如果该值为 false，则验证数字签名、签名者的证书和证书的用途。 如果证书没有密钥用法或如果密钥用法支持数字签名或认可，则认为该证书的用途有效。

例外

ArgumentNullException

向不接受空引用作为有效参数的方法传递了一个空引用。

CryptographicException

未能完成加密操作。

InvalidOperationException

一个方法调用对于对象的当前状态无效。

示例

以下示例演示在验证邮件签名SignedCms所需的步骤之间放置 CheckSignature(Boolean) 。 在此示例中，消息内容未分离。 消息内容包含在消息中 SignedCms 。

// Create a new, nondetached SignedCms message.
SignedCms signedCms = new SignedCms();

// encodedMessage is the encoded message received from
// the sender.
signedCms.Decode(encodedMessage);

// Verify the signature without validating the
// certificate.
signedCms.CheckSignature(true);

' Create a new, nondetached SignedCms message.
Dim signedCms As New SignedCms()

' encodedMessage is the encoded message received from 
' the sender.
signedCms.Decode(encodedMessage)

' Verify the signature without validating the 
' certificate.
signedCms.CheckSignature(True)

以下示例演示在验证邮件签名SignedCms所需的步骤之间放置 CheckSignature(Boolean) 。 在此示例中，消息内容是分离的，因此消息内容必须独立于消息进行 SignedCms 验证。

// Create a ContentInfo object from the inner content obtained
// independently from encodedMessage.
ContentInfo contentInfo = new ContentInfo(innerContent);

// Create a new, detached SignedCms message.
SignedCms signedCms = new SignedCms(contentInfo, true);

// encodedMessage is the encoded message received from
// the sender.
signedCms.Decode(encodedMessage);

// Verify the signature without validating the
// certificate.
signedCms.CheckSignature(true);

' Create a ContentInfo object from the inner content obtained 
' independently from encodedMessage.
Dim contentInfo As New ContentInfo(innerContent)

' Create a new, detached SignedCms message.
Dim signedCms As New SignedCms(contentInfo, True)

' encodedMessage is the encoded message received from 
' the sender.
signedCms.Decode(encodedMessage)

' Verify the signature without validating the 
' certificate.
signedCms.CheckSignature(True)

注解

此方法验证 CMS/PKCS #7 消息上的所有签名，包括反签名。 如果消息中包含有符号属性，则还会验证这些属性。 如果选择选项来验证证书，则会验证证书链的整个包含部分。

如果数字签名的验证失败或不符合任何验证要求，则此方法将引发异常。

CheckSignature(X509Certificate2Collection, Boolean)

Source:

SignedCms.cs

CheckSignature(X509Certificate2Collection, Boolean) 方法通过使用指定的证书集合对签名 CMS/PKCS #7 消息的数字签名进行验证，并对签名者的证书进行验证（可选）。

public:
 void CheckSignature(System::Security::Cryptography::X509Certificates::X509Certificate2Collection ^ extraStore, bool verifySignatureOnly);

public void CheckSignature (System.Security.Cryptography.X509Certificates.X509Certificate2Collection extraStore, bool verifySignatureOnly);

member this.CheckSignature : System.Security.Cryptography.X509Certificates.X509Certificate2Collection * bool -> unit

Public Sub CheckSignature (extraStore As X509Certificate2Collection, verifySignatureOnly As Boolean)

参数

extraStore

X509Certificate2Collection

可用于验证证书链的 X509Certificate2Collection 对象。 如果没有其他证书要用于验证证书链，则应使用 CheckSignature(Boolean) 而不是 CheckSignature(X509Certificate2Collection, Boolean)。

verifySignatureOnly

Boolean

一个 Boolean 值，指定是否只验证数字签名而不验证签名者的证书。

如果 verifySignatureOnly 为 true，则仅验证数字签名。 如果该值为 false，则验证数字签名、签名者的证书和证书的用途。 如果证书没有密钥用法或如果密钥用法支持数字签名或认可，则认为该证书的用途有效。

例外

ArgumentNullException

向不接受空引用作为有效参数的方法传递了一个空引用。

CryptographicException

未能完成加密操作。

InvalidOperationException

一个方法调用对于对象的当前状态无效。

注解

此方法验证 CMS/PKCS #7 消息上的所有签名，包括反签名。 如果消息中包含有符号属性，则还会验证这些属性。 如果选择选项来验证证书，则会验证证书链的整个包含部分。

如果数字签名的验证失败或不符合任何验证要求，则此方法将引发异常。