CryptographicException Konstruktoren

Definition

Namespace:

System.Security.Cryptography

Assembly:

System.Runtime.dll

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

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.

CryptographicException(Int32)

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 Fehlercodes für eine CryptographicUnexpectedOperationExceptionerstellt wirdCryptographicException. 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 der 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.

CryptographicException(String)

Quelle:

CryptographicException.cs

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

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)

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.

CryptographicException(SerializationInfo, StreamingContext)

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);

[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)

Parameter

info

SerializationInfo

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

context

StreamingContext

Die Kontextinformationen zur Quelle bzw. zum Ziel.

Attribute

ObsoleteAttribute

Hinweise

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

CryptographicException(String, Exception)

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);

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

• Exception
• Behandeln und Auslösen von Ausnahmen

CryptographicException(String, String)

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);

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 mit einem Zeitformat und dem aktuellen Datum 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.