Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Classe ArgumentOutOfRangeException

A exceção que é lançada quando o valor de um argumento está fora do intervalo de valores permitidos como definido pelo método chamado.

System.Object
  System.Exception
    System.SystemException
      System.ArgumentException
        System.ArgumentOutOfRangeException

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

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

O tipo ArgumentOutOfRangeException 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 StoreArgumentOutOfRangeException()Inicializa uma nova instância da classe ArgumentOutOfRangeException.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreArgumentOutOfRangeException(String)Inicializa uma nova instância da classe ArgumentOutOfRangeException com o nome do parâmetro que faz com que essa exceção.
Método protegidoArgumentOutOfRangeException(SerializationInfo, StreamingContext)Inicializa uma nova instância da classe ArgumentOutOfRangeException com dados serializados.
Método públicoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreArgumentOutOfRangeException(String, Exception)Inicializa uma nova instância da classe ArgumentOutOfRangeException com uma mensagem de erro especificada e a exceção que é a causa dessa 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 StoreArgumentOutOfRangeException(String, String)Inicializa uma nova instância da classe ArgumentOutOfRangeException com o nome do parâmetro que faz com que essa exceção e uma mensagem de erro especificada.
Método públicoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreArgumentOutOfRangeException(String, Object, String)Inicializa uma nova instância da classe ArgumentOutOfRangeException com o nome de parâmetro, o valor do argumento, e uma mensagem de erro especificada.
Superior

  NomeDescrição
Propriedade públicaCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreActualValueObtém o valor do argumento que faz com que essa exceçã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 a representação de cadeia de caracteres de valor inválido de argumentos, ou apenas a mensagem de erro se o valor do argumento é nulo. (Substitui ArgumentException.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. (Herdado de ArgumentException.)
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 valor inválido do argumento e informações adicionais de exceção. (Substitui ArgumentException.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

ArgumentOutOfRangeException é acionada quando um método é chamado e pelo menos um dos argumentos passados para o método não é null e não contém um valor válido.

ArgumentOutOfRangeException é amplamente usado por:

ArgumentOutOfRangeException se comporta de forma idêntica a ArgumentException. Fornece de modo que o código do aplicativo pode se diferenciar entre as exceções causadas pelos argumentos inválidos que não são null, e as exceções causados por argumentos nulos. Para erros causados por argumentos nulos, consulte ArgumentNullException.

ArgumentOutOfRangeException usa o HRESULT COR_E_ARGUMENTOUTOFRANGE, que tem o valor 0x80131502.

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

O exemplo a seguir define uma classe para conter informações sobre um convidado convidado. Se o convidado é mais recente de 21, uma exceção é lançada de ArgumentOutOfRangeException .


using System;

class Program
{
    static void Main(string[] args)
    {
        try
        {
            Guest guest1 = new Guest("Ben", "Miller", 17);
            Console.WriteLine(guest1.GuestInfo());
        }
        catch (ArgumentOutOfRangeException outOfRange)
        {

            Console.WriteLine("Error: {0}", outOfRange.Message);
        }
    }
}

class Guest
{
    private string FirstName;
    private string LastName;
    private int Age;

    public Guest(string fName, string lName, int age)
    {
        FirstName = fName;
        LastName = lName;
        if (age < 21)
            throw new ArgumentOutOfRangeException("age","All guests must be 21-years-old or older.");
        else
            Age = age;
    }

    public string GuestInfo()
    {
        string gInfo = FirstName + " " + LastName + ", " + Age.ToString();
        return(gInfo);
    }
}


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

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft