Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

SignedCms.Decode Method

The Decode method decodes an encoded SignedCms message. Upon successful decoding, the decoded information can be retrieved from the properties of the SignedCms object.

Namespace:  System.Security.Cryptography.Pkcs
Assembly:  System.Security (in System.Security.dll)
public void Decode(
	byte[] encodedMessage
)

Parameters

encodedMessage
Type: System.Byte[]

Array of byte values that represents the encoded CMS/PKCS #7 message to be decoded.

ExceptionCondition
ArgumentNullException

A null reference was passed to a method that does not accept it as a valid argument.

CryptographicException

A cryptographic operation could not be completed.

This method resets all member variables of the object by using the information obtained from successful decoding.

The following example shows the placement of the Decode method in the process of verifying the signatures on a SignedCms message. In this example, the message content is not detached, so the message content is included in the SignedCms message.

// 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);

The following example shows the placement of the Decode method in the process of verifying the signatures on a SignedCms message. In this example, the message content is detached, so the message content must be verified independently of the SignedCms message.

// 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);

.NET Framework

Supported in: 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.