ArgumentNullException Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
A exceção que é lançada quando uma referência nula (Nothing em Visual Basic) é passada a um método que não a aceita como argumento válido.
public ref class ArgumentNullException : ArgumentExceptionpublic class ArgumentNullException : ArgumentException[System.Serializable]
public class ArgumentNullException : ArgumentException[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class ArgumentNullException : ArgumentExceptiontype ArgumentNullException = class
inherit ArgumentException[<System.Serializable>]
type ArgumentNullException = class
inherit ArgumentException[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ArgumentNullException = class
inherit ArgumentExceptionPublic Class ArgumentNullException
Inherits ArgumentException- Herança
- Herança
- Atributos
Observações
Uma ArgumentNullException exceção é lançada quando um método é invocado e pelo menos um dos argumentos passados é null , mas nunca deve ser null, .
Uma exceção é lançada em tempo de execução nas duas circunstâncias principais seguintes, ambas refletindo erro ArgumentNullException do programador:
Um objeto não instanciado é passado para um método. Para evitar o erro, instancia o objeto.
Um objeto devolvido de uma chamada de método é então passado como argumento para um segundo método, mas o valor do objeto original devolvido é
null. Para evitar o erro, verifique um valor de retorno que sejanulle chame o segundo método apenas se o valor de retorno nãonullfor .
ArgumentNullException comporta-se de forma idêntica a ArgumentException. É fornecida para que o código de aplicação possa diferenciar entre exceções causadas por null argumentos e exceções causadas por argumentos que não são nulos. Para erros causados por argumentos que não são nulos, veja ArgumentOutOfRangeException.
ArgumentNullException utiliza o E_POINTER HRESULT, que tem o valor 0x80004003.
Para obter uma lista dos valores iniciais de propriedade de uma instância de ArgumentNullException, consulte os construtores de ArgumentNullException.
Construtores
| Name | Description |
|---|---|
| ArgumentNullException() |
Inicializa uma nova instância da ArgumentNullException classe. |
| ArgumentNullException(SerializationInfo, StreamingContext) |
Inicializa uma nova instância da ArgumentNullException classe com dados serializados. |
| ArgumentNullException(String, Exception) |
Inicializa uma nova instância da ArgumentNullException classe com uma mensagem de erro especificada e a exceção que é a causa dessa exceção. |
| ArgumentNullException(String, String) |
Inicializa uma instância da ArgumentNullException classe com uma mensagem de erro especificada e o nome do parâmetro que causa essa exceção. |
| ArgumentNullException(String) |
Inicializa uma nova instância da ArgumentNullException classe com o nome do parâmetro que causa esta exceção. |
Propriedades
| Name | Description |
|---|---|
| Data |
Obtém uma coleção de pares chave/valor que fornecem informação adicional definida pelo utilizador sobre a exceção. (Herdado de Exception) |
| HelpLink |
Obtém ou define um link para o ficheiro de ajuda associado a esta exceção. (Herdado de Exception) |
| HResult |
Recebe ou define HRESULT, um valor numérico codificado atribuído a uma exceção específica. (Herdado de Exception) |
| InnerException |
Obtém a Exception instância que causou a exceção atual. (Herdado de Exception) |
| Message |
Recebe a mensagem de erro e o nome do parâmetro, ou apenas a mensagem de erro se nenhum nome de parâmetro estiver definido. (Herdado de ArgumentException) |
| ParamName |
Obtém o nome do parâmetro que causa esta exceção. (Herdado de ArgumentException) |
| Source |
Obtém ou define o nome do aplicativo ou o objeto que causa o erro. (Herdado de Exception) |
| StackTrace |
Obtém uma representação string dos frames imediatos na stack de chamadas. (Herdado de Exception) |
| TargetSite |
Obtém o método que lança a exceção atual. (Herdado de Exception) |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetBaseException() |
Quando sobrescrito numa classe derivada, devolve o Exception que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Define o SerializationInfo objeto com o nome do parâmetro e informação adicional de exceção. (Herdado de ArgumentException) |
| GetType() |
Obtém o tipo de execução da instância atual. (Herdado de Exception) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Cria e devolve uma representação string da exceção atual. (Herdado de Exception) |
evento
| Name | Description |
|---|---|
| SerializeObjectState |
Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção. (Herdado de Exception) |