SignedCms.ComputeSignature Yöntem

Tanım

Ad Alanı:

System.Security.Cryptography.Pkcs

Bütünleştirilmiş Kod:

System.Security.Cryptography.Pkcs.dll

Bir imza oluşturur ve imzayı CMS/PKCS #7 iletisine ekler.

Aşırı Yüklemeler

Name	Description
ComputeSignature(CmsSigner, Boolean)	Belirtilen imzalayanı kullanarak bir imza oluşturur ve imzayı CMS/PKCS #7 iletisine ekler.
ComputeSignature()	Bir imza oluşturur ve imzayı CMS/PKCS #7 iletisine ekler.
ComputeSignature(CmsSigner)	Belirtilen imzalayanı kullanarak bir imza oluşturur ve imzayı CMS/PKCS #7 iletisine ekler.

ComputeSignature(CmsSigner, Boolean)

Kaynak:

SignedCms.cs

Belirtilen imzalayanı kullanarak bir imza oluşturur ve imzayı CMS/PKCS #7 iletisine ekler.

public:
 void ComputeSignature(System::Security::Cryptography::Pkcs::CmsSigner ^ signer, bool silent);

public void ComputeSignature(System.Security.Cryptography.Pkcs.CmsSigner signer, bool silent);

member this.ComputeSignature : System.Security.Cryptography.Pkcs.CmsSigner * bool -> unit

Public Sub ComputeSignature (signer As CmsSigner, silent As Boolean)

Parametreler

signer

CmsSigner

CmsSigner İmzalayanı temsil eden nesne.

silent

Boolean

Yalnızca .NET Core ve .NET 5+ : true PIN istemleri devre dışı bırakılmış açma anahtarlarını istemek için, destekleniyorsa; aksi takdirde. false .NET Framework'te bu parametre kullanılmaz ve gerekirse her zaman bir PIN istemi gösterilir.

Özel durumlar

ArgumentNullException

signer, null'e eşittir.

CryptographicException

Şifreleme işlemi tamamlanamadı.

InvalidOperationException

Yalnızca .NET Framework: İmzalama sertifikası belirtilmedi.

PlatformNotSupportedException

Yalnızca .NET Core ve .NET 5+ : İmzalama sertifikası belirtilmedi.

Açıklamalar

Yalnızca .NET Core: silent Değer null değilse parametresinin CmsSigner.PrivateKey hiçbir etkisi olmaz. Sağlanan değer, imzanın hesaplanıp hesaplanmayacağının PIN istemi gösterilip gösterilmediğini denetler. Özellik null olduğunda PrivateKey ve silent parametresi olarak ayarlandığında truebile, bazı işletim sistemi ve imzalayıcı seçeneklerinin bileşimleri yine de bir PIN istemine neden olabilir.

.NET Framework'te kullanıcı arabirimini görüntülemek için aşağıdaki izinler gereklidir:

• UIPermissionWindow.SafeTopLevelWindows

.NET Framework'te imza anahtarına erişmek için aşağıdaki izinler gereklidir:

• KeyContainerPermissionFlags.Open
• KeyContainerPermissionFlags.Sign

ComputeSignature()

Kaynak:

SignedCms.cs

Bir imza oluşturur ve imzayı CMS/PKCS #7 iletisine ekler.

public:
 void ComputeSignature();

public void ComputeSignature();

member this.ComputeSignature : unit -> unit

Public Sub ComputeSignature ()

Özel durumlar

InvalidOperationException

Alıcı sertifikası belirtilmedi.

Açıklamalar

Oluşturucu aşırı yüklemelerinden birinin SignedCms bağımsız değişkeni olarak signerIdentifierType sağlandıysa SubjectIdentifierType.NoSignature bu yöntem başarılı olur. Aksi takdirde, bir özel durum oluşturur.

.NET Framework'te imza anahtarına erişmek için aşağıdaki izinler gereklidir:

• KeyContainerPermissionFlags.Open
• KeyContainerPermissionFlags.Sign

ComputeSignature(CmsSigner)

Kaynak:

SignedCms.cs

Belirtilen imzalayanı kullanarak bir imza oluşturur ve imzayı CMS/PKCS #7 iletisine ekler.

public:
 void ComputeSignature(System::Security::Cryptography::Pkcs::CmsSigner ^ signer);

public void ComputeSignature(System.Security.Cryptography.Pkcs.CmsSigner signer);

member this.ComputeSignature : System.Security.Cryptography.Pkcs.CmsSigner -> unit

Public Sub ComputeSignature (signer As CmsSigner)

Parametreler

signer

CmsSigner

CmsSigner İmzalayanı temsil eden nesne.

Özel durumlar

ArgumentNullException

Geçerli bir bağımsız değişken olarak kabul etmeyen bir yönteme null başvuru geçirildi.

CryptographicException

Şifreleme işlemi tamamlanamadı.

Örnekler

Aşağıdaki örnekte, ayrılmamış ileti içeriğine sahip bir SignedCms iletideki imzayı hesaplama adımları gösterilmektedir. Bu durumda, ileti içeriği iletiye SignedCms eklenir.

// The dataToSign byte array holds the data to be signed.
ContentInfo contentInfo = new ContentInfo(dataToSign);

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

// Sign the message.
signedCms.ComputeSignature();

// Encode the message.
byte[] myCmsMessage = signedCms.Encode();

// The signed CMS/PKCS #7 message is ready to send.
// The original content is included in this byte array.

' The dataToSign byte array holds the data to be signed.
Dim contentInfo As New ContentInfo(dataToSign)

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

' Sign the message.
signedCms.ComputeSignature()

' Encode the message.
Dim myCmsMessage As Byte() = signedCms.Encode()

' The signed CMS/PKCS #7 message is ready to send.
' The original content is included in this byte array.

Aşağıdaki örnekte, ayrılmış ileti içeriğine sahip bir SignedCms iletideki imzayı hesaplama adımları gösterilmektedir. Bu durumda, ileti içeriğinin iletiden SignedCms bağımsız olarak doğrulanması gerekir.

// The dataToSign byte array holds the data to be signed.
ContentInfo contentInfo = new ContentInfo(dataToSign);

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

// Sign the message.
signedCms.ComputeSignature();

// Encode the message.
byte[] myCmsMessage = signedCms.Encode();

// The signed CMS/PKCS #7 message is ready to send.
// The original content is not included in this byte array.

' The dataToSign byte array holds the data to be signed.
Dim contentInfo As New ContentInfo(dataToSign)

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

' Sign the message.
signedCms.ComputeSignature()

' Encode the message.
Dim myCmsMessage As Byte() = signedCms.Encode()

' The signed CMS/PKCS #7 message is ready to send.
' The original content is not included in this byte array.

Açıklamalar

.NET Framework'te imza anahtarına erişmek için aşağıdaki izinler gereklidir:

• KeyContainerPermissionFlags.Open
• KeyContainerPermissionFlags.Sign