ArgumentOutOfRangeException Construtores
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Inicializa uma nova instância da ArgumentOutOfRangeException classe.
Sobrecargas
| Name | Description |
|---|---|
| ArgumentOutOfRangeException() |
Inicializa uma nova instância da ArgumentOutOfRangeException classe. |
| ArgumentOutOfRangeException(String) |
Inicializa uma nova instância da ArgumentOutOfRangeException classe com o nome do parâmetro que causa esta 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 ArgumentOutOfRangeException classe.
public:
ArgumentOutOfRangeException();public ArgumentOutOfRangeException();Public Sub New ()Observações
Este construtor inicializa a Message propriedade da nova instância numa mensagem fornecida pelo sistema que descreve o erro, como "Número não negativo necessário." Esta mensagem tem em conta a cultura atual do sistema.
A tabela seguinte mostra os valores iniciais das propriedades para uma instância de ArgumentOutOfRangeException.
| Property | Value |
|---|---|
| InnerException | Uma referência nula (Nothing em Visual Basic). |
| Message | A cadeia de mensagens de erro localizadas. |
Aplica-se a
ArgumentOutOfRangeException(String)
Inicializa uma nova instância da ArgumentOutOfRangeException classe com o nome do parâmetro que causa esta 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 esta exceção.
Observações
Este construtor inicializa a Message propriedade da nova instância numa mensagem fornecida pelo sistema que descreve o erro, como "Número não negativo necessário." Esta mensagem tem em conta a cultura atual do sistema.
Este construtor inicializa a ParamName propriedade da nova instância usando o paramName parâmetro. O conteúdo de paramName destina-se a ser compreendido pelos humanos.
A tabela seguinte mostra os valores iniciais das propriedades para uma instância de ArgumentOutOfRangeException.
| Property | Value |
|---|---|
| InnerException | Uma referência nula (Nothing em Visual Basic). |
| Message | A corda vazia (""). |
| ParamName | O nome do parâmetro string. |
Aplica-se a
ArgumentOutOfRangeException(SerializationInfo, StreamingContext)
Atenção
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 destino dos dados serializados.
- Atributos
Observações
Este construtor é chamado durante a desserialização para reconstituir o objeto exceção transmitido através de um fluxo. Para mais informações, consulte XML e Serialização SOAP.
Ver 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 a razão desta exceção.
- innerException
- Exception
A exceção que é a causa da exceção atual, ou uma referência nula (Nothing em Visual Basic) se não for especificada nenhuma exceção interna.
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.
Observações
Este 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 pelos humanos. O chamador deste construtor é obrigado a garantir que esta cadeia foi localizada para a cultura do sistema atual.
Este construtor inicializa a ParamName propriedade da nova instância usando o paramName parâmetro. O conteúdo de paramName destina-se a ser compreendido pelos humanos.
A tabela seguinte mostra os valores iniciais das propriedades para uma instância de ArgumentOutOfRangeException.
| Property | Value |
|---|---|
| InnerException |
null. |
| Message | A cadeia de mensagens de erro. |
| ParamName | O nome do parâmetro string. |
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 esta exceção.
- message
- String
A mensagem que descreve o erro.
Observações
Este 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 pelos humanos. O chamador deste construtor é obrigado a garantir que estas strings foram localizadas para a cultura do sistema atual.
O parâmetro actualValue não é utilizado na biblioteca de classes .NET. No entanto, as aplicações podem usar a ActualValue propriedade para obter o valor de argumento disponível.
O actualValue parâmetro contém o valor inválido que foi passado ao método e causou a lançamento dessa exceção. Este valor é armazenado na ActualValue propriedade e a sua representação da cadeia é anexada à cadeia de mensagens mantida na Message propriedade.
A tabela seguinte mostra os valores iniciais das propriedades para uma instância de ArgumentOutOfRangeException.
| Property | Value |
|---|---|
| ActualValue | O valor do argumento. |
| InnerException | A referência nula (Nothing em Visual Basic). |
| Message | A cadeia de mensagens de erro. |
| ParamName | O nome do parâmetro string. |
