ArgumentNullException 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 inicia cuando se pasa una referencia nula (Nothing
en Visual Basic) a un método que no la acepta como argumento válido.
public ref class ArgumentNullException : ArgumentException
public class ArgumentNullException : ArgumentException
[System.Serializable]
public class ArgumentNullException : ArgumentException
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class ArgumentNullException : ArgumentException
type ArgumentNullException = class
inherit ArgumentException
[<System.Serializable>]
type ArgumentNullException = class
inherit ArgumentException
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ArgumentNullException = class
inherit ArgumentException
Public Class ArgumentNullException
Inherits ArgumentException
- Herencia
- Herencia
- Atributos
Comentarios
Se ArgumentNullException produce una excepción cuando se invoca un método y al menos uno de los argumentos pasados es null
pero nunca debe ser null
.
Se produce una ArgumentNullException excepción en tiempo de ejecución en las dos circunstancias principales siguientes, ambas que reflejan el error del desarrollador:
Un objeto no confirmado se pasa a un método . Para evitar el error, cree una instancia del objeto .
A continuación, se pasa un objeto devuelto desde una llamada de método como argumento a un segundo método, pero el valor del objeto devuelto original es
null
. Para evitar el error, compruebe si hay un valor devuelto que esnull
y llame al segundo método solo si el valor devuelto nonull
es .
ArgumentNullException se comporta idénticamente a ArgumentException. Se proporciona para que el código de aplicación pueda diferenciar entre las excepciones causadas por null
argumentos y excepciones causadas por argumentos que no son NULL. Para errores producidos por argumentos que no son NULL, vea ArgumentOutOfRangeException.
ArgumentNullException usa el E_POINTER HRESULT, que tiene el valor 0x80004003.
Para obtener una lista de valores de propiedad iniciales de una instancia de ArgumentNullException, consulte el ArgumentNullException constructores.
Constructores
ArgumentNullException() |
Inicializa una nueva instancia de la clase ArgumentNullException. |
ArgumentNullException(SerializationInfo, StreamingContext) |
Inicializa una nueva instancia de la clase ArgumentNullException con datos serializados. |
ArgumentNullException(String) |
Inicializa una nueva instancia de la clase ArgumentNullException con el nombre del parámetro que causa esta excepción. |
ArgumentNullException(String, Exception) |
Inicializa una nueva instancia de la clase ArgumentNullException con el mensaje de error especificado y la excepción que causó esta excepción. |
ArgumentNullException(String, String) |
Inicializa una nueva instancia de la clase ArgumentNullException con un mensaje de error especificado y el nombre del parámetro que causa 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 el mensaje de error y el nombre del parámetro. Si no se estableció ningún nombre de parámetro, obtiene solo el mensaje de error. (Heredado de ArgumentException) |
ParamName |
Obtiene el nombre del parámetro que causa esta excepción. (Heredado de ArgumentException) |
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) |
Establece el objeto SerializationInfo con el nombre del parámetro y la información adicional de la excepción. (Heredado de ArgumentException) |
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) |
ThrowIfNull(Object, String) |
Produce un ArgumentNullException si |
ThrowIfNull(Void*, String) |
Produce un ArgumentNullException si |
ToString() |
Crea y devuelve una representación de cadena de la excepción actual. (Heredado de Exception) |
Eventos
SerializeObjectState |
Obsoletos.
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) |