ArgumentOutOfRangeException Construtores
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.
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()
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)
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 -> ArgumentOutOfRangeExceptionPublic 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 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.
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)
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 -> ArgumentOutOfRangeExceptionProtected 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
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
Aplica-se a
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.
public:
ArgumentOutOfRangeException(System::String ^ message, Exception ^ innerException);public ArgumentOutOfRangeException (string message, Exception innerException);public ArgumentOutOfRangeException (string? message, Exception? innerException);new ArgumentOutOfRangeException : string * Exception -> ArgumentOutOfRangeExceptionPublic 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)
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 -> ArgumentOutOfRangeExceptionPublic 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)
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 -> ArgumentOutOfRangeExceptionPublic 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. |
