System.NotImplementedException-Klasse

Dieser Artikel enthält ergänzende Hinweise zur Referenzdokumentation für diese API.

Die NotImplementedException-Ausnahme wird ausgelöst, wenn eine bestimmte Methode, ein get-Accessor oder set-Accessor als Member eines Typs vorhanden ist, aber nicht implementiert wird.

NotImplementedException verwendet die Standardimplementierung Object.Equals , die die Referenzgleichheit unterstützt. Eine Liste der Anfangswerte für eine Instanz von NotImplementedException, finden Sie in den NotImplementedException Konstruktoren.

Auslösen der Ausnahme

Sie können eine NotImplementedException-Ausnahme in Eigenschaften oder Methoden in Ihren eigenen Typen auslösen, wenn sich der Member noch in der Entwicklung befindet und erst später in Produktionscode implementiert wird. Mit anderen Worten, eine NotImplementedException Ausnahme sollte gleichbedeutend mit "noch in der Entwicklung" sein.

Ausnahme behandeln

Die NotImplementedException Ausnahme gibt an, dass die Methode oder Eigenschaft, die Sie aufrufen möchten, keine Implementierung aufweist und daher keine Funktionalität bereitstellt. Daher sollten Sie diesen Fehler nicht in einem try/catch Block behandeln. Stattdessen sollten Sie den Memberaufruf aus Ihrem Code entfernen. Sie können einen Aufruf an das Mitglied einschließen, wenn es in der Produktionsversion einer Bibliothek implementiert wird.

In einigen Fällen kann eine NotImplementedException Ausnahme nicht verwendet werden, um Funktionen anzugeben, die sich noch in einer Vorproduktionsbibliothek befinden. Dies weist jedoch weiterhin darauf hin, dass die Funktionalität nicht verfügbar ist, und Sie sollten den Memberaufruf aus Ihrem Code entfernen.

NotImplementedException und andere Ausnahmetypen

.NET enthält auch zwei andere Ausnahmetypen, NotSupportedException und PlatformNotSupportedException, die angeben, dass für ein bestimmtes Mitglied eines Typs keine Implementierung vorhanden ist. Sie sollten eine der folgenden Anstelle einer NotImplementedException Ausnahme unter den folgenden Bedingungen auslösen:

• Werfen Sie eine PlatformNotSupportedException Ausnahme auf Plattformen, auf denen die Funktionalität nicht unterstützt wird, wenn Sie einen Typ mit einem oder mehreren Elementen entworfen haben, die auf einigen Plattformen oder Versionen, aber nicht bei anderen Versionen verfügbar sind.

• Lösen Sie eine NotSupportedException-Ausnahme aus, wenn die Implementierung eines Schnittstellenmembers oder einer Außerkraftsetzung für eine abstrakte Basisklassenmethode nicht möglich ist.

  Die Convert.ToInt32(DateTime)-Methode löst beispielsweise eine NotSupportedException-Ausnahme aus, da keine sinnvolle Konvertierung zwischen Datum und Uhrzeit und einer32-Bit-Ganzzahl mit Vorzeichen vorhanden ist. Die Methode muss in diesem Fall vorhanden sein, da die Convert Klasse die IConvertible Schnittstelle implementiert.

Sie sollten auch eine NotSupportedException Ausnahme auslösen, wenn Sie eine abstrakte Basisklasse implementiert haben und ihr ein neues Element hinzufügen, das von abgeleiteten Klassen überschrieben werden muss. In diesem Fall führt das Abstrahieren des Elements dazu, dass vorhandene Unterklassen nicht geladen werden.