ArgumentOutOfRangeException Construtores

Referência

Definição

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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.

Inicializa uma nova instância da classe ArgumentOutOfRangeException.

Sobrecargas

ArgumentOutOfRangeException()	Inicializa uma nova instância da classe ArgumentOutOfRangeException.
ArgumentOutOfRangeException(String)	Inicializa uma nova instância da classe ArgumentOutOfRangeException com o nome do parâmetro que causa essa exceção.
ArgumentOutOfRangeException(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da classe ArgumentOutOfRangeException com dados serializados.
ArgumentOutOfRangeException(String, Exception)	Inicializa uma nova instância da classe ArgumentOutOfRangeException com uma mensagem de erro especificada e a exceção interna que é a causa desta exceção.
ArgumentOutOfRangeException(String, String)	Inicializa uma nova instância da classe ArgumentOutOfRangeException com o nome do parâmetro que causa essa exceção e uma mensagem de erro especificada.
ArgumentOutOfRangeException(String, Object, String)	Inicializa uma nova instância da classe ArgumentOutOfRangeException com o nome do parâmetro, o valor do argumento e uma mensagem de erro especificada.

ArgumentOutOfRangeException()

Origem:: ArgumentOutOfRangeException.cs

Origem:: ArgumentOutOfRangeException.cs

Origem:: ArgumentOutOfRangeException.cs

Inicializa uma nova instância da classe ArgumentOutOfRangeException.

public:
 ArgumentOutOfRangeException();

public ArgumentOutOfRangeException ();

Public Sub New ()

Comentários

Esse construtor inicializa a Message propriedade da nova instância para uma mensagem fornecida pelo sistema que descreve o erro, como "Número não negativo necessário". Essa mensagem leva em conta a cultura atual do sistema.

A tabela a seguir mostra os valores de propriedade inicial de uma instância de ArgumentOutOfRangeException.

Propriedade	Valor
InnerException	Uma referência nula (`Nothing` no Visual Basic).
Message	A cadeia de caracteres da mensagem de erro localizada.

Aplica-se a

ArgumentOutOfRangeException(String)

Origem:: ArgumentOutOfRangeException.cs

Origem:: ArgumentOutOfRangeException.cs

Origem:: ArgumentOutOfRangeException.cs

Inicializa uma nova instância da classe ArgumentOutOfRangeException com o nome do parâmetro que causa essa exceção.

public:
 ArgumentOutOfRangeException(System::String ^ paramName);

public ArgumentOutOfRangeException (string paramName);

public ArgumentOutOfRangeException (string? paramName);

new ArgumentOutOfRangeException : string -> ArgumentOutOfRangeException

Public Sub New (paramName As String)

Parâmetros

paramName: String

O nome do parâmetro que causa essa exceção.

Comentários

Esse construtor inicializa a ParamName propriedade da nova instância usando o paramName parâmetro . O conteúdo de paramName deve ser compreendido por humanos.

A tabela a seguir mostra os valores de propriedade inicial de uma instância de ArgumentOutOfRangeException.

Propriedade	Valor
InnerException	Uma referência nula (`Nothing` no Visual Basic).
Message	A cadeia de caracteres vazia ("").
ParamName	A cadeia de caracteres do nome do parâmetro.

Aplica-se a

ArgumentOutOfRangeException(SerializationInfo, StreamingContext)

Origem:: ArgumentOutOfRangeException.cs

Origem:: ArgumentOutOfRangeException.cs

Origem:: ArgumentOutOfRangeException.cs

Cuidado

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Inicializa uma nova instância da classe ArgumentOutOfRangeException com dados serializados.

protected:
 ArgumentOutOfRangeException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

protected ArgumentOutOfRangeException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected ArgumentOutOfRangeException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

new ArgumentOutOfRangeException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ArgumentOutOfRangeException

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new ArgumentOutOfRangeException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ArgumentOutOfRangeException

Protected Sub New (info As SerializationInfo, context As StreamingContext)

Parâmetros

info: SerializationInfo

O objeto que mantém os dados de objeto serializados.

context: StreamingContext

Um objeto que descreve a origem ou o destino dos dados serializados.

Atributos: ObsoleteAttribute

Comentários

O construtor é chamado durante a desserialização para reconstituir o objeto de exceção transmitido em um fluxo. Para obter mais informações, consulte serialização XML e SOAP.

Confira também

Serialização XML e SOAP

Aplica-se a

ArgumentOutOfRangeException(String, Exception)

Origem:: ArgumentOutOfRangeException.cs

Origem:: ArgumentOutOfRangeException.cs

Origem:: ArgumentOutOfRangeException.cs

Inicializa uma nova instância da classe ArgumentOutOfRangeException com uma mensagem de erro especificada e a exceção interna que é a causa desta exceção.

public:
 ArgumentOutOfRangeException(System::String ^ message, Exception ^ innerException);

public ArgumentOutOfRangeException (string message, Exception innerException);

public ArgumentOutOfRangeException (string? message, Exception? innerException);

new ArgumentOutOfRangeException : string * Exception -> ArgumentOutOfRangeException

Public Sub New (message As String, innerException As Exception)

Parâmetros

message: String

A mensagem de erro que explica a razão desta exceção.

innerException: Exception

A exceção que é a causa da exceção atual ou uma referência nula (Nothing no Visual Basic) se nenhuma exceção interna é especificada.

Aplica-se a

ArgumentOutOfRangeException(String, String)

Origem:: ArgumentOutOfRangeException.cs

Origem:: ArgumentOutOfRangeException.cs

Origem:: ArgumentOutOfRangeException.cs

Inicializa uma nova instância da classe ArgumentOutOfRangeException com o nome do parâmetro que causa essa exceção e uma mensagem de erro especificada.

public:
 ArgumentOutOfRangeException(System::String ^ paramName, System::String ^ message);

public ArgumentOutOfRangeException (string paramName, string message);

public ArgumentOutOfRangeException (string? paramName, string? message);

new ArgumentOutOfRangeException : string * string -> ArgumentOutOfRangeException

Public Sub New (paramName As String, message As String)

Parâmetros

paramName: String

O nome do parâmetro que causou a exceção.

message: String

A mensagem que descreve o erro.

Comentários

Esse construtor inicializa a Message propriedade da nova instância usando o valor do message parâmetro . O conteúdo do parâmetro message deve ser compreendido por humanos. O chamador deste construtor é obrigatório para garantir que esta cadeia de caracteres foi localizada para a cultura do sistema atual.

Esse construtor inicializa a ParamName propriedade da nova instância usando o paramName parâmetro . O conteúdo de paramName deve ser compreendido por humanos.

A tabela a seguir mostra os valores de propriedade inicial de uma instância de ArgumentOutOfRangeException.

Propriedade	Valor
InnerException	`null`.
Message	A cadeia de caracteres da mensagem de erro.
ParamName	A cadeia de caracteres do nome do parâmetro.

Aplica-se a

ArgumentOutOfRangeException(String, Object, String)

Origem:: ArgumentOutOfRangeException.cs

Origem:: ArgumentOutOfRangeException.cs

Origem:: ArgumentOutOfRangeException.cs

Inicializa uma nova instância da classe ArgumentOutOfRangeException com o nome do parâmetro, o valor do argumento e uma mensagem de erro especificada.

public:
 ArgumentOutOfRangeException(System::String ^ paramName, System::Object ^ actualValue, System::String ^ message);

public ArgumentOutOfRangeException (string paramName, object actualValue, string message);

public ArgumentOutOfRangeException (string? paramName, object? actualValue, string? message);

new ArgumentOutOfRangeException : string * obj * string -> ArgumentOutOfRangeException

Public Sub New (paramName As String, actualValue As Object, message As String)

Parâmetros

paramName: String

O nome do parâmetro que causou a exceção.

actualValue: Object

O valor do argumento que causa essa exceção.

message: String

A mensagem que descreve o erro.

Comentários

Esse construtor inicializa a ParamName propriedade da nova instância usando o paramName parâmetro , a ActualValue propriedade usando o actualValue parâmetro e a Message propriedade usando o message parâmetro . O conteúdo dos paramName parâmetros e message destina-se a ser compreendido por humanos. O chamador desse construtor é necessário para garantir que essas cadeias de caracteres tenham sido localizadas para a cultura atual do sistema.

O actualValue parâmetro não é usado na biblioteca de classes do .NET. No entanto, os aplicativos podem usar a ActualValue propriedade para obter o valor do argumento disponível.

O actualValue parâmetro contém o valor inválido que foi passado para o método e fez com que essa exceção fosse gerada. Esse valor é armazenado na ActualValue propriedade e sua representação de cadeia de caracteres é acrescentada à cadeia de caracteres de mensagem mantida na Message propriedade .

A tabela a seguir mostra os valores de propriedade inicial de uma instância de ArgumentOutOfRangeException.

Propriedade	Valor
ActualValue	O valor do argumento.
InnerException	A referência nula (`Nothing` no Visual Basic).
Message	A cadeia de caracteres da mensagem de erro.
ParamName	A cadeia de caracteres do nome do parâmetro.

Aplica-se a

Compartilhar via

ArgumentOutOfRangeException Construtores

Definição

Sobrecargas

ArgumentOutOfRangeException()

Comentários

Aplica-se a

ArgumentOutOfRangeException(String)

Parâmetros

Comentários

Aplica-se a

ArgumentOutOfRangeException(SerializationInfo, StreamingContext)

Parâmetros

Comentários

Confira também

Aplica-se a

ArgumentOutOfRangeException(String, Exception)

Parâmetros

Aplica-se a

ArgumentOutOfRangeException(String, String)

Parâmetros

Comentários

Aplica-se a

ArgumentOutOfRangeException(String, Object, String)

Parâmetros

Comentários

Aplica-se a

Recursos adicionais