NotImplementedException Clase

Referencia

Definición

Espacio de nombres:: System

Ensamblado:: System.Runtime.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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: Object

Exception
NotImplementedException

Herencia: Object

Exception

SystemException
NotImplementedException

Atributos: SerializableAttribute ComVisibleAttribute

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