ArgumentNullException Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
A exceção gerada quando uma referência nula (Nothing no Visual Basic) é passada para um método que não a aceita como um 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
Comentários
Uma ArgumentNullException exceção é gerada quando um método é invocado e pelo menos um dos argumentos passados é null , mas nunca deve ser null.
Uma ArgumentNullException exceção é gerada em tempo de execução nas duas circunstâncias principais a seguir, ambas refletindo o erro do desenvolvedor:
Um objeto não comprovado é passado para um método. Para evitar o erro, instancie o objeto.
Um objeto retornado de uma chamada de método é então passado como um argumento para um segundo método, mas o valor do objeto retornado original é
null. Para evitar o erro, verifique se há um valor retornado que énulle chame o segundo método somente se o valor retornado nãonullfor .
ArgumentNullException comporta-se de forma idêntica a ArgumentException. Ele é fornecido para que o código do aplicativo 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, consulte ArgumentOutOfRangeException.
ArgumentNullException usa o E_POINTER HRESULT, que tem o valor 0x80004003.
Para obter uma lista de valores de propriedade iniciais de uma instância de ArgumentNullException, consulte os construtores de ArgumentNullException.
Construtores
| Nome | Description |
|---|---|
| ArgumentNullException() |
Inicializa uma nova instância da classe ArgumentNullException. |
| 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 essa exceção. |
Propriedades
| Nome | Description |
|---|---|
| Data |
Obtém uma coleção de pares chave/valor que fornecem informações adicionais definidas pelo usuário sobre a exceção. (Herdado de Exception) |
| HelpLink |
Obtém ou define um link para o arquivo de ajuda associado a essa exceção. (Herdado de Exception) |
| HResult |
Obtém 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 |
Obtém 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 essa exceção. (Herdado de ArgumentException) |
| Source |
Obtém ou define o nome do aplicativo ou do objeto que causa o erro. (Herdado de Exception) |
| StackTrace |
Obtém uma representação de cadeia de caracteres dos quadros imediatos na pilha de chamadas. (Herdado de Exception) |
| TargetSite |
Obtém o método que gera a exceção atual. (Herdado de Exception) |
Métodos
| Nome | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetBaseException() |
Quando substituído em uma classe derivada, retorna a Exception causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception) |
| GetHashCode() |
Serve como a função hash predefinida. (Herdado de Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Define o SerializationInfo objeto com o nome do parâmetro e informações adicionais de exceção. (Herdado de ArgumentException) |
| GetType() |
Obtém o tipo de runtime da instância atual. (Herdado de Exception) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| ToString() |
Cria e retorna uma representação de cadeia de caracteres da exceção atual. (Herdado de Exception) |
Eventos
| Nome | 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) |