ECDsaCng 類別

定義

命名空間:

System.Security.Cryptography

組件:

System.Security.Cryptography.dll

來源:

Cng.NotSupported.cs

提供橢圓曲線數位簽章演算法 (ECDSA) 的新一代密碼編譯 (CNG) 實作。

public ref class ECDsaCng sealed : System::Security::Cryptography::ECDsa

public sealed class ECDsaCng : System.Security.Cryptography.ECDsa

type ECDsaCng = class
    inherit ECDsa

Public NotInheritable Class ECDsaCng
Inherits ECDsa

繼承

Object

AsymmetricAlgorithm

ECAlgorithm

ECDsa

ECDsaCng

範例

下列範例示範如何使用 ECDsaCng 類別簽署訊息，以及如何使用簽章來驗證訊息尚未變更。

using System;
using System.IO;
using System.Security.Cryptography;
using System.Text;

class Alice
{
    public static void Main(string[] args)
    {
        Bob bob = new Bob();
        using (ECDsaCng dsa = new ECDsaCng())
        {
            dsa.HashAlgorithm = CngAlgorithm.Sha256;
             bob.key = dsa.Key.Export(CngKeyBlobFormat.EccPublicBlob);

             byte[] data = new byte[] { 21, 5, 8, 12, 207 };

             byte[] signature = dsa.SignData(data);

             bob.Receive(data, signature);
            }
    }
}
public class Bob
{
    public byte[] key;

    public void Receive(byte[] data, byte[] signature)
    {
        using (ECDsaCng ecsdKey = new ECDsaCng(CngKey.Import(key, CngKeyBlobFormat.EccPublicBlob)))
        {
            if (ecsdKey.VerifyData(data, signature))
                Console.WriteLine("Data is good");
            else
                Console.WriteLine("Data is bad");
        }
    }
}

Imports System.IO
Imports System.Security.Cryptography
Imports System.Text

Class Alice

    Public Shared Sub Main(ByVal args() As String)
        Dim bob As New Bob()
        If (True) Then
            Using dsa As New ECDsaCng()
                    dsa.HashAlgorithm = CngAlgorithm.Sha256
                    bob.key = dsa.Key.Export(CngKeyBlobFormat.EccPublicBlob)
                    Dim data() As Byte = {21, 5, 8, 12, 207}
                    Dim signature As Byte() = dsa.SignData(data)
                    bob.Receive(data, signature)
            End Using
        End If

    End Sub
End Class


Public Class Bob
    Public key() As Byte

    Public Sub Receive(ByVal data() As Byte, ByVal signature() As Byte)
        Using ecsdKey As New ECDsaCng(CngKey.Import(key, CngKeyBlobFormat.EccPublicBlob))
                If ecsdKey.VerifyData(data, signature) Then
                    Console.WriteLine("Data is good")
                Else
                    Console.WriteLine("Data is bad")
                End If
        End Using

    End Sub
End Class

備註

只有在使用 Windows CNG 連結庫執行平臺 Interop 時，才應該直接使用這個類別。 不需要平臺 Interop 時，您應該使用 ECDsa.Create Factory 方法，而不是特定的衍生實作。

建構函式

ECDsaCng()	使用隨機金鑰組，初始化 ECDsaCng 類別的新執行個體。
ECDsaCng(CngKey)	使用指定的 CngKey 物件，初始化 ECDsaCng 類別的新執行個體。
ECDsaCng(ECCurve)	初始化 ECDsaCng 類別的新執行個體，其公開/私密金鑰組是在指定的曲線上所產生。
ECDsaCng(Int32)	使用指定的目標金鑰大小，初始化 ECDsaCng 類別的新執行個體。

欄位

KeySizeValue	表示非對稱演算法使用的金鑰模數大小，以位元為單位。 (繼承來源 AsymmetricAlgorithm)
LegalKeySizesValue	指定非對稱演算法所支援的金鑰大小。 (繼承來源 AsymmetricAlgorithm)

屬性

HashAlgorithm	取得或設定簽署和驗證資料時使用的雜湊演算法。
Key	取得或設定要在簽署和驗證資料時使用的索引鍵。
KeyExchangeAlgorithm	取得金鑰交換演算法的名稱。 (繼承來源 ECDsa)
KeySize	取得或設定非對稱演算法使用的金鑰模數大小，以位元為單位。
LegalKeySizes	取得 KeySize 屬性 setter 支援的金鑰大小 (以位元為單位)。
SignatureAlgorithm	取得簽章演算法的名稱。 (繼承來源 ECDsa)

方法

Clear()	釋放 AsymmetricAlgorithm 類別所使用的所有資源。 (繼承來源 AsymmetricAlgorithm)
Dispose()	釋放 AsymmetricAlgorithm 類別目前的執行個體所使用的全部資源。 (繼承來源 AsymmetricAlgorithm)
Dispose(Boolean)	釋放 AsymmetricAlgorithm 類別所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 AsymmetricAlgorithm)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
ExportECPrivateKey()	以 ECPrivateKey 格式匯出目前的金鑰。 (繼承來源 ECDsa)
ExportECPrivateKeyPem()	以 ECPrivateKey 格式匯出目前的金鑰，並編碼 PEM。 (繼承來源 ECAlgorithm)
ExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, PbeParameters)	使用位元組型密碼以 PKCS#8 EncryptedPrivateKeyInfo 格式匯出目前金鑰。
ExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, PbeParameters)	使用 Char 型密碼以 PKCS#8 EncryptedPrivateKeyInfo 格式匯出目前金鑰。
ExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Byte>, PbeParameters)	使用以位元組為基礎的密碼 PEM 編碼，以 PKCS#8 EncryptedPrivateKeyInfo 格式導出目前的密鑰。 (繼承來源 AsymmetricAlgorithm)
ExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Char>, PbeParameters)	使用以字元為基礎的密碼 PEM 編碼，以 PKCS#8 EncryptedPrivateKeyInfo 格式導出目前的密鑰。 (繼承來源 AsymmetricAlgorithm)
ExportExplicitParameters(Boolean)	將橢圓曲線密碼編譯 (ECC) 物件所使用的金鑰和明確的曲線參數匯出至 ECParameters 物件。
ExportParameters(Boolean)	將橢圓曲線密碼編譯 (ECC) 物件所使用的金鑰匯出至 ECParameters 物件。 如果是以具名曲線形式來建立金鑰，Curve 欄位即會包含具名曲線參數，否則會包含明確的參數。
ExportPkcs8PrivateKey()	以 PKCS#8 PrivateKeyInfo 格式匯出目前金鑰。 (繼承來源 AsymmetricAlgorithm)
ExportPkcs8PrivateKeyPem()	以 PKCS#8 PrivateKeyInfo 格式匯出目前的密鑰，並編碼 PEM。 (繼承來源 AsymmetricAlgorithm)
ExportSubjectPublicKeyInfo()	以 X.509 SubjectPublicKeyInfo 格式匯出目前金鑰的公開金鑰部分。 (繼承來源 AsymmetricAlgorithm)
ExportSubjectPublicKeyInfoPem()	以 X.509 SubjectPublicKeyInfo 格式匯出目前密鑰的公鑰部分，並編碼 PEM。 (繼承來源 AsymmetricAlgorithm)
FromXmlString(String)	這個方法在所有情況下都會擲回。 (繼承來源 ECDsa)
FromXmlString(String, ECKeyXmlFormat)	已淘汰. 使用指定的格式從 XML 字串還原金鑰資訊的序列化。
GenerateKey(ECCurve)	針對使用曲線產生新的暫時性公開/私密金鑰組，並取代目前金鑰。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetMaxSignatureSize(DSASignatureFormat)	取得此索引鍵以指定格式所產生簽章的最大大小 (以位元組為單位)。 (繼承來源 ECDsa)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
HashData(Byte[], Int32, Int32, HashAlgorithmName)	在衍生類別中覆寫時，會使用指定的雜湊演算法，來為位元組陣列中的指定部分計算出雜湊值。 (繼承來源 ECDsa)
HashData(Stream, HashAlgorithmName)	在衍生類別中覆寫時，會使用指定的雜湊演算法，來為指定的二進位資料流計算出雜湊值。 (繼承來源 ECDsa)
ImportECPrivateKey(ReadOnlySpan<Byte>, Int32)	從 ECPrivateKey 結構匯入公開/私密金鑰組，以取代這個物件的金鑰。 (繼承來源 ECDsa)
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)	使用位元組型密碼解密之後，從 PKCS#8 EncryptedPrivateKeyInfo 結構匯入公開/私密金鑰組，以取代這個物件的金鑰。
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32)	使用 Char 型密碼解密之後，從 PKCS#8 EncryptedPrivateKeyInfo 結構匯入公開/私密金鑰組，以取代這個物件的金鑰。
ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	匯入 RFC 7468 PEM 編碼的加密私密金鑰，並取代這個物件的金鑰。 (繼承來源 ECDsa)
ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	匯入 RFC 7468 PEM 編碼的加密私密金鑰，並取代這個物件的金鑰。 (繼承來源 ECDsa)
ImportFromPem(ReadOnlySpan<Char>)	匯入 RFC 7468 PEM 編碼的金鑰，並取代這個物件的金鑰。 (繼承來源 ECDsa)
ImportParameters(ECParameters)	為參數結構建立新的 CngKey，來取代目前執行個體正在使用的現有金鑰。
ImportPkcs8PrivateKey(ReadOnlySpan<Byte>, Int32)	解密後，從 PKCS#8 PrivateKeyInfo 結構匯入公開/私密金鑰組，以取代這個物件的金鑰。
ImportSubjectPublicKeyInfo(ReadOnlySpan<Byte>, Int32)	解密後，從 X.509 SubjectPublicKeyInfo 結構匯入公開金鑰，以取代這個物件的金鑰。 (繼承來源 ECDsa)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
SignData(Byte[])	產生指定資料的簽章。
SignData(Byte[], HashAlgorithmName)	使用指定的雜湊演算法，並簽署產生的雜湊值，來為指定的位元組陣列計算出雜湊值。 (繼承來源 ECDsa)
SignData(Byte[], HashAlgorithmName, DSASignatureFormat)	計算指定數據的哈希值，並使用指定的簽章格式加以簽署。 (繼承來源 ECDsa)
SignData(Byte[], Int32, Int32)	產生所指定資料長度的數位簽章，以指定的位移開頭。
SignData(Byte[], Int32, Int32, HashAlgorithmName)	使用指定的雜湊演算法，並簽署產生的雜湊值，來為指定的部分位元組陣列計算出雜湊值。 (繼承來源 ECDsa)
SignData(Byte[], Int32, Int32, HashAlgorithmName, DSASignatureFormat)	計算指定數據的哈希值，並使用指定的簽章格式加以簽署。 (繼承來源 ECDsa)
SignData(ReadOnlySpan<Byte>, HashAlgorithmName)	計算指定資料的雜湊值並進行簽署。 (繼承來源 ECDsa)
SignData(ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	計算指定數據的哈希值，並使用指定的簽章格式加以簽署。 (繼承來源 ECDsa)
SignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName)	計算指定數據的哈希值，並以指定的格式將它簽署至提供的緩衝區。 (繼承來源 ECDsa)
SignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, DSASignatureFormat)	計算指定數據的哈希值，並以指定的格式將它簽署至提供的緩衝區。 (繼承來源 ECDsa)
SignData(Stream)	為指定的資料流產生簽章，並且讀取至資料流尾端。
SignData(Stream, HashAlgorithmName)	使用指定的雜湊演算法，並簽署產生的雜湊值，來為指定的資料流計算出雜湊值。 (繼承來源 ECDsa)
SignData(Stream, HashAlgorithmName, DSASignatureFormat)	計算指定數據的哈希值，並使用指定的簽章格式加以簽署。 (繼承來源 ECDsa)
SignDataCore(ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	計算指定數據的哈希值，並使用指定的簽章格式加以簽署。 (繼承來源 ECDsa)
SignDataCore(Stream, HashAlgorithmName, DSASignatureFormat)	計算指定數據的哈希值，並使用指定的簽章格式加以簽署。 (繼承來源 ECDsa)
SignHash(Byte[])	產生指定雜湊值的簽章。
SignHash(Byte[], DSASignatureFormat)	以指定的格式計算指定哈希值的 ECDSA 簽章。 (繼承來源 ECDsa)
SignHash(ReadOnlySpan<Byte>)	計算指定哈希值的 ECDSA 簽章。 (繼承來源 ECDsa)
SignHash(ReadOnlySpan<Byte>, DSASignatureFormat)	以指定的格式計算指定哈希值的 ECDSA 簽章。 (繼承來源 ECDsa)
SignHash(ReadOnlySpan<Byte>, Span<Byte>)	將指定哈希值的 ECDSA 簽章計算到提供的緩衝區中。 (繼承來源 ECDsa)
SignHash(ReadOnlySpan<Byte>, Span<Byte>, DSASignatureFormat)	將指定之哈希值的 ECDSA 簽章，以指定的格式計算為提供的緩衝區。 (繼承來源 ECDsa)
SignHashCore(ReadOnlySpan<Byte>, DSASignatureFormat)	以指定的格式計算指定哈希值的 ECDSA 簽章。 (繼承來源 ECDsa)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
ToXmlString(Boolean)	這個方法在所有情況下都會擲回。 (繼承來源 ECDsa)
ToXmlString(ECKeyXmlFormat)	已淘汰. 使用指定的格式將金鑰資訊序列化成 XML 字串。
TryExportECPrivateKey(Span<Byte>, Int32)	嘗試以 ECPrivateKey 格式將目前的金鑰匯出至提供的緩衝區。 (繼承來源 ECDsa)
TryExportECPrivateKeyPem(Span<Char>, Int32)	嘗試將 PEM 編碼 ECPrivateKey 格式的目前密鑰導出至提供的緩衝區。 (繼承來源 ECAlgorithm)
TryExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, PbeParameters, Span<Byte>, Int32)	使用位元組型密碼，嘗試以 PKCS#8 EncryptedPrivateKeyInfo 格式將目前的金鑰匯出至提供的緩衝區。
TryExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, PbeParameters, Span<Byte>, Int32)	使用 Char 型密碼，嘗試以 PKCS#8 EncryptedPrivateKeyInfo 格式將目前的金鑰匯出至提供的緩衝區。
TryExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Byte>, PbeParameters, Span<Char>, Int32)	嘗試使用以位元組為基礎的密碼 PEM 編碼，以 PKCS#8 EncryptedPrivateKeyInfo 格式導出目前的密鑰。 (繼承來源 AsymmetricAlgorithm)
TryExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Char>, PbeParameters, Span<Char>, Int32)	使用以字元為基礎的密碼 PEM 編碼，以 PKCS#8 EncryptedPrivateKeyInfo 格式導出目前的密鑰。 (繼承來源 AsymmetricAlgorithm)
TryExportPkcs8PrivateKey(Span<Byte>, Int32)	嘗試以 PKCS#8 PrivateKeyInfo 格式將目前的金鑰匯出至提供的緩衝區。
TryExportPkcs8PrivateKeyPem(Span<Char>, Int32)	嘗試將 PEM 編碼 PKCS#8 PrivateKeyInfo 格式中的目前密鑰導出為提供的緩衝區。 (繼承來源 AsymmetricAlgorithm)
TryExportSubjectPublicKeyInfo(Span<Byte>, Int32)	嘗試以 X.509 SubjectPublicKeyInfo 格式將目前的金鑰匯出至提供的緩衝區。 (繼承來源 ECDsa)
TryExportSubjectPublicKeyInfoPem(Span<Char>, Int32)	嘗試將 PEM 編碼 X.509 SubjectPublicKeyInfo 格式中的目前密鑰導出為提供的緩衝區。 (繼承來源 AsymmetricAlgorithm)
TryHashData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, Int32)	使用指定的雜湊演算法，嘗試將所指定唯讀位元組範圍的雜湊值計算到提供的目的地。 (繼承來源 ECDsa)
TrySignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, DSASignatureFormat, Int32)	嘗試以指定的格式，建立指定資料的 ECDSA 簽章，放至提供的緩衝區。 (繼承來源 ECDsa)
TrySignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, Int32)	使用指定的雜湊演算法與目前金鑰，嘗試將所指定唯讀位元組範圍的 ECDSA 數位簽章計算到提供的目的地。 (繼承來源 ECDsa)
TrySignDataCore(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, DSASignatureFormat, Int32)	嘗試以指定的格式，建立指定資料的 ECDSA 簽章，放至提供的緩衝區。 (繼承來源 ECDsa)
TrySignHash(ReadOnlySpan<Byte>, Span<Byte>, DSASignatureFormat, Int32)	嘗試以指定的格式，建立指定雜湊值的 ECDSA 簽章，放至提供的緩衝區。 (繼承來源 ECDsa)
TrySignHash(ReadOnlySpan<Byte>, Span<Byte>, Int32)	使用目前金鑰，嘗試將所指定唯讀位元組範圍 (代表資料雜湊) 的 ECDSA 數位簽章計算到提供的目的地。
TrySignHashCore(ReadOnlySpan<Byte>, Span<Byte>, DSASignatureFormat, Int32)	嘗試以指定的格式，建立指定雜湊值的 ECDSA 簽章，放至提供的緩衝區。 (繼承來源 ECDsa)
VerifyData(Byte[], Byte[])	驗證所指定資料的數位簽章。
VerifyData(Byte[], Byte[], HashAlgorithmName)	確認數位簽章適用於目前金鑰和使用所指定雜湊演算法提供的資料。 (繼承來源 ECDsa)
VerifyData(Byte[], Byte[], HashAlgorithmName, DSASignatureFormat)	驗證數位簽章對提供的資料是否有效。 (繼承來源 ECDsa)
VerifyData(Byte[], Int32, Int32, Byte[])	驗證所指定資料長度的簽章，以指定的位移開頭。
VerifyData(Byte[], Int32, Int32, Byte[], HashAlgorithmName)	確認數位簽章適用於目前金鑰和使用所指定雜湊演算法提供的資料部分。 (繼承來源 ECDsa)
VerifyData(Byte[], Int32, Int32, Byte[], HashAlgorithmName, DSASignatureFormat)	驗證數位簽章對提供的資料是否有效。 (繼承來源 ECDsa)
VerifyData(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, HashAlgorithmName)	確認數位簽章適用於目前金鑰和使用所指定雜湊演算法提供的資料。 (繼承來源 ECDsa)
VerifyData(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	驗證數位簽章對提供的資料是否有效。 (繼承來源 ECDsa)
VerifyData(Stream, Byte[])	驗證所指定資料流的數位簽章，並且讀取至資料流尾端。
VerifyData(Stream, Byte[], HashAlgorithmName)	確認數位簽章適用於目前金鑰和使用所指定雜湊演算法提供的資料。 (繼承來源 ECDsa)
VerifyData(Stream, Byte[], HashAlgorithmName, DSASignatureFormat)	驗證數位簽章對提供的資料是否有效。 (繼承來源 ECDsa)
VerifyDataCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	驗證數位簽章對提供的資料是否有效。 (繼承來源 ECDsa)
VerifyDataCore(Stream, ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	驗證數位簽章對提供的資料是否有效。 (繼承來源 ECDsa)
VerifyHash(Byte[], Byte[])	確認數位簽章適用於目前金鑰和提供的資料雜湊。
VerifyHash(Byte[], Byte[], DSASignatureFormat)	驗證數位簽章對提供的雜湊是否有效。 (繼承來源 ECDsa)
VerifyHash(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	確認數位簽章適用於目前金鑰和提供的資料雜湊。
VerifyHash(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, DSASignatureFormat)	驗證數位簽章對提供的雜湊是否有效。 (繼承來源 ECDsa)
VerifyHashCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, DSASignatureFormat)	驗證數位簽章對提供的雜湊是否有效。 (繼承來源 ECDsa)