Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe NotImplementedException

 

Data di pubblicazione: agosto 2016

Eccezione generata quando un'operazione o un metodo richiesto non viene implementato.

Spazio dei nomi:   System
Assembly:  mscorlib (in mscorlib.dll)

System.Object
  System.Exception
    System.SystemException
      System.NotImplementedException

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class NotImplementedException : SystemException

NomeDescrizione
System_CAPS_pubmethodNotImplementedException()

Inizializza una nuova istanza della classe NotImplementedException con le proprietà predefinite.

System_CAPS_protmethodNotImplementedException(SerializationInfo, StreamingContext)

Inizializza una nuova istanza della classe NotImplementedException con dati serializzati.

System_CAPS_pubmethodNotImplementedException(String)

Inizializza una nuova istanza della classe NotImplementedException con un messaggio di errore specificato.

System_CAPS_pubmethodNotImplementedException(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.

NomeDescrizione
System_CAPS_pubpropertyData

Ottiene una collezione di coppie chiave/valore che forniscono ulteriori informazioni definite dall'utente sull'eccezione. (Ereditato da Exception.)

System_CAPS_pubpropertyHelpLink

Ottiene o imposta un collegamento al file della Guida associato all'eccezione.(Ereditato da Exception.)

System_CAPS_pubpropertyHResult

Ottiene o imposta HRESULT, un valore numerico codificato che viene assegnato ad una specifica eccezione. (Ereditato da Exception.)

System_CAPS_pubpropertyInnerException

Ottiene l'istanza di Exception che ha causato l'eccezione corrente.(Ereditato da Exception.)

System_CAPS_pubpropertyMessage

Ottiene un messaggio che descrive l'eccezione corrente.(Ereditato da Exception.)

System_CAPS_pubpropertySource

Ottiene o imposta il nome dell'oggetto o dell'applicazione che ha generato l'errore.(Ereditato da Exception.)

System_CAPS_pubpropertyStackTrace

Ottiene una rappresentazione in forma di stringa dei frame nello stack di chiamate. (Ereditato da Exception.)

System_CAPS_pubpropertyTargetSite

Ottiene il metodo che ha generato l'eccezione corrente. (Ereditato da Exception.)

NomeDescrizione
System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object.)

System_CAPS_protmethodFinalize()

Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object.)

System_CAPS_pubmethodGetBaseException()

Quando ne viene eseguito l'override in una classe derivata, restituisce l'Exception che è la causa radice di una o più eccezioni successive.(Ereditato da Exception.)

System_CAPS_pubmethodGetHashCode()

Funge da funzione hash predefinita.(Ereditato da Object.)

System_CAPS_pubmethodGetObjectData(SerializationInfo, StreamingContext)

Quando ne viene eseguito l'override in una classe derivata, imposta il controllo SerializationInfo con le informazioni sull'eccezione.(Ereditato da Exception.)

System_CAPS_pubmethodGetType()

Ottiene il tipo di runtime dell'istanza corrente.(Ereditato da Exception.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.(Ereditato da Object.)

System_CAPS_pubmethodToString()

Crea e restituisce una rappresentazione di stringa dell'eccezione corrente.(Ereditato da Exception.)

NomeDescrizione
System_CAPS_proteventSerializeObjectState

Si verifica quando un'eccezione viene serializzata per creare un oggetto di stato eccezione contenente i dati serializzati relativi all'eccezione.(Ereditato da Exception.)

Il NotImplementedException eccezione viene generata quando un metodo specifico, funzione di accesso get, o funzione di accesso set è presente come membro di un tipo, ma non è implementata.

NotImplementedExceptionUsa il valore predefinito Object.Equals implementazione, che supporta l'uguaglianza dei riferimenti. Per un elenco dei valori iniziali per un'istanza di NotImplementedException, vedere il NotImplementedException costruttori.

È possibile scegliere di generare un NotImplementedException eccezione nelle proprietà o tipi di metodi personalizzati quando il membro è ancora in fase di sviluppo e verrà implementato solo in un secondo momento nel codice di produzione. In altre parole, un NotImplementedException eccezione deve essere un sinonimo di "ancora lo sviluppo."

Il NotImplementedException eccezione indica che il metodo o proprietà che si sta tentando di richiamare non dispone di implementazione e pertanto non fornisce alcuna funzionalità. Di conseguenza, non deve gestire l'errore in un try/catch blocco. In alternativa, è necessario rimuovere la chiamata del membro dal codice. Quando viene implementato in una versione di produzione di una libreria, è possibile includere una chiamata al membro.

In alcuni casi, un NotImplementedException eccezione non può essere utilizzata per indicare la funzionalità che è ancora in fase di sviluppo in una raccolta di pre-produzione. Tuttavia, questo ancora indica che la funzionalità è disponibile e che è necessario rimuovere la chiamata del membro dal codice.

.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. È consigliabile utilizzare uno di questi throw anziché un NotImplementedException eccezione nelle condizioni seguenti.

PlatformNotSupportedExceptioneccezione

Se un tipo è progettato con uno o più membri che non sono disponibili su alcune piattaforme o in alcune versioni ma non su altri utenti, è possibile generare questa eccezione su piattaforme in cui non è supportata la funzionalità.

NotSupportedExceptioneccezione

Generare un NotSupportedException eccezione se l'implementazione di un membro di interfaccia o un override di un metodo di classe base astratta non è possibile. 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. Il metodo deve essere presentano in questo caso perché il Convert classe implementa il IConvertible interfaccia.

Inoltre, è necessario generare un NotSupportedException eccezione se è stata implementata una classe base astratta e aggiungere un nuovo membro che deve essere sottoposto a override da classi derivate. In caso, impostare il membro astratto causa sottoclassi esistente non riuscire a caricare.

Nell'esempio seguente genera questa eccezione per un metodo che non è stato sviluppato.

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

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

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 1.1
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: