ArgumentException Constructores

Definición

Inicializa una nueva instancia de la clase ArgumentException.Initializes a new instance of the ArgumentException class.

Sobrecargas

ArgumentException()

Inicializa una nueva instancia de la clase ArgumentException.Initializes a new instance of the ArgumentException class.

ArgumentException(String)

Inicializa una nueva instancia de la clase ArgumentException con el mensaje de error especificado.Initializes a new instance of the ArgumentException class with a specified error message.

ArgumentException(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase ArgumentException con datos serializados.Initializes a new instance of the ArgumentException class with serialized data.

ArgumentException(String, Exception)

Inicializa una nueva instancia de la clase ArgumentException con el mensaje de error especificado y una referencia a la excepción interna que representa la causa de esta excepción.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)

Inicializa una nueva instancia de la clase ArgumentException con un mensaje de error especificado y el nombre del parámetro que provoca esta excepción.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)

Inicializa una nueva instancia de la clase ArgumentException con un mensaje de error especificado, el nombre del parámetro y una referencia a la excepción interna que representa la causa de esta excepción.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()

Inicializa una nueva instancia de la clase ArgumentException.Initializes a new instance of the ArgumentException class.

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

Comentarios

Este constructor inicializa la Message propiedad de la nueva instancia en un mensaje proporcionado por el sistema que describe el error, como "se ha especificado un argumento no válido".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." Este mensaje tiene en cuenta la referencia cultural del sistema actual.This message takes into account the current system culture.

En la tabla siguiente se muestran los valores de propiedad iniciales para una instancia de ArgumentException.The following table shows the initial property values for an instance of ArgumentException.

Propiedad.Property ValorValue
InnerException Referencia nula (Nothing en Visual Basic).A null reference (Nothing in Visual Basic).
Message La cadena del mensaje de error localizado.The localized error message string.

ArgumentException(String)

Inicializa una nueva instancia de la clase ArgumentException con el mensaje de error especificado.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

Mensaje de error que explica el motivo de la excepción.The error message that explains the reason for the exception.

Comentarios

Este constructor inicializa la Message propiedad de la nueva instancia en un mensaje proporcionado por el sistema que describe el error, como "se ha especificado un argumento no válido".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." Este mensaje tiene en cuenta la referencia cultural del sistema actual.This message takes into account the current system culture.

En la tabla siguiente se muestran los valores de propiedad iniciales para una instancia de ArgumentException.The following table shows the initial property values for an instance of ArgumentException.

Propiedad.Property ValorValue
InnerException Referencia nula (Nothing en Visual Basic).A null reference (Nothing in Visual Basic).
Message Cadena con el mensaje de error.The error message string.

ArgumentException(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase ArgumentException con datos 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

Objeto que contiene los datos del objeto serializados.The object that holds the serialized object data.

context
StreamingContext

Información contextual acerca del origen o del destino.The contextual information about the source or destination.

Comentarios

Durante la deserialización se llama a este constructor para reconstituir el objeto de excepción transmitido en una secuencia.This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. Para obtener más información, consulte serialización SOAP y XML.For more information, see XML and SOAP Serialization.

Consulte también:

ArgumentException(String, Exception)

Inicializa una nueva instancia de la clase ArgumentException con el mensaje de error especificado y una referencia a la excepción interna que representa la causa de esta excepción.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

Mensaje de error que explica el motivo de la excepción.The error message that explains the reason for the exception.

innerException
Exception

Excepción que es la causa de la excepción actual.The exception that is the cause of the current exception. Si el parámetro innerException no es una referencia nula, se provoca la excepción actual en un bloque catch que controla la excepción interna.If the innerException parameter is not a null reference, the current exception is raised in a catch block that handles the inner exception.

Comentarios

Este constructor inicializa la Message propiedad de la nueva instancia utilizando el valor message del parámetro.This constructor initializes the Message property of the new instance using the value of the message parameter. Se pretende que el contenido del parámetro message sea inteligible.The content of the message parameter is intended to be understood by humans. El autor de llamada de este constructor debe asegurarse de que la cadena se haya adaptado para la referencia cultural actual del sistema.The caller of this constructor is required to ensure that this string has been localized for the current system culture.

Una excepción que se produce como consecuencia directa de una excepción anterior debe incluir una referencia a esta última en la propiedad 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. La propiedad InnerException devuelve el mismo valor que se haya pasado al constructor, o bien null en caso de que la propiedad InnerException no le haya proporcionado al constructor el valor de la excepción interna.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.

En la tabla siguiente se muestran los valores de propiedad iniciales para una instancia de ArgumentException.The following table shows the initial property values for an instance of ArgumentException.

Propiedad.Property ValorValue
InnerException Referencia a la excepción interna.The inner exception reference.
Message La cadena del mensaje de error localizado.The localized error message string.

Consulte también:

ArgumentException(String, String)

Inicializa una nueva instancia de la clase ArgumentException con un mensaje de error especificado y el nombre del parámetro que provoca esta excepción.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

Mensaje de error que explica el motivo de la excepción.The error message that explains the reason for the exception.

paramName
String

Nombre del parámetro que provocó la excepción actual.The name of the parameter that caused the current exception.

Ejemplos

En el ejemplo de código siguiente se muestra cómo ArgumentException llamar al constructor.The following code example demonstrates how to call the ArgumentException constructor. Este ejemplo de código forma parte de un ejemplo más extenso proporcionado ArgumentException para la clase.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;
}

Comentarios

Este constructor inicializa la Message propiedad de la nueva instancia utilizando el valor message del parámetro.This constructor initializes the Message property of the new instance using the value of the message parameter. Se pretende que el contenido del parámetro message sea inteligible.The content of the message parameter is intended to be understood by humans. El autor de llamada de este constructor debe asegurarse de que la cadena se haya adaptado para la referencia cultural actual del sistema.The caller of this constructor is required to ensure that this string has been localized for the current system culture.

Este constructor inicializa la ParamName propiedad de la nueva instancia de mediante. paramNameThis constructor initializes the ParamName property of the new instance using paramName. Se pretende que el contenido de paramName sea inteligible.The content of paramName is intended to be understood by humans.

En la tabla siguiente se muestran los valores de propiedad iniciales para una instancia de ArgumentException.The following table shows the initial property values for an instance of ArgumentException.

Propiedad.Property ValorValue
Message Cadena con el mensaje de error.The error message string.
ParamName Cadena del nombre del parámetro.The parameter name string.

ArgumentException(String, String, Exception)

Inicializa una nueva instancia de la clase ArgumentException con un mensaje de error especificado, el nombre del parámetro y una referencia a la excepción interna que representa la causa de esta excepción.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

Mensaje de error que explica el motivo de la excepción.The error message that explains the reason for the exception.

paramName
String

Nombre del parámetro que provocó la excepción actual.The name of the parameter that caused the current exception.

innerException
Exception

Excepción que es la causa de la excepción actual.The exception that is the cause of the current exception. Si el parámetro innerException no es una referencia nula, se provoca la excepción actual en un bloque catch que controla la excepción interna.If the innerException parameter is not a null reference, the current exception is raised in a catch block that handles the inner exception.

Comentarios

Este constructor inicializa la Message propiedad de la nueva instancia utilizando el valor message del parámetro.This constructor initializes the Message property of the new instance using the value of the message parameter. Se pretende que el contenido del parámetro message sea inteligible.The content of the message parameter is intended to be understood by humans. El autor de llamada de este constructor debe asegurarse de que la cadena se haya adaptado para la referencia cultural actual del sistema.The caller of this constructor is required to ensure that this string has been localized for the current system culture.

Este constructor inicializa la ParamName propiedad de la nueva instancia de mediante. paramNameThis constructor initializes the ParamName property of the new instance using paramName. Se pretende que el contenido de paramName sea inteligible.The content of paramName is intended to be understood by humans.

Una excepción que se produce como consecuencia directa de una excepción anterior debe incluir una referencia a esta última en la propiedad 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. La propiedad InnerException devuelve el mismo valor que se haya pasado al constructor, o bien null en caso de que la propiedad InnerException no le haya proporcionado al constructor el valor de la excepción interna.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.

En la tabla siguiente se muestran los valores de propiedad iniciales para una instancia de ArgumentException.The following table shows the initial property values for an instance of ArgumentException.

Propiedad.Property ValorValue
InnerException Referencia a la excepción interna.The inner exception reference.
Message La cadena del mensaje de error localizado.The localized error message string.
ParamName Cadena del nombre del parámetro.The parameter name string.

Consulte también:

Se aplica a