SignerInfo.CheckSignature 方法

定義

命名空間:

System.Security.Cryptography.Pkcs

組件:

System.Security.Cryptography.Pkcs.dll

組件:

System.Security.dll

驗證 (Verify) 訊息的數位簽章。

多載

CheckSignature(Boolean)	CheckSignature(Boolean) 方法會驗證 (Verify) 訊息的數位簽章，也可以選擇性地驗證 (Validate) 憑證。
CheckSignature(X509Certificate2Collection, Boolean)	CheckSignature(X509Certificate2Collection, Boolean) 方法使用指定的憑證集合來驗證 (Verify) 訊息的數位簽章，也可以選擇性地驗證 (Validate) 憑證。

CheckSignature(Boolean)

CheckSignature(Boolean) 方法會驗證 (Verify) 訊息的數位簽章，也可以選擇性地驗證 (Validate) 憑證。

public:
 void CheckSignature(bool verifySignatureOnly);

public void CheckSignature (bool verifySignatureOnly);

member this.CheckSignature : bool -> unit

Public Sub CheckSignature (verifySignatureOnly As Boolean)

參數

verifySignatureOnly

Boolean

bool 值，指定是否僅驗證 (Verify) 數位簽章。 如果 verifySignatureOnly 為 true，只驗證 (Verify) 簽章。 如果 verifySignatureOnly 為 false，則驗證 (Verify) 數位簽章、驗證 (Validate) 憑證鏈結和驗證 (Validate) 憑證的目的。 如果憑證沒有金鑰使用方式，或金鑰使用方式支援數位簽章或不可否認性 (Nonrepudiation)，憑證的目的可視為有效。

例外狀況

ArgumentNullException

Null 參考已傳遞至不接受它做為有效引數的方法。

CryptographicException

密碼編譯作業無法完成。

InvalidOperationException

物件目前狀態的方法呼叫無效。

備註

如果數位簽章的驗證失敗或不符合任何驗證需求，這個方法會擲回例外狀況。

如果需要更複雜的驗證，呼叫端可以指定只驗證簽章，然後使用 X509Chain 物件來執行自訂驗證。

CheckSignature(X509Certificate2Collection, Boolean)

CheckSignature(X509Certificate2Collection, Boolean) 方法使用指定的憑證集合來驗證 (Verify) 訊息的數位簽章，也可以選擇性地驗證 (Validate) 憑證。

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 物件，可用來驗證 (Validate) 鏈結。 如果沒有使用其他憑證來驗證 (Validate) 鏈結，請不要使用 CheckSignature(Boolean) 改為使用 CheckSignature(X509Certificate2Collection, Boolean)。

verifySignatureOnly

Boolean

bool 值，指定是否僅驗證 (Verify) 數位簽章。 如果 verifySignatureOnly 為 true，只驗證 (Verify) 簽章。 如果 verifySignatureOnly 為 false，則驗證 (Verify) 數位簽章、驗證 (Validate) 憑證鏈結和驗證 (Validate) 憑證的目的。 如果憑證沒有金鑰使用方式，或金鑰使用方式支援數位簽章或不可否認性 (Nonrepudiation)，憑證的目的可視為有效。

例外狀況

ArgumentNullException

Null 參考已傳遞至不接受它做為有效引數的方法。

CryptographicException

密碼編譯作業無法完成。

InvalidOperationException

物件目前狀態的方法呼叫無效。

備註

如果數位簽章的驗證失敗或不符合任何驗證需求，這個方法會擲回例外狀況。

如果需要更複雜的驗證，呼叫端可以指定只驗證簽章，然後使用 X509Chain 物件來執行自訂驗證。