NotImplementedException Classe

Definizione

Eccezione generata quando un'operazione o un metodo richiesto non viene implementato.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
Ereditarietà
NotImplementedException
Attributi

Esempi

Nell'esempio seguente viene generata questa eccezione per un metodo che non è stato sviluppato.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

Commenti

L' NotImplementedException eccezione viene generata quando un metodo, una funzione di accesso get o un set di funzioni di accesso a un particolare metodo è presente come membro di un tipo ma non è implementato.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.

NotImplementedExceptionutilizza l'implementazione Object.Equals predefinita che supporta l'uguaglianza dei riferimenti.NotImplementedException uses the default Object.Equals implementation, which supports reference equality. Per un elenco di valori iniziali per un'istanza di NotImplementedException, vedere i NotImplementedException costruttori.For a list of initial values for an instance of NotImplementedException, see the NotImplementedException constructors.

Generazione dell'eccezioneThrowing the exception

È possibile scegliere di generare un' NotImplementedException eccezione in proprietà o metodi nei propri tipi quando il membro è ancora in fase di sviluppo e verrà implementato solo in un secondo momento nel codice di produzione.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. In altre parole, un' NotImplementedException eccezione deve essere sinonimo di "ancora in fase di sviluppo".In other words, a NotImplementedException exception should be synonymous with "still in development."

Gestione dell'eccezioneHandling the exception

L' NotImplementedException eccezione indica che il metodo o la proprietà che si sta tentando di richiamare non ha alcuna implementazione e pertanto non fornisce alcuna funzionalità.The NotImplementedException exception indicates that the method or property that you are attempting to invoke has no implementation and therefore provides no functionality. Di conseguenza, non è necessario gestire questo errore in un try/catch blocco.As a result, you should not handle this error in a try/catch block. Al contrario, è necessario rimuovere la chiamata del membro dal codice.Instead, you should remove the member invocation from your code. È possibile includere una chiamata al membro quando viene implementato nella versione di produzione di una libreria.You can include a call to the member when it is implemented in the production version of a library.

In alcuni casi, non NotImplementedException è possibile usare un'eccezione per indicare funzionalità ancora in fase di sviluppo in una libreria di pre-produzione.In some cases, a NotImplementedException exception may not be used to indicate functionality that is still in development in a pre-production library. Tuttavia, questo indica comunque che la funzionalità non è disponibile ed è necessario rimuovere la chiamata del membro dal codice.However, this still indicates that the functionality is unavailable, and you should remove the member invocation from your code.

NotImplementedException e altri tipi di eccezioneNotImplementedException and other exception types

Il .NET Framework include anche altri due tipi di eccezione NotSupportedException , PlatformNotSupportedExceptione, che indicano che non esiste alcuna implementazione per un particolare membro di un tipo.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. È consigliabile generare uno di questi anziché un' NotImplementedException eccezione nelle condizioni seguenti.You should throw one of these instead of a NotImplementedException exception under the following conditions.

PlatformNotSupportedExceptioneccezionePlatformNotSupportedException exception
Se è stato progettato un tipo con uno o più membri disponibili in alcune piattaforme o in alcune versioni ma non in altri, è possibile generare questa eccezione sulle piattaforme in cui la funzionalità non è supportata.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.

NotSupportedExceptioneccezioneNotSupportedException exception
Genera un' NotSupportedException eccezione se l'implementazione di un membro di interfaccia o una sostituzione a un metodo della classe base astratta non è possibile.Throw a NotSupportedException exception if the implementation of an interface member or an override to an abstract base class method is not possible. Ad esempio, il Convert.ToInt32(DateTime) metodo genera un' NotSupportedException eccezione perché non esiste alcuna conversione significativa tra una data e un'ora e un intero con segno a 32 bit.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. Il metodo deve essere presente in questo caso perché la Convert classe implementa l' IConvertible interfaccia.The method must be present in this case because the Convert class implements the IConvertible interface.

È anche necessario generare un' NotSupportedException eccezione se è stata implementata una classe base astratta e si aggiunge un nuovo membro che deve essere sottoposto a override dalle classi derivate.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 tal caso, rendendo il membro astratto, le sottoclassi esistenti non verranno caricate.In that case, making the member abstract causes existing subclasses to fail to load.

Costruttori

NotImplementedException()

Inizializza una nuova istanza della classe NotImplementedException con le proprietà predefinite.Initializes a new instance of the NotImplementedException class with default properties.

NotImplementedException(SerializationInfo, StreamingContext)

Inizializza una nuova istanza della classe NotImplementedException con dati serializzati.Initializes a new instance of the NotImplementedException class with serialized data.

NotImplementedException(String)

Inizializza una nuova istanza della classe NotImplementedException con un messaggio di errore specificato.Initializes a new instance of the NotImplementedException class with a specified error message.

NotImplementedException(String, Exception)

Inizializza una nuova istanza della classe NotImplementedException con un messaggio di errore specificato e un riferimento all'eccezione interna che è la causa dell'eccezione corrente.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.

Proprietà

Data

Ottiene una raccolta di coppie chiave-valore che fornisce informazioni aggiuntive definite dall'utente relative all'eccezione.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Ereditato da Exception)
HelpLink

Ottiene o imposta un collegamento al file della Guida associato all'eccezione.Gets or sets a link to the help file associated with this exception.

(Ereditato da Exception)
HResult

Ottiene o imposta HRESULT, un valore numerico codificato che viene assegnato a un'eccezione specifica.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Ereditato da Exception)
InnerException

Ottiene l'istanza di Exception che ha causato l'eccezione corrente.Gets the Exception instance that caused the current exception.

(Ereditato da Exception)
Message

Ottiene un messaggio che descrive l'eccezione corrente.Gets a message that describes the current exception.

(Ereditato da Exception)
Source

Ottiene o imposta il nome dell'oggetto o dell'applicazione che ha generato l'errore.Gets or sets the name of the application or the object that causes the error.

(Ereditato da Exception)
StackTrace

Ottiene una rappresentazione di stringa dei frame immediati nello stack di chiamate.Gets a string representation of the immediate frames on the call stack.

(Ereditato da Exception)
TargetSite

Ottiene il metodo che genera l'eccezione corrente.Gets the method that throws the current exception.

(Ereditato da Exception)

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetBaseException()

Se utilizzato come metodo di override in una classe derivata, restituisce l'Exception che è la causa radice di una o più eccezioni successive.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Ereditato da Exception)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetObjectData(SerializationInfo, StreamingContext)

Quando l'override viene eseguito in una classe derivata, imposta il controllo SerializationInfo per la colonna.When overridden in a derived class, sets the SerializationInfo with information about the exception.

(Ereditato da Exception)
GetType()

Ottiene il tipo di runtime dell'istanza corrente.Gets the runtime type of the current instance.

(Ereditato da Exception)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Crea e restituisce una rappresentazione di stringa dell'eccezione corrente.Creates and returns a string representation of the current exception.

(Ereditato da Exception)

Eventi

SerializeObjectState

Si verifica quando un'eccezione viene serializzata per creare un oggetto di stato eccezione contenente i dati serializzati relativi all'eccezione.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Ereditato da Exception)

Si applica a

Vedi anche