System.NotImplementedException-klasse

De NotImplementedException uitzondering wordt gegenereerd wanneer een bepaalde methode, get accessor of set accessor aanwezig is als lid van een type, maar niet wordt geïmplementeerd.

NotImplementedException maakt gebruik van de standaard-Object.Equals-implementatie, die ondersteuning biedt voor gelijkheid van verwijzingen. Zie de NotImplementedException constructors voor een lijst met initiële waarden voor een exemplaar vanNotImplementedException.

De uitzondering gooien

U kunt ervoor kiezen om een NotImplementedException uitzondering in eigenschappen of methoden in uw eigen typen te genereren wanneer dat lid nog in ontwikkeling is en pas later in productiecode wordt geïmplementeerd. Met andere woorden, een NotImplementedException uitzondering moet synoniem zijn voor 'nog in ontwikkeling'.

De uitzondering afhandelen

De NotImplementedException uitzondering geeft aan dat de methode of eigenschap die u probeert aan te roepen geen implementatie heeft en daarom geen functionaliteit biedt. Als gevolg hiervan moet u deze fout niet in een try/catch blok verwerken. In plaats daarvan moet u de aanroep van het lid uit uw code verwijderen. U kunt een aanroep naar het lid opnemen wanneer deze wordt geïmplementeerd in de productieversie van een bibliotheek.

In sommige gevallen wordt een NotImplementedException uitzondering mogelijk niet gebruikt om de functionaliteit aan te geven die nog in ontwikkeling is in een preproductiebibliotheek. Dit geeft echter nog steeds aan dat de functionaliteit niet beschikbaar is en u moet de aanroep van het lid uit uw code verwijderen.

NotImplementedException en andere uitzonderingstypen

.NET bevat ook twee andere uitzonderingstypen en NotSupportedExceptionPlatformNotSupportedException, die aangeven dat er geen implementatie bestaat voor een bepaald lid van een type. U moet een van deze werpen in plaats van een NotImplementedException uitzondering onder de volgende voorwaarden:

• PlatformNotSupportedException Een uitzondering genereren op platforms waarop de functionaliteit niet wordt ondersteund als u een type hebt ontworpen met een of meer leden die beschikbaar zijn op sommige platforms of versies, maar niet op andere.

• NotSupportedException Een uitzondering werpen als de implementatie van een interfacelid of een overschrijving van een methode van een abstracte basisklasse niet mogelijk is.

  De Convert.ToInt32(DateTime) methode genereert bijvoorbeeld een NotSupportedException uitzondering omdat er geen zinvolle conversie tussen een datum en tijd en een 32-bits ondertekend geheel getal bestaat. De methode moet aanwezig zijn in dit geval omdat de Convert klasse de IConvertible interface implementeert.

U moet ook een NotSupportedException uitzondering genereren als u een abstracte basisklasse hebt geïmplementeerd en er een nieuw lid aan toevoegt dat moet worden overschreven door afgeleide klassen. In dat geval zorgt het maken van het abstracte lid ervoor dat bestaande subklassen niet kunnen worden geladen.