NotImplementedException Clase

Definición

Excepción que se produce cuando no se ha implementado un método u operación que se haya solicitado.

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
Herencia
NotImplementedException
Herencia
NotImplementedException
Atributos

Ejemplos

En el ejemplo siguiente se produce esta excepción para un método que no se ha desarrollado.

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

Comentarios

La NotImplementedException excepción se produce cuando un método determinado, un descriptor de acceso get o un descriptor de acceso set está presente como miembro de un tipo, pero no se implementa.

NotImplementedException usa la implementación predeterminada Object.Equals , que admite la igualdad de referencias. Para obtener una lista de valores iniciales para una instancia de NotImplementedException, vea los NotImplementedException constructores.

Iniciar la excepción

Puede optar por iniciar una NotImplementedException excepción en propiedades o métodos de sus propios tipos cuando el miembro todavía está en desarrollo y solo se implementará más adelante en el código de producción. Es decir, una NotImplementedException excepción debe ser sinónimo de "todavía en desarrollo".

Control de la excepción

La NotImplementedException excepción indica que el método o propiedad que está intentando invocar no tiene ninguna implementación y, por lo tanto, no proporciona ninguna funcionalidad. Como resultado, no debe controlar este error en un try/catch bloque. En su lugar, debe quitar la invocación de miembro del código. Puede incluir una llamada al miembro cuando se implementa en la versión de producción de una biblioteca.

En algunos casos, es posible que no se use una NotImplementedException excepción para indicar la funcionalidad que todavía está en desarrollo en una biblioteca de preproducción. Sin embargo, esto sigue indicando que la funcionalidad no está disponible y debe quitar la invocación de miembro del código.

NotImplementedException y otros tipos de excepción

El .NET Framework también incluye otros dos tipos de excepción, NotSupportedException y PlatformNotSupportedException, que indican que no existe ninguna implementación para un miembro determinado de un tipo. Debe iniciar uno de estos en lugar de una NotImplementedException excepción en las condiciones siguientes.

PlatformNotSupportedException Excepción
Si ha diseñado un tipo con uno o varios miembros que están disponibles en algunas plataformas o en algunas versiones, pero no en otras, puede iniciar esta excepción en plataformas en las que no se admite la funcionalidad.

NotSupportedException Excepción
Produce una NotSupportedException excepción si la implementación de un miembro de interfaz o una invalidación en un método de clase base abstracta no es posible. Por ejemplo, el Convert.ToInt32(DateTime) método produce una NotSupportedException excepción porque no existe ninguna conversión significativa entre una fecha y hora y un entero con signo de 32 bits. El método debe estar presente en este caso porque la Convert clase implementa la IConvertible interfaz .

También debe producir una NotSupportedException excepción si ha implementado una clase base abstracta y agregarle un nuevo miembro que deben invalidarse las clases derivadas. En ese caso, al convertir el elemento en resumen, las subclases existentes no se cargan.

Constructores

NotImplementedException()

Inicializa una nueva instancia de la clase NotImplementedException con propiedades predeterminadas.

NotImplementedException(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase NotImplementedException con datos serializados.

NotImplementedException(String)

Inicializa una nueva instancia de la clase NotImplementedException con el mensaje de error especificado.

NotImplementedException(String, Exception)

Inicializa una nueva instancia de la clase NotImplementedException con el mensaje de error especificado y una referencia a la excepción interna que representa la causa de esta excepción.

Propiedades

Data

Obtiene una colección de pares clave/valor que proporciona información definida por el usuario adicional sobre la excepción.

(Heredado de Exception)
HelpLink

Obtiene o establece un vínculo al archivo de ayuda asociado a esta excepción.

(Heredado de Exception)
HResult

Obtiene o establece HRESULT, un valor numérico codificado que se asigna a una excepción específica.

(Heredado de Exception)
InnerException

Obtiene la instancia Exception que produjo la excepción actual.

(Heredado de Exception)
Message

Obtiene un mensaje que describe la excepción actual.

(Heredado de Exception)
Source

Devuelve o establece el nombre de la aplicación o del objeto que generó el error.

(Heredado de Exception)
StackTrace

Obtiene una representación de cadena de los marcos inmediatos en la pila de llamadas.

(Heredado de Exception)
TargetSite

Obtiene el método que produjo la excepción actual.

(Heredado de Exception)

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetBaseException()

Cuando se invalida en una clase derivada, devuelve la clase Exception que representa la causa principal de una o más excepciones posteriores.

(Heredado de Exception)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetObjectData(SerializationInfo, StreamingContext)

Cuando se invalida en una clase derivada, establece SerializationInfo con información sobre la excepción.

(Heredado de Exception)
GetType()

Obtiene el tipo de tiempo de ejecución de la instancia actual.

(Heredado de Exception)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ToString()

Crea y devuelve una representación de cadena de la excepción actual.

(Heredado de Exception)

Eventos

SerializeObjectState
Obsoleto.

Ocurre cuando una excepción se serializa para crear un objeto de estado de excepción que contenga datos serializados sobre la excepción.

(Heredado de Exception)

Se aplica a

Consulte también