Partilhar via


CryptographicException Construtores

Definição

Inicializa uma nova instância da classe CryptographicException.

Sobrecargas

Nome Description
CryptographicException()

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

CryptographicException(Int32)

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

CryptographicException(String)

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

CryptographicException(SerializationInfo, StreamingContext)
Obsoleto.

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

CryptographicException(String, Exception)

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

CryptographicException(String, String)

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

CryptographicException()

Origem:
CryptographicException.cs
Origem:
CryptographicException.cs
Origem:
CryptographicException.cs
Origem:
CryptographicException.cs
Origem:
CryptographicException.cs

Inicializa uma nova instância da CryptographicException classe 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 =
    new CryptographicException();
Dim cryptographicException As New CryptographicException

Comentários

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

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

Aplica-se a

CryptographicException(Int32)

Origem:
CryptographicException.cs
Origem:
CryptographicException.cs
Origem:
CryptographicException.cs
Origem:
CryptographicException.cs
Origem:
CryptographicException.cs

Inicializa uma nova instância da CryptographicException classe com o código de erro especificado 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)

Parâmetros

hr
Int32

O HRESULT código de erro.

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 = 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 iniciais para uma instância de CryptographicException.

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

Aplica-se a

CryptographicException(String)

Origem:
CryptographicException.cs
Origem:
CryptographicException.cs
Origem:
CryptographicException.cs
Origem:
CryptographicException.cs
Origem:
CryptographicException.cs

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

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)

Parâmetros

message
String

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

Exemplos

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

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 iniciais para uma instância de CryptographicException.

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

Aplica-se a

CryptographicException(SerializationInfo, StreamingContext)

Origem:
CryptographicException.cs
Origem:
CryptographicException.cs
Origem:
CryptographicException.cs
Origem:
CryptographicException.cs
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 CryptographicException classe 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);
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
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 contém os dados do objeto serializado.

context
StreamingContext

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

Atributos

Comentários

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

Aplica-se a

CryptographicException(String, Exception)

Origem:
CryptographicException.cs
Origem:
CryptographicException.cs
Origem:
CryptographicException.cs
Origem:
CryptographicException.cs
Origem:
CryptographicException.cs

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

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)

Parâmetros

message
String

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

inner
Exception

A exceção que é a causa da exceção atual. Se o parâmetro inner não for null, a exceção atual será gerada em um bloco de catch que manipula a exceção interna.

Exemplos

O exemplo de código a seguir demonstra como construir uma CryptographicException 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 = ("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 gerada como resultado direto de uma exceção anterior deve incluir uma referência à exceção anterior na propriedade InnerException. A propriedade InnerException retorna o mesmo valor que é passado para o construtor ou null se a propriedade InnerException não fornecer o valor de exceção interna ao construtor.

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

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

Confira também

Aplica-se a

CryptographicException(String, String)

Origem:
CryptographicException.cs
Origem:
CryptographicException.cs
Origem:
CryptographicException.cs
Origem:
CryptographicException.cs
Origem:
CryptographicException.cs

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

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)

Parâmetros

format
String

O formato usado para gerar a mensagem de erro.

insert
String

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

Exemplos

O exemplo de código a seguir demonstra como construir um CryptographicException formato de tempo usando um 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 = "{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 iniciais para uma instância de CryptographicException.

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

Aplica-se a