CryptographicException Конструкторы

Определение

Пространство имен:

System.Security.Cryptography

Сборка:

System.Runtime.dll

Инициализирует новый экземпляр класса CryptographicException.

Перегрузки

CryptographicException()	Инициализирует новый экземпляр класса CryptographicException стандартными свойствами.
CryptographicException(Int32)	Инициализирует новый экземпляр класса CryptographicException заданным кодом ошибки HRESULT.
CryptographicException(String)	Инициализирует новый экземпляр класса CryptographicException с указанным сообщением об ошибке.
CryptographicException(SerializationInfo, StreamingContext)	Устаревшие.. Инициализирует новый экземпляр класса CryptographicException с сериализованными данными.
CryptographicException(String, Exception)	Инициализирует новый экземпляр класса CryptographicException указанным сообщением об ошибке и ссылкой на внутреннее исключение, вызвавшее данное исключение.
CryptographicException(String, String)	Инициализирует новый экземпляр класса CryptographicException указанным сообщением об ошибке в заданном формате.

CryptographicException()

Исходный код:

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.

Свойство	Значение
InnerException	null.
Message	Строка локализованного сообщения об ошибке.

CryptographicException(Int32)

Исходный код:

CryptographicException.cs

Инициализирует новый экземпляр класса CryptographicException заданным кодом ошибки HRESULT.

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.

Примеры

В следующем примере кода показано, как создать с CryptographicException помощью кода ошибки для CryptographicUnexpectedOperationException. Этот пример входит в состав более крупного примера использования класса 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.

Свойство	Значение
InnerException	null.
Message	Строка локализованного сообщения об ошибке.

CryptographicException(String)

Исходный код:

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.

Свойство	Значение
InnerException	null.
Message	Строка сообщения об ошибке.

CryptographicException(SerializationInfo, StreamingContext)

Исходный код:

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)

Исходный код:

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 возвращает то же значение, которое передается в конструктор, или null, если свойство InnerException не предоставляет значение внутреннего исключения в конструктор.

В следующей таблице показаны первоначальные значения свойств для экземпляра CryptographicException.

Свойство	Значение
InnerException	Ссылка на внутреннее исключение.
Message	Строка сообщения об ошибке.

См. также раздел

• Exception
• Обработка и создание исключений

CryptographicException(String, String)

Исходный код:

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.

Свойство	Значение
InnerException	null.
Message	Строка сообщения об ошибке.