NotImplementedException NotImplementedException NotImplementedException NotImplementedException Class

Definition

Die Ausnahme, die ausgelöst wird, wenn eine angeforderte Methode oder Operation nicht implementiert ist.The exception that is thrown when a requested method or operation is not implemented.

public ref class NotImplementedException : SystemException
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class NotImplementedException : SystemException
type NotImplementedException = class
    inherit SystemException
Public Class NotImplementedException
Inherits SystemException
Vererbung
NotImplementedExceptionNotImplementedExceptionNotImplementedExceptionNotImplementedException
Attribute

Beispiele

Das folgende Beispiel löst diese Ausnahme für eine Methode, die nicht entwickelt wurde.The following example throws this exception for a method that has not been developed.

static void Main(string[] args)
{
    try
    {
        FutureFeature();
    }
    catch (NotImplementedException notImp)
    {
        Console.WriteLine(notImp.Message);
    }
}

static void FutureFeature()
{
    // Not developed yet.
    throw new NotImplementedException();
}
Sub Main()
    Try
        FutureFeature()
    Catch NotImp As NotImplementedException
        Console.WriteLine(NotImp.Message)
    End Try


End Sub

Sub FutureFeature()
    ' not developed yet.
    Throw New NotImplementedException()
End Sub

Hinweise

Die NotImplementedException Ausnahme wird ausgelöst, wenn eine bestimmte Methode, Get-Accessor oder Set-Accessor als ein Member eines Typs vorhanden ist, jedoch ist nicht implementiert.The NotImplementedException exception is thrown when a particular method, get accessor, or set accessor is present as a member of a type but is not implemented.

NotImplementedException verwendet die standardmäßige Object.Equals -Implementierung, die auf Verweisgleichheit unterstützt.NotImplementedException uses the default Object.Equals implementation, which supports reference equality. Eine Liste der ursprünglichen Werte für eine Instanz von NotImplementedException, finden Sie unter den NotImplementedException Konstruktoren.For a list of initial values for an instance of NotImplementedException, see the NotImplementedException constructors.

Auslösen der AusnahmeThrowing the exception

Sie können auch Auslösen eine NotImplementedException Ausnahme in den Eigenschaften oder Methoden in Ihren eigenen Typen, wenn der dieses Element befindet sich noch in Entwicklung und wird erst später im Produktionscode implementiert.You might choose to throw a NotImplementedException exception in properties or methods in your own types when the that member is still in development and will only later be implemented in production code. Das heißt, eine NotImplementedException Ausnahme muss mit "immer noch in Entwicklung."In other words, a NotImplementedException exception should be synonymous with "still in development."

AusnahmebehandlungHandling the exception

Die NotImplementedException Ausnahme gibt an, dass die Methode oder Eigenschaft, die Sie aufrufen möchten, verfügt über keine Implementierung und aus diesem Grund stellt keine Funktionalität bereit.The NotImplementedException exception indicates that the method or property that you are attempting to invoke has no implementation and therefore provides no functionality. Daher sollten Sie nicht diesen Fehler in behandeln eine try/catch Block.As a result, you should not handle this error in a try/catch block. Stattdessen sollten Sie den Memberaufruf aus dem Code entfernen.Instead, you should remove the member invocation from your code. Fügen Sie einen Aufruf an den Member, wenn es in die Produktionsversion einer Bibliothek implementiert wurde.You can include a call to the member when it is implemented in the production version of a library.

In einigen Fällen eine NotImplementedException Ausnahme kann nicht verwendet werden, um Funktionen anzugeben, dass noch in der Entwicklung in einer Bibliothek vor der Produktion.In some cases, a NotImplementedException exception may not be used to indicate functionality that is still in development in a pre-production library. Allerdings bedeutet dies immer noch, dass die Funktionalität nicht verfügbar ist und Sie sollten die Memberaufruf aus dem Code entfernen.However, this still indicates that the functionality is unavailable, and you should remove the member invocation from your code.

NotImplementedException und andere AusnahmetypenNotImplementedException and other exception types

.NET Framework enthält auch zwei andere Ausnahmetypen NotSupportedException und PlatformNotSupportedException, anzugeben, dass keine Implementierung für einen bestimmten Member eines Typs vorhanden ist.The .NET Framework also includes two other exception types, NotSupportedException and PlatformNotSupportedException, that indicate that no implementation exists for a particular member of a type. Lösen Sie eine dieser statt einer NotImplementedException Ausnahme unter den folgenden Bedingungen.You should throw one of these instead of a NotImplementedException exception under the following conditions.

PlatformNotSupportedException AusnahmePlatformNotSupportedException exception
Wenn Sie haben einen Typ entworfen, mit der ein oder mehrere Elemente, die auf einigen Plattformen oder in einigen Versionen verfügbar sind, jedoch nicht auf andere, können Sie diese Ausnahme auslösen, auf Plattformen, die auf denen die Funktion nicht unterstützt wird.If you've designed a type with one or more members that are available on some platforms or in some versions but not on others, you can throw this exception on platforms on which the functionality is not supported.

NotSupportedException AusnahmeNotSupportedException exception
Auslösen einer NotSupportedException -Ausnahme aus, wenn die Implementierung eines Schnittstellenmembers oder eine Überschreibung einer abstrakten Klasse-Methode nicht möglich ist.Throw a NotSupportedException exception if the implementation of an interface member or an override to an abstract base class method is not possible. Z. B. die Convert.ToInt32(DateTime) -Methode löst eine NotSupportedException Ausnahme, da keine sinnvolle Konvertierung zwischen einem Datum und Uhrzeit sowie eine 32-Bit-Ganzzahl mit Vorzeichen vorhanden ist.For example, the Convert.ToInt32(DateTime) method throws a NotSupportedException exception because no meaningful conversion between a date and time and a 32-bit signed integer exists. Die Methode muss möglicherweise vorhanden in diesem Fall die Convert -Klasse implementiert die IConvertible Schnittstelle.The method must be present in this case because the Convert class implements the IConvertible interface.

Lösen Sie auch eine NotSupportedException -Ausnahme aus, wenn Sie eine abstrakte Basisklasse implementiert, und fügen ein neues Element hinzu, die von überschrieben werden müssen abgeleitete Klassen.You should also throw a NotSupportedException exception if you've implemented an abstract base class and add a new member to it that must be overridden by derived classes. Darin, dass der Fall, des Members abstrakt bewirkt, dass vorhandene Unterklassen, die nicht geladen werden.In that case, making the member abstract causes existing subclasses to fail to load.

Konstruktoren

NotImplementedException() NotImplementedException() NotImplementedException() NotImplementedException()

Initialisiert eine neue Instanz der NotImplementedException-Klasse mit Standardeigenschaften.Initializes a new instance of the NotImplementedException class with default properties.

NotImplementedException(SerializationInfo, StreamingContext) NotImplementedException(SerializationInfo, StreamingContext) NotImplementedException(SerializationInfo, StreamingContext) NotImplementedException(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der NotImplementedException-Klasse mit serialisierten Daten.Initializes a new instance of the NotImplementedException class with serialized data.

NotImplementedException(String) NotImplementedException(String) NotImplementedException(String) NotImplementedException(String)

Initialisiert eine neue Instanz der NotImplementedException-Klasse mit einer angegebenen Fehlermeldung.Initializes a new instance of the NotImplementedException class with a specified error message.

NotImplementedException(String, Exception) NotImplementedException(String, Exception) NotImplementedException(String, Exception) NotImplementedException(String, Exception)

Initialisiert eine neue Instanz der NotImplementedException-Klasse mit einer angegebenen Fehlermeldung und einem Verweis auf die innere Ausnahme, die diese Ausnahme ausgelöst hat.Initializes a new instance of the NotImplementedException class with a specified error message and a reference to the inner exception that is the cause of this exception.

Eigenschaften

Data Data Data Data

Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen über die Ausnahme bereitstellen.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Inherited from Exception)
HelpLink HelpLink HelpLink HelpLink

Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest.Gets or sets a link to the help file associated with this exception.

(Inherited from Exception)
HResult HResult HResult HResult

Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Inherited from Exception)
InnerException InnerException InnerException InnerException

Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat.Gets the Exception instance that caused the current exception.

(Inherited from Exception)
Message Message Message Message

Ruft eine Meldung ab, die die aktuelle Ausnahme beschreibt.Gets a message that describes the current exception.

(Inherited from Exception)
Source Source Source Source

Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest.Gets or sets the name of the application or the object that causes the error.

(Inherited from Exception)
StackTrace StackTrace StackTrace StackTrace

Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab.Gets a string representation of the immediate frames on the call stack.

(Inherited from Exception)
TargetSite TargetSite TargetSite TargetSite

Ruft die Methode ab, die die aktuelle Ausnahme auslöst.Gets the method that throws the current exception.

(Inherited from Exception)

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBaseException() GetBaseException() GetBaseException() GetBaseException()

Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die ursprüngliche Ursache für eine oder mehrere nachfolgende Ausnahmen ist.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Inherited from Exception)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Legt beim Überschreiben in einer abgeleiteten Klasse die SerializationInfo mit Informationen über die Ausnahme fest.When overridden in a derived class, sets the SerializationInfo with information about the exception.

(Inherited from Exception)
GetType() GetType() GetType() GetType()

Ruft den Laufzeittyp der aktuellen Instanz ab.Gets the runtime type of the current instance.

(Inherited from Exception)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Erstellt eine Zeichenfolgendarstellung der aktuellen Ausnahme und gibt diese zurück.Creates and returns a string representation of the current exception.

(Inherited from Exception)

Ereignisse

SerializeObjectState SerializeObjectState SerializeObjectState SerializeObjectState

Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt mit serialisierten Daten über die Ausnahme zu erstellen.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Inherited from Exception)

Gilt für:

Siehe auch