Поделиться через


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

Определение

Инициализирует новый экземпляр класса 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.cs
Исходный код:
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.cs
Исходный код:
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.cs
Исходный код:
CryptographicException.cs

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

public:
 CryptographicException(System::String ^ message);
public CryptographicException (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
Исходный код:
CryptographicException.cs
Исходный код:
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);
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);
new System.Security.Cryptography.CryptographicException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Security.Cryptography.CryptographicException
[<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

Контекстные сведения об источнике или назначении.

Атрибуты

Комментарии

Этот конструктор вызывается во время десериализации для восстановления объекта исключения, переданного в потоке.

Применяется к

CryptographicException(String, Exception)

Исходный код:
CryptographicException.cs
Исходный код:
CryptographicException.cs
Исходный код:
CryptographicException.cs

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

public:
 CryptographicException(System::String ^ message, Exception ^ inner);
public CryptographicException (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 Строка сообщения об ошибке.

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

Применяется к

CryptographicException(String, String)

Исходный код:
CryptographicException.cs
Исходный код:
CryptographicException.cs
Исходный код:
CryptographicException.cs

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

public:
 CryptographicException(System::String ^ format, System::String ^ insert);
public CryptographicException (string format, 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 Строка сообщения об ошибке.

Применяется к