CryptographicException Construtores

Definição

Namespace:

System.Security.Cryptography

Assembly:

System.Runtime.dll

Inicializa uma nova instância da classe CryptographicException.

Sobrecargas

CryptographicException()	Inicializa uma nova instância da classe CryptographicException com propriedades padrão.
CryptographicException(Int32)	Inicializa uma nova instância da classe CryptographicException com o código de erro HRESULT especificado.
CryptographicException(String)	Inicializa uma nova instância da classe CryptographicException com uma mensagem de erro especificada.
CryptographicException(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da classe CryptographicException com dados serializados.
CryptographicException(String, Exception)	Inicializa uma nova instância da classe CryptographicException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção.
CryptographicException(String, String)	Inicializa uma nova instância da classe CryptographicException com uma mensagem de erro em um formato especificado.

CryptographicException()

Origem:

CryptographicException.cs

Inicializa uma nova instância da classe CryptographicException com propriedades padrão.

public:
 CryptographicException();

public CryptographicException ();

Public Sub New ()

Exemplos

O exemplo de código a seguir demonstra como construir um CryptographicException sem parâmetros. Este exemplo de código faz parte de um exemplo maior fornecido para a CryptographicException classe .

CryptographicException^ cryptographicException = gcnew CryptographicException;

CryptographicException cryptographicException =
    new CryptographicException();

Dim cryptographicException As New CryptographicException

Comentários

A tabela a seguir mostra os valores de propriedade inicial de uma instância de CryptographicException.

Propriedade	Valor
InnerException	null.
Message	A cadeia de caracteres da mensagem de erro localizada.

CryptographicException(Int32)

Origem:

CryptographicException.cs

Inicializa uma nova instância da classe CryptographicException com o código de erro HRESULT especificado.

public:
 CryptographicException(int hr);

public CryptographicException (int hr);

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

Public Sub New (hr As Integer)

Parâmetros

hr

Int32

O código de erro HRESULT.

Exemplos

O exemplo de código a seguir demonstra como construir um usando um CryptographicException código de erro para um CryptographicUnexpectedOperationException. Este exemplo de código faz parte de um exemplo maior fornecido para a CryptographicException classe .

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)

Comentários

O CryptographicException construtor aceita um código de erro do sistema HRESULT e define a Message propriedade como uma mensagem localizada que corresponde ao HRESULT.

A tabela a seguir mostra os valores de propriedade inicial de uma instância de CryptographicException.

Propriedade	Valor
InnerException	null.
Message	A cadeia de caracteres da mensagem de erro localizada.

CryptographicException(String)

Origem:

CryptographicException.cs

Inicializa uma nova instância da classe CryptographicException com uma mensagem de erro especificada.

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)

Parâmetros

message

String

A mensagem de erro que explica a razão da exceção.

Exemplos

O exemplo de código a seguir demonstra como construir um CryptographicException usando uma mensagem de erro personalizada. Este exemplo de código faz parte de um exemplo maior fornecido para a CryptographicException classe .

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)

Comentários

A tabela a seguir mostra os valores de propriedade inicial de uma instância de CryptographicException.

Propriedade	Valor
InnerException	null.
Message	A cadeia de caracteres da mensagem de erro.

CryptographicException(SerializationInfo, StreamingContext)

Origem:

CryptographicException.cs

Cuidado

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

Inicializa uma nova instância da classe CryptographicException com dados serializados.

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)

Parâmetros

info

SerializationInfo

O objeto que mantém os dados de objeto serializados.

context

StreamingContext

As informações contextuais sobre a origem ou o destino.

Atributos

ObsoleteAttribute

Comentários

O construtor é chamado durante a desserialização para reconstituir o objeto de exceção transmitido em um fluxo.

CryptographicException(String, Exception)

Origem:

CryptographicException.cs

Inicializa uma nova instância da classe CryptographicException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção.

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)

Parâmetros

message

String

A mensagem de erro que explica a razão da exceção.

inner

Exception

A exceção que é a causa da exceção atual. Caso o parâmetro inner não seja null, a exceção atual é acionada em um bloco catch que identifica a exceção interna.

Exemplos

O exemplo de código a seguir demonstra como construir um CryptographicException usando uma mensagem de erro personalizada e uma exceção interna. Este exemplo de código faz parte de um exemplo maior fornecido para a CryptographicException classe .

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)

Comentários

Uma exceção que é lançada como um resultado direto de uma exceção anterior deve incluir uma referência para a exceção anterior na propriedade InnerException. A propriedade InnerException retorna o mesmo valor passado ao construtor, ou null se a propriedade InnerException não fornecer o valor da exceção interna ao construtor.

A tabela a seguir mostra os valores de propriedade inicial de uma instância de CryptographicException.

Propriedade	Valor
InnerException	A referência de exceção interna.
Message	A cadeia de caracteres da mensagem de erro.

Confira também

• Exception
• Manipulando e lançando exceções

CryptographicException(String, String)

Origem:

CryptographicException.cs

Inicializa uma nova instância da classe CryptographicException com uma mensagem de erro em um formato especificado.

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)

Parâmetros

format

String

O formato usado para gerar a mensagem de erro.

insert

String

A mensagem de erro que explica a razão da exceção.

Exemplos

O exemplo de código a seguir demonstra como construir um usando um CryptographicException formato de hora e a data atual. Este exemplo de código faz parte de um exemplo maior fornecido para a CryptographicException classe .

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)

Comentários

A tabela a seguir mostra os valores de propriedade inicial de uma instância de CryptographicException.

Propriedade	Valor
InnerException	null.
Message	A cadeia de caracteres da mensagem de erro.