ArgumentException ArgumentException ArgumentException ArgumentException Constructors

Definição

Sobrecargas

ArgumentException() ArgumentException() ArgumentException()

Inicializa uma nova instância da classe ArgumentException.Initializes a new instance of the ArgumentException class.

ArgumentException(String) ArgumentException(String) ArgumentException(String) ArgumentException(String)

Inicializa uma nova instância da classe ArgumentException com uma mensagem de erro especificada.Initializes a new instance of the ArgumentException class with a specified error message.

ArgumentException(SerializationInfo, StreamingContext) ArgumentException(SerializationInfo, StreamingContext) ArgumentException(SerializationInfo, StreamingContext) ArgumentException(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe ArgumentException com dados serializados.Initializes a new instance of the ArgumentException class with serialized data.

ArgumentException(String, Exception) ArgumentException(String, Exception) ArgumentException(String, Exception) ArgumentException(String, Exception)

Inicializa uma nova instância da classe ArgumentException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção.Initializes a new instance of the ArgumentException class with a specified error message and a reference to the inner exception that is the cause of this exception.

ArgumentException(String, String) ArgumentException(String, String) ArgumentException(String, String) ArgumentException(String, String)

Inicializa uma nova instância da classe ArgumentException com uma mensagem de erro especificada e o nome do parâmetro que causa essa exceção.Initializes a new instance of the ArgumentException class with a specified error message and the name of the parameter that causes this exception.

ArgumentException(String, String, Exception) ArgumentException(String, String, Exception) ArgumentException(String, String, Exception) ArgumentException(String, String, Exception)

Inicializa uma nova instância da classe ArgumentException com uma mensagem de erro especificada, o nome do parâmetro e uma referência à exceção interna que é a causa dessa exceção.Initializes a new instance of the ArgumentException class with a specified error message, the parameter name, and a reference to the inner exception that is the cause of this exception.

ArgumentException() ArgumentException() ArgumentException()

Inicializa uma nova instância da classe ArgumentException.Initializes a new instance of the ArgumentException class.

public:
 ArgumentException();
public ArgumentException ();
Public Sub New ()

Comentários

Este construtor inicializa o Message propriedade da nova instância para uma mensagem fornecida pelo sistema que descreve o erro, por exemplo, "um argumento inválido foi especificado."This constructor initializes the Message property of the new instance to a system-supplied message that describes the error, such as "An invalid argument was specified." Esta mensagem leva em conta a cultura do sistema atual.This message takes into account the current system culture.

A tabela a seguir mostra os valores de propriedade iniciais para uma instância de ArgumentException.The following table shows the initial property values for an instance of ArgumentException.

PropriedadeProperty ValorValue
InnerException Uma referência nula (Nothing no Visual Basic).A null reference (Nothing in Visual Basic).
Message A cadeia de caracteres da mensagem de erro localizada.The localized error message string.

ArgumentException(String) ArgumentException(String) ArgumentException(String) ArgumentException(String)

Inicializa uma nova instância da classe ArgumentException com uma mensagem de erro especificada.Initializes a new instance of the ArgumentException class with a specified error message.

public:
 ArgumentException(System::String ^ message);
public ArgumentException (string message);
new ArgumentException : string -> ArgumentException
Public Sub New (message As String)

Parâmetros

message
String String String String

A mensagem de erro que explica a razão da exceção.The error message that explains the reason for the exception.

Comentários

Este construtor inicializa o Message propriedade da nova instância para uma mensagem fornecida pelo sistema que descreve o erro, por exemplo, "um argumento inválido foi especificado."This constructor initializes the Message property of the new instance to a system-supplied message that describes the error, such as "An invalid argument was specified." Esta mensagem leva em conta a cultura do sistema atual.This message takes into account the current system culture.

A tabela a seguir mostra os valores de propriedade iniciais para uma instância de ArgumentException.The following table shows the initial property values for an instance of ArgumentException.

PropriedadeProperty ValorValue
InnerException Uma referência nula (Nothing no Visual Basic).A null reference (Nothing in Visual Basic).
Message A cadeia de caracteres da mensagem de erro.The error message string.

ArgumentException(SerializationInfo, StreamingContext) ArgumentException(SerializationInfo, StreamingContext) ArgumentException(SerializationInfo, StreamingContext) ArgumentException(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe ArgumentException com dados serializados.Initializes a new instance of the ArgumentException class with serialized data.

protected:
 ArgumentException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
protected ArgumentException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new ArgumentException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ArgumentException
Protected Sub New (info As SerializationInfo, context As StreamingContext)

Parâmetros

info
SerializationInfo SerializationInfo SerializationInfo SerializationInfo

O objeto que mantém os dados de objeto serializados.The object that holds the serialized object data.

context
StreamingContext StreamingContext StreamingContext StreamingContext

As informações contextuais sobre a origem ou o destino.The contextual information about the source or destination.

Comentários

Este construtor é chamado durante a desserialização para reconstituir o objeto de exceção transmitido por um fluxo.This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. Para obter mais informações, consulte serialização XML e SOAP.For more information, see XML and SOAP Serialization.

Veja também

ArgumentException(String, Exception) ArgumentException(String, Exception) ArgumentException(String, Exception) ArgumentException(String, Exception)

Inicializa uma nova instância da classe ArgumentException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção.Initializes a new instance of the ArgumentException class with a specified error message and a reference to the inner exception that is the cause of this exception.

public:
 ArgumentException(System::String ^ message, Exception ^ innerException);
public ArgumentException (string message, Exception innerException);
new ArgumentException : string * Exception -> ArgumentException
Public Sub New (message As String, innerException As Exception)

Parâmetros

message
String String String String

A mensagem de erro que explica a razão da exceção.The error message that explains the reason for the exception.

innerException
Exception Exception Exception Exception

A exceção que é a causa da exceção atual.The exception that is the cause of the current exception. Se o parâmetro innerException não for uma referência nula, a exceção atual será gerada em um bloco catch que lida com a exceção interna.If the innerException parameter is not a null reference, the current exception is raised in a catch block that handles the inner exception.

Comentários

Este construtor inicializa o Message propriedade da nova instância usando o valor da message parâmetro.This constructor initializes the Message property of the new instance using the value of the message parameter. O conteúdo do parâmetro message deve ser compreendido por humanos.The content of the message parameter is intended to be understood by humans. O chamador desse construtor é necessário para garantir que essa cadeia de caracteres tenha sido localizada para a cultura do sistema atual.The caller of this constructor is required to ensure that this string has been localized for the current system culture.

Uma exceção que é lançada como um resultado direto de uma exceção anterior deve incluir uma referência para a exceção anterior na propriedade InnerException.An exception that is thrown as a direct result of a previous exception should include a reference to the previous exception in the InnerException property. A propriedade InnerException retorna o mesmo valor que é passado para o construtor, ou null caso a propriedade InnerException não forneça o valor de exceção interno para o construtor.The InnerException property returns the same value that is passed into the constructor, or null if the InnerException property does not supply the inner exception value to the constructor.

A tabela a seguir mostra os valores de propriedade iniciais para uma instância de ArgumentException.The following table shows the initial property values for an instance of ArgumentException.

PropriedadeProperty ValorValue
InnerException A referência de exceção interna.The inner exception reference.
Message A cadeia de caracteres da mensagem de erro localizada.The localized error message string.
Veja também

ArgumentException(String, String) ArgumentException(String, String) ArgumentException(String, String) ArgumentException(String, String)

Inicializa uma nova instância da classe ArgumentException com uma mensagem de erro especificada e o nome do parâmetro que causa essa exceção.Initializes a new instance of the ArgumentException class with a specified error message and the name of the parameter that causes this exception.

public:
 ArgumentException(System::String ^ message, System::String ^ paramName);
public ArgumentException (string message, string paramName);
new ArgumentException : string * string -> ArgumentException
Public Sub New (message As String, paramName As String)

Parâmetros

message
String String String String

A mensagem de erro que explica a razão da exceção.The error message that explains the reason for the exception.

paramName
String String String String

O nome do parâmetro que causou a exceção atual.The name of the parameter that caused the current exception.

Exemplos

O exemplo de código a seguir demonstra como chamar o ArgumentException construtor.The following code example demonstrates how to call the ArgumentException constructor. Este exemplo de código é parte de um exemplo maior fornecido para o ArgumentException classe.This code example is part of a larger example provided for the ArgumentException class.

int DivideByTwo(int num)
{
    // If num is an odd number, throw an ArgumentException.
    if ((num & 1) == 1)
    {
        throw gcnew ArgumentException("Number must be even", "num");
    }
    // num is even, return half of its value.
    return num / 2;
}
static int DivideByTwo(int num) 
{
    // If num is an odd number, throw an ArgumentException.
    if ((num & 1) == 1)
        throw new ArgumentException("Number must be even", "num");

    // num is even, return half of its value.
    return num / 2;
}

Comentários

Este construtor inicializa o Message propriedade da nova instância usando o valor da message parâmetro.This constructor initializes the Message property of the new instance using the value of the message parameter. O conteúdo do parâmetro message deve ser compreendido por humanos.The content of the message parameter is intended to be understood by humans. O chamador desse construtor é necessário para garantir que essa cadeia de caracteres tenha sido localizada para a cultura do sistema atual.The caller of this constructor is required to ensure that this string has been localized for the current system culture.

Este construtor inicializa o ParamName propriedade da nova instância usando paramName.This constructor initializes the ParamName property of the new instance using paramName. O conteúdo de paramName deve ser compreendido por humanos.The content of paramName is intended to be understood by humans.

A tabela a seguir mostra os valores de propriedade iniciais para uma instância de ArgumentException.The following table shows the initial property values for an instance of ArgumentException.

PropriedadeProperty ValorValue
Message A cadeia de caracteres da mensagem de erro.The error message string.
ParamName A cadeia de caracteres do nome do parâmetro.The parameter name string.

ArgumentException(String, String, Exception) ArgumentException(String, String, Exception) ArgumentException(String, String, Exception) ArgumentException(String, String, Exception)

Inicializa uma nova instância da classe ArgumentException com uma mensagem de erro especificada, o nome do parâmetro e uma referência à exceção interna que é a causa dessa exceção.Initializes a new instance of the ArgumentException class with a specified error message, the parameter name, and a reference to the inner exception that is the cause of this exception.

public:
 ArgumentException(System::String ^ message, System::String ^ paramName, Exception ^ innerException);
public ArgumentException (string message, string paramName, Exception innerException);
new ArgumentException : string * string * Exception -> ArgumentException
Public Sub New (message As String, paramName As String, innerException As Exception)

Parâmetros

message
String String String String

A mensagem de erro que explica a razão da exceção.The error message that explains the reason for the exception.

paramName
String String String String

O nome do parâmetro que causou a exceção atual.The name of the parameter that caused the current exception.

innerException
Exception Exception Exception Exception

A exceção que é a causa da exceção atual.The exception that is the cause of the current exception. Se o parâmetro innerException não for uma referência nula, a exceção atual será gerada em um bloco catch que lida com a exceção interna.If the innerException parameter is not a null reference, the current exception is raised in a catch block that handles the inner exception.

Comentários

Este construtor inicializa o Message propriedade da nova instância usando o valor da message parâmetro.This constructor initializes the Message property of the new instance using the value of the message parameter. O conteúdo do parâmetro message deve ser compreendido por humanos.The content of the message parameter is intended to be understood by humans. O chamador desse construtor é necessário para garantir que essa cadeia de caracteres tenha sido localizada para a cultura do sistema atual.The caller of this constructor is required to ensure that this string has been localized for the current system culture.

Este construtor inicializa o ParamName propriedade da nova instância usando paramName.This constructor initializes the ParamName property of the new instance using paramName. O conteúdo de paramName deve ser compreendido por humanos.The content of paramName is intended to be understood by humans.

Uma exceção que é lançada como um resultado direto de uma exceção anterior deve incluir uma referência para a exceção anterior na propriedade InnerException.An exception that is thrown as a direct result of a previous exception should include a reference to the previous exception in the InnerException property. A propriedade InnerException retorna o mesmo valor que é passado para o construtor, ou null caso a propriedade InnerException não forneça o valor de exceção interno para o construtor.The InnerException property returns the same value that is passed into the constructor, or null if the InnerException property does not supply the inner exception value to the constructor.

A tabela a seguir mostra os valores de propriedade iniciais para uma instância de ArgumentException.The following table shows the initial property values for an instance of ArgumentException.

PropriedadeProperty ValorValue
InnerException A referência de exceção interna.The inner exception reference.
Message A cadeia de caracteres da mensagem de erro localizada.The localized error message string.
ParamName A cadeia de caracteres do nome do parâmetro.The parameter name string.
Veja também

Aplica-se a