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
| Nome | Description |
|---|---|
| ArgumentOutOfRangeException() |
Inicializa uma nova instância da classe ArgumentOutOfRangeException. |
| ArgumentOutOfRangeException(String) |
Inicializa uma nova instância da ArgumentOutOfRangeException classe com o nome do parâmetro que causa essa exceção. |
| ArgumentOutOfRangeException(SerializationInfo, StreamingContext) |
Obsoleto.
Inicializa uma nova instância da ArgumentOutOfRangeException classe com dados serializados. |
| ArgumentOutOfRangeException(String, Exception) |
Inicializa uma nova instância da ArgumentOutOfRangeException classe com uma mensagem de erro especificada e a exceção que é a causa dessa exceção. |
| ArgumentOutOfRangeException(String, String) |
Inicializa uma nova instância da ArgumentOutOfRangeException classe 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 ArgumentOutOfRangeException classe 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ãonegativo necessário". Essa mensagem leva em conta a cultura atual do sistema.
A tabela a seguir mostra os valores de propriedade iniciais de uma instância de ArgumentOutOfRangeException.
| Propriedade | Valor |
|---|---|
| InnerException | Uma referência nula (Nothing no Visual Basic). |
| Message | A cadeia de caracteres de mensagem de erro localizada. |
Aplica-se a
ArgumentOutOfRangeException(String)
Inicializa uma nova instância da ArgumentOutOfRangeException classe 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ãonegativo 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 é paramName destinado a ser compreendido pelos humanos.
A tabela a seguir mostra os valores de propriedade iniciais 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 de 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 ArgumentOutOfRangeException classe com dados serializados.
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);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}")>]
new ArgumentOutOfRangeException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ArgumentOutOfRangeExceptionnew 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 contém os dados do objeto serializado.
- context
- StreamingContext
Um objeto que descreve a origem ou o destino dos dados serializados.
- Atributos
Comentários
Esse construtor é chamado durante a desserialização para reconstituir o objeto de exceção transmitido por um fluxo. Para obter mais informações, consulte de serialização XML e SOAP.
Confira também
Aplica-se a
ArgumentOutOfRangeException(String, Exception)
Inicializa uma nova instância da ArgumentOutOfRangeException classe com uma mensagem de erro especificada e a exceção que é a causa dessa 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 o motivo dessa 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 for especificada.
Aplica-se a
ArgumentOutOfRangeException(String, String)
Inicializa uma nova instância da ArgumentOutOfRangeException classe 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 message parâmetro destina-se a ser compreendido por humanos. O chamador desse construtor é necessário para garantir que essa cadeia de caracteres tenha sido localizada para a cultura atual do sistema.
Esse construtor inicializa a ParamName propriedade da nova instância usando o paramName parâmetro. O conteúdo é paramName destinado a ser compreendido pelos humanos.
A tabela a seguir mostra os valores de propriedade iniciais de uma instância de ArgumentOutOfRangeException.
| Propriedade | Valor |
|---|---|
| InnerException |
null. |
| Message | A cadeia de caracteres de mensagem de erro. |
| ParamName | A cadeia de caracteres de nome do parâmetro. |
Aplica-se a
ArgumentOutOfRangeException(String, Object, String)
Inicializa uma nova instância da ArgumentOutOfRangeException classe 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 que usa o actualValue parâmetro e a Message propriedade usando o message parâmetro. O conteúdo do e message dos paramName parâmetros 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 iniciais 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 de mensagem de erro. |
| ParamName | A cadeia de caracteres de nome do parâmetro. |
