NotImplementedException Clase
Definición
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
- Herencia
- 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) |