Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase NotImplementedException

 

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

Espacio de nombres:   System
Ensamblado:  mscorlib (en mscorlib.dll)

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

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

NombreDescripción
System_CAPS_pubmethodNotImplementedException()

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

System_CAPS_protmethodNotImplementedException(SerializationInfo, StreamingContext)

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

System_CAPS_pubmethodNotImplementedException(String)

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

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

NombreDescripción
System_CAPS_pubpropertyData

Obtiene una colección de pares clave-valor que proporcionan más información definida por el usuario sobre la excepción.(Heredado de Exception).

System_CAPS_pubpropertyHelpLink

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

System_CAPS_pubpropertyHResult

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

System_CAPS_pubpropertyInnerException

Obtiene la instancia Exception que produjo la excepción actual.(Heredado de Exception).

System_CAPS_pubpropertyMessage

Obtiene un mensaje que describe la excepción actual.(Heredado de Exception).

System_CAPS_pubpropertySource

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

System_CAPS_pubpropertyStackTrace

Obtiene una representación de cadena de los marcos inmediatos en la pila de llamadas.(Heredado de Exception).

System_CAPS_pubpropertyTargetSite

Obtiene el método que produjo la excepción actual.(Heredado de Exception).

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetBaseException()

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

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetObjectData(SerializationInfo, StreamingContext)

Cuando se invalida en una clase derivada, establece SerializationInfo con información sobre la excepción.(Heredado de Exception).

System_CAPS_pubmethodGetType()

Obtiene el tipo en tiempo de ejecución de la instancia actual.(Heredado de Exception).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodToString()

Crea y devuelve una representación de cadena de la excepción actual.(Heredado de Exception).

NombreDescripción
System_CAPS_proteventSerializeObjectState

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

El NotImplementedException excepción se produce cuando un método concreto, el descriptor de acceso get o descriptor de acceso set está presente como un miembro de un tipo, pero no se ha implementado.

NotImplementedExceptionusa el valor predeterminado Object.Equals implementación, que admite la igualdad de referencia. Para obtener una lista de valores iniciales para una instancia de NotImplementedException, consulte el NotImplementedException constructores.

Puede optar por iniciar una NotImplementedException excepciones en las propiedades o métodos en sus propios tipos cuando el ese miembro aún está en desarrollo y se implementarán hasta más adelante en el código de producción. En otras palabras, un NotImplementedException excepción debe sinónimo de "aún en desarrollo."

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

En algunos casos, un NotImplementedException excepción no puede usarse para indicar la funcionalidad que aún está en desarrollo en una biblioteca de preproducción. Sin embargo, esto todavía indica que la funcionalidad no está disponible, y debe quitar la invocación del miembro desde el código.

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

PlatformNotSupportedException(excepción)

Si ha diseñado un tipo con uno o más miembros que están disponibles en algunas plataformas o en algunas versiones pero no en otras versiones, se puede producir esta excepción en plataformas que no admiten la funcionalidad.

NotSupportedException(excepción)

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

También se debe producir una NotSupportedException excepción si se ha implementado una clase base abstracta y agregar un nuevo miembro a la que debe reemplazarse por las clases derivadas. En ese caso, hacer que el miembro abstracto hace que subclases existentes no pueda cargarse.

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();
}

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: