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

Im folgenden Beispiel wird diese Ausnahme für eine Methode ausgelöst, 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, ein Get-Accessor oder ein Set-Accessor als Member eines Typs vorhanden ist, aber nicht implementiert ist.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.

NotImplementedExceptionverwendet die Standard Object.Equals Implementierung, die Verweis Gleichheit unterstützt.NotImplementedException uses the default Object.Equals implementation, which supports reference equality. Eine Liste der Anfangswerte für eine Instanz von finden NotImplementedExceptionSie in 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 eine NotImplementedException -Ausnahme in den Eigenschaften oder Methoden in ihren eigenen Typen auslösen, wenn sich der Member noch in der Entwicklungsphase befindet und erst später im Produktionscode implementiert wird.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. Anders ausgedrückt: eine NotImplementedException -Ausnahme sollte mit "noch in der Entwicklung" Synonym sein.In other words, a NotImplementedException exception should be synonymous with "still in development."

Behandeln der AusnahmeHandling the exception

Die NotImplementedException Ausnahme gibt an, dass die Methode oder Eigenschaft, die Sie aufrufen möchten, über keine Implementierung verfügt und somit keine Funktionalität bereitstellt.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 diesen Fehler nicht in einem try/catch -Block behandeln.As a result, you should not handle this error in a try/catch block. Stattdessen sollten Sie den Member-Aufruf aus Ihrem Code entfernen.Instead, you should remove the member invocation from your code. Sie können einen-Member einschließen, wenn dieser in der Produktionsversion einer Bibliothek implementiert ist.You can include a call to the member when it is implemented in the production version of a library.

In einigen Fällen kann es NotImplementedException vorkommen, dass eine-Ausnahme nicht verwendet wird, um die Funktionalität anzugeben, die sich noch in einer präproduktionbibliothek befindet.In some cases, a NotImplementedException exception may not be used to indicate functionality that is still in development in a pre-production library. Dies bedeutet jedoch weiterhin, dass die Funktionalität nicht verfügbar ist, und Sie sollten den Element Aufruf aus Ihrem Code entfernen.However, this still indicates that the functionality is unavailable, and you should remove the member invocation from your code.

NotImplementedException und andere Ausnahme TypenNotImplementedException and other exception types

Die .NET Framework enthält auch zwei andere Ausnahme Typen, NotSupportedException und PlatformNotSupportedException, die angeben, dass für einen bestimmten Member eines Typs keine Implementierung 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. Unter den folgenden Bedingungen sollten Sie anstelle einer NotImplementedException -Ausnahme eine dieser Ausnahmen auslösen.You should throw one of these instead of a NotImplementedException exception under the following conditions.

PlatformNotSupportedExceptiondistanzierenPlatformNotSupportedException exception
Wenn Sie einen Typ mit einem oder mehreren Membern entworfen haben, die auf einigen Plattformen oder in einigen Versionen, aber nicht in anderen Versionen verfügbar sind, können Sie diese Ausnahme auf Plattformen auslösen, auf denen die Funktionalität 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.

NotSupportedExceptiondistanzierenNotSupportedException exception
Lösen Sie NotSupportedException eine-Ausnahme aus, wenn die Implementierung eines Schnittstellenmembers oder eine Überschreibung einer abstrakten Basisklassen 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. Beispielsweise löst die Convert.ToInt32(DateTime) -Methode eine NotSupportedException -Ausnahme aus, da keine sinnvolle Konvertierung zwischen einem Datum und einer Uhrzeit und einer 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 in diesem Fall vorhanden sein, Convert da die- IConvertible Klasse die-Schnittstelle implementiert.The method must be present in this case because the Convert class implements the IConvertible interface.

Sie sollten auch eine NotSupportedException -Ausnahme auslösen, wenn Sie eine abstrakte Basisklasse implementiert haben und ihr einen neuen Member hinzufügen, der von abgeleiteten Klassen überschrieben werden muss.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. In diesem Fall bewirkt dies, dass vorhandene Unterklassen nicht geladen werden, wenn der Member abstrakt ist.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