NotImplementedException Klas

Definitie

public ref class NotImplementedException : Exception

public ref class NotImplementedException : SystemException

public class NotImplementedException : Exception

public class NotImplementedException : SystemException

[System.Serializable]
public class NotImplementedException : SystemException

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class NotImplementedException : SystemException

type NotImplementedException = class
    inherit Exception

type NotImplementedException = class
    inherit SystemException

[<System.Serializable>]
type NotImplementedException = class
    inherit SystemException

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type NotImplementedException = class
    inherit SystemException

Public Class NotImplementedException
Inherits Exception

Public Class NotImplementedException
Inherits SystemException

Overname

Object

Exception

NotImplementedException

Overname

Object

Exception

SystemException

NotImplementedException

Kenmerken

SerializableAttribute ComVisibleAttribute

Voorbeelden

In het volgende voorbeeld wordt deze uitzondering gegenereerd voor een methode die niet is ontwikkeld.

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

static void FutureFeature()
{
    // Not developed yet.
    throw new NotImplementedException();
}

open System

let futureFeature () =
    // Not developed yet.
    raise (NotImplementedException())

[<EntryPoint>]
let main _ =
    try
        futureFeature ()
    with :? NotImplementedException as notImp ->
        printfn $"{notImp.Message}"
    0

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

Opmerkingen

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 een lid nog in ontwikkeling is en alleen later in productiecode wordt geïmplementeerd.

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.

Zie ook

• Exception
• NotSupportedException