CryptographicException 构造函数

定义

命名空间:

System.Security.Cryptography

程序集:

System.Runtime.dll

初始化 CryptographicException 类的新实例。

重载

CryptographicException()	使用默认属性初始化 CryptographicException 类的新实例。
CryptographicException(Int32)	用指定的 HRESULT 错误代码初始化 CryptographicException 类的新实例。
CryptographicException(String)	用指定的错误消息初始化 CryptographicException 类的新实例。
CryptographicException(SerializationInfo, StreamingContext)	已过时. 用序列化数据初始化 CryptographicException 类的新实例。
CryptographicException(String, Exception)	使用指定的错误消息和对作为此异常原因的内部异常的引用来初始化 CryptographicException 类的新实例。
CryptographicException(String, String)	以指定格式使用指定的错误消息来初始化 CryptographicException 类的新实例。

CryptographicException()

Source:

CryptographicException.cs

使用默认属性初始化 CryptographicException 类的新实例。

public:
 CryptographicException();

public CryptographicException ();

Public Sub New ()

示例

下面的代码示例演示如何构造 CryptographicException 不带参数的 。 此代码示例是为 CryptographicException 类提供的一个更大示例的一部分。

CryptographicException^ cryptographicException = gcnew CryptographicException;

CryptographicException cryptographicException =
    new CryptographicException();

Dim cryptographicException As New CryptographicException

注解

下表显示了 CryptographicException 实例的初始属性值。

properties	值
InnerException	null.
Message	本地化的错误消息字符串。

CryptographicException(Int32)

Source:

CryptographicException.cs

用指定的 HRESULT 错误代码初始化 CryptographicException 类的新实例。

public:
 CryptographicException(int hr);

public CryptographicException (int hr);

new System.Security.Cryptography.CryptographicException : int -> System.Security.Cryptography.CryptographicException

Public Sub New (hr As Integer)

参数

hr

Int32

HRESULT 错误代码。

示例

下面的代码示例演示如何使用 的错误代码CryptographicUnexpectedOperationException构造 CryptographicException 。 此代码示例是为 CryptographicException 类提供的一个更大示例的一部分。

int exceptionNumber = (int)0x80131431;
CryptographicException^ cryptographicException = gcnew CryptographicException( exceptionNumber );

int exceptionNumber = unchecked((int)0x80131431);
CryptographicException cryptographicException =
    new CryptographicException(exceptionNumber);

Dim exceptionNumber As Integer = &H80131431
Dim cryptographicException As _
    New CryptographicException(exceptionNumber)

注解

构造 CryptographicException 函数接受系统 HRESULT 错误代码， Message 并将 属性设置为对应于 的 HRESULT本地化消息。

下表显示了 CryptographicException 实例的初始属性值。

properties	值
InnerException	null.
Message	本地化的错误消息字符串。

CryptographicException(String)

Source:

CryptographicException.cs

用指定的错误消息初始化 CryptographicException 类的新实例。

public:
 CryptographicException(System::String ^ message);

public CryptographicException (string? message);

new System.Security.Cryptography.CryptographicException : string -> System.Security.Cryptography.CryptographicException

Public Sub New (message As String)

参数

message

String

解释异常原因的错误消息。

示例

下面的代码示例演示如何使用自定义错误消息构造 CryptographicException 。 此代码示例是为 CryptographicException 类提供的一个更大示例的一部分。

String^ errorMessage = (L"Unexpected Operation exception.");
CryptographicException^ cryptographicException = gcnew CryptographicException( errorMessage );

string errorMessage = ("Unexpected Operation exception.");
CryptographicException cryptographicException =
    new CryptographicException(errorMessage);

Dim errorMessage As String = "Unexpected Operation exception."
Dim cryptographicException As New CryptographicException(errorMessage)

注解

下表显示了 CryptographicException 实例的初始属性值。

properties	值
InnerException	null.
Message	错误消息字符串。

CryptographicException(SerializationInfo, StreamingContext)

Source:

CryptographicException.cs

注意

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

用序列化数据初始化 CryptographicException 类的新实例。

protected:
 CryptographicException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected CryptographicException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.CryptographicException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Security.Cryptography.CryptographicException

Protected Sub New (info As SerializationInfo, context As StreamingContext)

参数

info

SerializationInfo

承载序列化对象数据的对象。

context

StreamingContext

关于来源和目标的上下文信息

属性

ObsoleteAttribute

注解

在反序列化期间调用此构造函数以重新构造在流上传输的异常对象。

CryptographicException(String, Exception)

Source:

CryptographicException.cs

使用指定的错误消息和对作为此异常原因的内部异常的引用来初始化 CryptographicException 类的新实例。

public:
 CryptographicException(System::String ^ message, Exception ^ inner);

public CryptographicException (string? message, Exception? inner);

new System.Security.Cryptography.CryptographicException : string * Exception -> System.Security.Cryptography.CryptographicException

Public Sub New (message As String, inner As Exception)

参数

message

String

解释异常原因的错误消息。

inner

Exception

导致当前异常的异常。 如果 inner 参数不为 null，则当前异常将在处理内部异常的 catch 块中引发。

示例

下面的代码示例演示如何使用自定义错误消息和内部异常构造 CryptographicException 。 此代码示例是为 CryptographicException 类提供的一个更大示例的一部分。

String^ errorMessage = (L"The current operation is not supported.");
NullReferenceException^ nullException = gcnew NullReferenceException;
CryptographicException^ cryptographicException = gcnew CryptographicException( errorMessage,nullException );

string errorMessage = ("The current operation is not supported.");
NullReferenceException nullException = new NullReferenceException();
CryptographicException cryptographicException = 
    new CryptographicException(errorMessage, nullException);

Dim errorMessage As String = "The current operation is not supported."
Dim nullException As New NullReferenceException
Dim cryptographicException As _
    New CryptographicException(errorMessage, nullException)

注解

因前一个异常而直接引发的异常应在 InnerException 属性中包含对前一个异常的引用。 InnerException 属性将返回传递给构造函数的同一值；如果 InnerException 属性不向构造函数提供内部异常值，则返回 null。

下表显示了 CryptographicException 实例的初始属性值。

properties	“值”
InnerException	内部异常引用。
Message	错误消息字符串。

另请参阅

• Exception
• 处理和引发异常

CryptographicException(String, String)

Source:

CryptographicException.cs

以指定格式使用指定的错误消息来初始化 CryptographicException 类的新实例。

public:
 CryptographicException(System::String ^ format, System::String ^ insert);

public CryptographicException (string format, string? insert);

new System.Security.Cryptography.CryptographicException : string * string -> System.Security.Cryptography.CryptographicException

Public Sub New (format As String, insert As String)

参数

format

String

用于输出错误信息的格式。

insert

String

解释异常原因的错误消息。

示例

下面的代码示例演示如何使用时间格式和当前日期构造 CryptographicException 。 此代码示例是为 CryptographicException 类提供的一个更大示例的一部分。

String^ dateFormat = L"{0:t}";
String^ timeStamp = (DateTime::Now.ToString());
CryptographicException^ cryptographicException = gcnew CryptographicException( dateFormat,timeStamp );

string dateFormat = "{0:t}";
string timeStamp = (DateTime.Now.ToString());
CryptographicException cryptographicException = 
    new CryptographicException(dateFormat, timeStamp);

Dim dateFormat As String = "{0:t}"
Dim timeStamp As String = DateTime.Now.ToString()
Dim cryptographicException As _
    New CryptographicException(dateFormat, timeStamp)

注解

下表显示了 CryptographicException 实例的初始属性值。

properties	值
InnerException	null.
Message	错误消息字符串。