NotImplementedException NotImplementedException NotImplementedException NotImplementedException Class

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à
NotImplementedExceptionNotImplementedExceptionNotImplementedExceptionNotImplementedException
Attributi

Esempi

Nell'esempio seguente genera 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

Il NotImplementedException eccezione viene generata quando un metodo specifico, funzione di accesso get, o funzione di accesso set è presente come un membro di un tipo ma non è implementata.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.

NotImplementedException Usa il valore predefinito Object.Equals implementazione, 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 il 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 nelle proprietà o metodi nella propria classe tipi quando di tale membro è ancora in fase di sviluppo e solo in un secondo momento verrà implementato 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 un sinonimo di "comunque di sviluppo."In other words, a NotImplementedException exception should be synonymous with "still in development."

Gestione dell'eccezioneHandling the exception

Il NotImplementedException eccezione indica che il metodo o proprietà che si sta provando a richiamare non ha un'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 si deve gestire questo errore in un try/catch blocco.As a result, you should not handle this error in a try/catch block. In alternativa, è necessario rimuovere la chiamata al membro dal codice.Instead, you should remove the member invocation from your code. Quando viene implementato in versione di produzione di una libreria, è possibile includere una chiamata al membro.You can include a call to the member when it is implemented in the production version of a library.

In alcuni casi, un NotImplementedException eccezione non può essere usata per indicare la funzionalità che è ancora in fase di sviluppo in una raccolta 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 ancora indica che la funzionalità non è disponibile, e nel rimuovere la chiamata al 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

.NET Framework include anche due altri tipi di eccezione, NotSupportedException e PlatformNotSupportedException, che indicano che per un particolare membro di un tipo è presente alcuna implementazione.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. È necessario 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.

PlatformNotSupportedException EccezionePlatformNotSupportedException exception
Se è stato progettato un tipo con uno o più membri che sono disponibili in alcune piattaforme o in alcune versioni ma non su altri utenti, è possibile generare questa eccezione nelle 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.

NotSupportedException EccezioneNotSupportedException exception
Generare un NotSupportedException eccezione se l'implementazione di un membro di interfaccia o una sostituzione per 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 tra una data e ora e un intero con segno a 32 bit significativo.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é le Convert classe implementa il 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 aggiungerà un nuovo membro che deve essere sottoposto a override da 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 tale caso, impostare il membro astratto fa sì che esistenti alle sottoclassi di caricamento ha esito negativo.In that case, making the member abstract causes existing subclasses to fail to load.

Costruttori

NotImplementedException() NotImplementedException() NotImplementedException() 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) NotImplementedException(SerializationInfo, StreamingContext) NotImplementedException(SerializationInfo, StreamingContext) 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) NotImplementedException(String) NotImplementedException(String) 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) NotImplementedException(String, Exception) NotImplementedException(String, Exception) 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 Data Data 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.

(Inherited from Exception)
HelpLink HelpLink HelpLink 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.

(Inherited from Exception)
HResult HResult HResult 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.

(Inherited from Exception)
InnerException InnerException InnerException InnerException

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

(Inherited from Exception)
Message Message Message Message

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

(Inherited from Exception)
Source Source Source 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.

(Inherited from Exception)
StackTrace StackTrace StackTrace 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.

(Inherited from Exception)
TargetSite TargetSite TargetSite TargetSite

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

(Inherited from Exception)

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetBaseException() GetBaseException() GetBaseException() 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.

(Inherited from Exception)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) 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.

(Inherited from Exception)
GetType() GetType() GetType() GetType()

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

(Inherited from Exception)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Exception)

Eventi

SerializeObjectState SerializeObjectState SerializeObjectState 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.

(Inherited from Exception)

Si applica a

Vedi anche