CryptographicException Konstruktoren

Definition

Initialisiert eine neue Instanz der CryptographicException-Klasse.

Überlädt

CryptographicException()

Initialisiert eine neue Instanz der CryptographicException-Klasse mit Standardeigenschaften.

CryptographicException(Int32)

Initialisiert eine neue Instanz der CryptographicException-Klasse mit dem angegebenen HRESULT-Fehlercode.

CryptographicException(String)

Initialisiert eine neue Instanz der CryptographicException-Klasse mit einer angegebenen Fehlermeldung.

CryptographicException(SerializationInfo, StreamingContext)
Veraltet.

Initialisiert eine neue Instanz der CryptographicException-Klasse mit serialisierten Daten.

CryptographicException(String, Exception)

Initialisiert eine neue Instanz der CryptographicException-Klasse mit einer angegebenen Fehlermeldung und einem Verweis auf die innere Ausnahme, die diese Ausnahme ausgelöst hat.

CryptographicException(String, String)

Initialisiert eine neue Instanz der CryptographicException-Klasse mit einer angegebenen Fehlermeldung im angegebenen Format.

CryptographicException()

Quelle:
CryptographicException.cs
Quelle:
CryptographicException.cs
Quelle:
CryptographicException.cs

Initialisiert eine neue Instanz der CryptographicException-Klasse mit Standardeigenschaften.

public:
 CryptographicException();
public CryptographicException ();
Public Sub New ()

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein CryptographicException ohne Parameter erstellt wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die CryptographicException-Klasse bereitgestellt wird.

CryptographicException^ cryptographicException = gcnew CryptographicException;
CryptographicException cryptographicException =
    new CryptographicException();
Dim cryptographicException As New CryptographicException

Hinweise

In der folgenden Tabelle werden die anfänglichen Eigenschaftenwerte für eine CryptographicException-Instanz aufgeführt.

Eigenschaft Wert
InnerException null.
Message Die lokalisierte Zeichenfolge mit der Fehlermeldung.

Gilt für:

CryptographicException(Int32)

Quelle:
CryptographicException.cs
Quelle:
CryptographicException.cs
Quelle:
CryptographicException.cs

Initialisiert eine neue Instanz der CryptographicException-Klasse mit dem angegebenen HRESULT-Fehlercode.

public:
 CryptographicException(int hr);
public CryptographicException (int hr);
new System.Security.Cryptography.CryptographicException : int -> System.Security.Cryptography.CryptographicException
Public Sub New (hr As Integer)

Parameter

hr
Int32

Der HRESULT-Fehlercode.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe eines CryptographicException Fehlercodes für ein CryptographicUnexpectedOperationExceptionerstellt wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die CryptographicException-Klasse bereitgestellt wird.

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)

Hinweise

Der CryptographicException Konstruktor akzeptiert einen Systemfehlercode HRESULT und legt die Message -Eigenschaft auf eine lokalisierte Nachricht fest, die dem HRESULTentspricht.

In der folgenden Tabelle werden die anfänglichen Eigenschaftenwerte für eine CryptographicException-Instanz aufgeführt.

Eigenschaft Wert
InnerException null.
Message Die lokalisierte Zeichenfolge mit der Fehlermeldung.

Gilt für:

CryptographicException(String)

Quelle:
CryptographicException.cs
Quelle:
CryptographicException.cs
Quelle:
CryptographicException.cs

Initialisiert eine neue Instanz der CryptographicException-Klasse mit einer angegebenen Fehlermeldung.

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)

Parameter

message
String

Die Fehlermeldung, in der die Ursache der Ausnahme erklärt wird.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine CryptographicException mithilfe einer benutzerdefinierten Fehlermeldung erstellt wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die CryptographicException-Klasse bereitgestellt wird.

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)

Hinweise

In der folgenden Tabelle werden die anfänglichen Eigenschaftenwerte für eine CryptographicException-Instanz aufgeführt.

Eigenschaft Wert
InnerException null.
Message Die Zeichenfolge der Fehlermeldung.

Gilt für:

CryptographicException(SerializationInfo, StreamingContext)

Quelle:
CryptographicException.cs
Quelle:
CryptographicException.cs
Quelle:
CryptographicException.cs

Achtung

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

Initialisiert eine neue Instanz der CryptographicException-Klasse mit serialisierten Daten.

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)

Parameter

info
SerializationInfo

Das Objekt, das die Daten des serialisierten Objekts enthält.

context
StreamingContext

Die Kontextinformationen zur Quelle bzw. zum Ziel.

Attribute

Hinweise

Dieser Konstruktor wird während der Deserialisierung aufgerufen, um das über einen Datenstrom übertragene Ausnahmeobjekt wieder zusammenzusetzen.

Gilt für:

CryptographicException(String, Exception)

Quelle:
CryptographicException.cs
Quelle:
CryptographicException.cs
Quelle:
CryptographicException.cs

Initialisiert eine neue Instanz der CryptographicException-Klasse mit einer angegebenen Fehlermeldung und einem Verweis auf die innere Ausnahme, die diese Ausnahme ausgelöst hat.

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)

Parameter

message
String

Die Fehlermeldung, in der die Ursache der Ausnahme erklärt wird.

inner
Exception

Die Ausnahme, die die Ursache der aktuellen Ausnahme ist. Wenn der inner-Parameter nicht null ist, wird die aktuelle Ausnahme in einem catch-Block ausgelöst, der die innere Ausnahme behandelt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine CryptographicException mithilfe einer benutzerdefinierten Fehlermeldung und einer inneren Ausnahme erstellt wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die CryptographicException-Klasse bereitgestellt wird.

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)

Hinweise

Eine Ausnahme, die als direktes Ergebnis einer vorhergehenden Ausnahme ausgelöst wird, muss in der InnerException-Eigenschaft über einen Verweis auf die vorhergehende Ausnahme verfügen. Die InnerException-Eigenschaft gibt den gleichen Wert zurück, der an den Konstruktor übergeben wird, oder null, wenn die InnerException-Eigenschaft den Wert der inneren Ausnahme nicht an den Konstruktor übergibt.

In der folgenden Tabelle werden die anfänglichen Eigenschaftenwerte für eine CryptographicException-Instanz aufgeführt.

Eigenschaft Wert
InnerException Der Verweis auf die interne Ausnahme.
Message Die Zeichenfolge der Fehlermeldung.

Weitere Informationen

Gilt für:

CryptographicException(String, String)

Quelle:
CryptographicException.cs
Quelle:
CryptographicException.cs
Quelle:
CryptographicException.cs

Initialisiert eine neue Instanz der CryptographicException-Klasse mit einer angegebenen Fehlermeldung im angegebenen Format.

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)

Parameter

format
String

Das für die Ausgabe der Fehlermeldung verwendete Format.

insert
String

Die Fehlermeldung, in der die Ursache der Ausnahme erklärt wird.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein CryptographicException mithilfe eines Zeitformats und des aktuellen Datums erstellt wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die CryptographicException-Klasse bereitgestellt wird.

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)

Hinweise

In der folgenden Tabelle werden die anfänglichen Eigenschaftenwerte für eine CryptographicException-Instanz aufgeführt.

Eigenschaft Wert
InnerException null.
Message Die Zeichenfolge der Fehlermeldung.

Gilt für: