VENDAS: 1-800-867-1389
Informações
O tópico solicitado está sendo mostrado abaixo. No entanto, este tópico não está incluído nesta biblioteca.

Classe ArgumentException

Exceção que é lançada quando um dos argumentos providos a um método não é válido.

System.Object
  System.Exception
    System.SystemException
      System.ArgumentException
        Mais...

Namespace:  System
Assembly:  mscorlib (em mscorlib.dll)

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class ArgumentException : SystemException, 
	ISerializable

O tipo ArgumentException expõe os membros a seguir.

  NomeDescrição
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreArgumentException()Inicializa uma nova instância da classe ArgumentException.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreArgumentException(String)Inicializa uma nova instância da classe ArgumentException com uma mensagem de erro especificada.
Método protegidoArgumentException(SerializationInfo, StreamingContext)Inicializa uma nova instância da classe ArgumentException com dados serializados.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreArgumentException(String, Exception)Inicializa uma nova instância da classe ArgumentException com uma mensagem de erro especificada e uma referência para a exceção interna que é a causa desta exceção.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreArgumentException(String, String)Inicializa uma nova instância da classe ArgumentException com uma mensagem de erro especificada e o nome do parâmetro que faz com que essa exceção.
Método públicoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreArgumentException(String, String, Exception)Inicializa uma nova instância da classe ArgumentException com uma mensagem de erro especificada, o nome de parâmetro, e uma referência à exceção interna que é a causa dessa exceção.
Superior

  NomeDescrição
Propriedade públicaCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreData 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.)
Propriedade públicaCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreHelpLinkObtém ou define um link para o arquivo de ajuda associado a esta exceção. (Herdado de Exception.)
Propriedade públicaCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreHResultObtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica. (Herdado de Exception.)
Propriedade públicaCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreInnerExceptionObtém a instância de Exception que causou a exceção atual. (Herdado de Exception.)
Propriedade públicaCompatível com o XNA FrameworkMessageRecebe a mensagem de erro e o nome de parâmetro, ou apenas a mensagem de erro se nenhum nome de parâmetro é definido. (Substitui Exception.Message.)

No XNA Framework 3.0, este membro é herdado de Exception.Message.
Propriedade públicaCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreParamNameObtém o nome do parâmetro que faz com que essa exceção.
Propriedade públicaCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreSource Obtém ou define o nome do aplicativo ou do objeto que causa o erro. (Herdado de Exception.)
Propriedade públicaCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreStackTraceObtém uma representação de cadeia de caracteres de peças imediatos na pilha de chamadas. (Herdado de Exception.)
Propriedade públicaTargetSiteObtém o método que gera a exceção atual. (Herdado de Exception.)
Superior

  NomeDescrição
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método protegidoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreFinalize Permite um objeto tentar liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreGetBaseException Quando substituído em uma classe derivada, retorna a Exception que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception.)
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreGetHashCodeServe como a função de hash padrão. (Herdado de Object.)
Método públicoGetObjectDataDefina o objeto de SerializationInfo com o nome do parâmetro e informações adicionais de exceção. (Substitui Exception.GetObjectData(SerializationInfo, StreamingContext).)
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreGetType Obtém o tipo em tempo de execução da instância atual. (Herdado de Exception.)

No XNA Framework 3.0, este membro é herdado de Object.GetType().


No Biblioteca de Classes Portátil Biblioteca de Classes Portátil, este membro é herdado de Object.GetType().


No .NET para aplicativos da Windows Store Windows 8, este membro é herdado de Object.GetType().
Método protegidoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreMemberwiseCloneCria uma cópia superficial do Object atual. (Herdado de Object.)
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreToString Cria e retorna uma representação da cadeia de caracteres da exceção atual. (Herdado de Exception.)
Superior

  NomeDescrição
Evento protegidoSerializeObjectStateOcorre quando uma exceção é serializada para criar um objeto do estado da exceção que contém dados serializado sobre a exceção. (Herdado de Exception.)
Superior

ArgumentException é acionada quando um método é chamado e pelo menos um dos argumentos passados não satisfaz a especificação do método chamado. Todas as instâncias de ArgumentException devem levar uma mensagem de erro significativo que descrevem o argumento válido, bem como o intervalo esperado de valores para o argumento.

As principais classes derivadas de ArgumentException são ArgumentNullException e ArgumentOutOfRangeException. Essas classes derivadas devem ser usados em vez de ArgumentException, exceto em situações onde nenhuma das classes derivadas é aceitável. Por exemplo, as exceções devem ser lançadas por:

  • ArgumentNullException sempre que null é passado ao método que não aceita o como um argumento válido.

  • ArgumentOutOfRangeException quando o valor de um argumento está fora do intervalo de valores aceitáveis; por exemplo, quando o valor “46 " é passado como o argumento do mês durante a criação de DateTime.

Se a chamada de método não tem nenhum argumento ou se a falha não envolve os próprios argumentos, então InvalidOperationException deve ser usado.

ArgumentException usa o HRESULT COR_E_ARGUMENT, que tem o valor 0x80070057.

Para uma lista de valores de propriedade iniciais para uma instância de ArgumentException, consulte os construtores de ArgumentException .

O exemplo a seguir demonstra como lançar e capturar ArgumentException.


using System;

public sealed class App 
{
    static void Main() 
    {
        // ArgumentException is not thrown because 10 is an even number.
        Console.WriteLine("10 divided by 2 is {0}", DivideByTwo(10));
        try 
        {
             // ArgumentException is thrown because 7 is not an even number.
             Console.WriteLine("7 divided by 2 is {0}", DivideByTwo(7));
        }
        catch (ArgumentException)
        {
            // Show the user that 7 cannot be divided by 2.
            Console.WriteLine("7 is not divided by 2 integrally.");
        }
    }

    static int DivideByTwo(int num) 
    {
        // If num is an odd number, throw an ArgumentException.
        if ((num & 1) == 1)
            throw new ArgumentException("Number must be even", "num");

        // num is even, return half of its value.
        return num / 2;
    }
}


// This code produces the following output.
// 
// 10 divided by 2 is 5
// 7 is not divided by 2 integrally.


.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Biblioteca de Classes Portátil

Com suporte em: Biblioteca de Classes Portátil

.NET para aplicativos da Windows Store

Com suporte em: Windows 8

.NET para aplicativos do Windows Phone

Com suporte em: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.
Isso foi útil para você?
(1500 caracteres restantes)
Agradecemos os seus comentários

Contribuições da comunidade

Mostrar:
© 2014 Microsoft