CryptographicException Construtores

Definição

Espaço de Nomes:: System.Security.Cryptography

Assemblagens:: netstandard.dll, System.Runtime.dll

Assemblagem:: System.Security.Cryptography.Primitives.dll

Assemblagem:: System.Runtime.dll

Assemblagem:: mscorlib.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da CryptographicException classe.

Sobrecargas

Name	Description
CryptographicException()	Inicializa uma nova instância da CryptographicException classe com propriedades por defeito.
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 por defeito.

public:
 CryptographicException();

public CryptographicException();

Public Sub New ()

Exemplos

O exemplo de código seguinte 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

Observações

A tabela seguinte mostra os valores iniciais das propriedades para uma instância de CryptographicException.

Property	Value
InnerException	`null`.
Message	A cadeia de mensagens de erro localizadas.

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 seguinte exemplo de código demonstra como construir um CryptographicException usando um 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)

Observações

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

A tabela seguinte mostra os valores iniciais das propriedades para uma instância de CryptographicException.

Property	Value
InnerException	`null`.
Message	A cadeia de mensagens de erro localizadas.

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 a razão da exceção.

Exemplos

O exemplo de código seguinte 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 = ("Unexpected Operation exception.");
CryptographicException cryptographicException =
    new CryptographicException(errorMessage);

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

Observações

A tabela seguinte mostra os valores iniciais das propriedades para uma instância de CryptographicException.

Property	Value
InnerException	`null`.
Message	A cadeia de mensagens de erro.

Aplica-se a

CryptographicException(SerializationInfo, StreamingContext)

Origem:: CryptographicException.cs

Origem:: CryptographicException.cs

Origem:: CryptographicException.cs

Origem:: CryptographicException.cs

Origem:: CryptographicException.cs

Atenção

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

A informação contextual sobre a origem ou destino.

Atributos: ObsoleteAttribute

Observações

Este construtor é chamado durante a desserialização para reconstituir o objeto exceção transmitido através de 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 a razão da exceção.

inner: Exception

A exceção que é a causa da exceção atual. Se o inner parâmetro não nullfor , a exceção atual é elevada num catch bloco que gere a exceção interna.

Exemplos

O exemplo de código seguinte 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 = ("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)

Observações

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

A tabela seguinte mostra os valores iniciais das propriedades para uma instância de CryptographicException.

Property	Value
InnerException	A referência à exceção interna.
Message	A cadeia de mensagens de erro.

Ver 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 a razão da exceção.

Exemplos

O seguinte exemplo de código demonstra como construir a CryptographicException usando um formato de tempo 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)

Observações

A tabela seguinte mostra os valores iniciais das propriedades para uma instância de CryptographicException.

Property	Value
InnerException	`null`.
Message	A cadeia de mensagens de erro.

Aplica-se a

Comentários

Esta página foi útil?