ArgumentException Constructores

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Inicializa una nueva instancia de la clase ArgumentException.

Sobrecargas

ArgumentException()	Inicializa una nueva instancia de la clase ArgumentException.
ArgumentException(String)	Inicializa una nueva instancia de la clase ArgumentException con el mensaje de error especificado.
ArgumentException(SerializationInfo, StreamingContext)	Obsoletos. Inicializa una nueva instancia de la clase ArgumentException con datos serializados.
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.
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.
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.

ArgumentException()

Source:

ArgumentException.cs

Inicializa una nueva instancia de la clase ArgumentException.

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 especificó un argumento no válido". Este mensaje tiene en cuenta la referencia cultural del sistema actual.

En la tabla siguiente se muestran los valores de propiedad iniciales para una instancia de ArgumentException.

Propiedad	Value
InnerException	Referencia nula (Nothing en Visual Basic).
Message	La cadena del mensaje de error localizado.

ArgumentException(String)

Source:

ArgumentException.cs

Inicializa una nueva instancia de la clase ArgumentException con el mensaje de error especificado.

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.

Comentarios

Este constructor inicializa la Message propiedad de la nueva instancia en un mensaje proporcionado por el sistema que describe el error, como "Se especificó un argumento no válido". Este mensaje tiene en cuenta la referencia cultural del sistema actual.

En la tabla siguiente se muestran los valores de propiedad iniciales para una instancia de ArgumentException.

Propiedad	Value
InnerException	Referencia nula (Nothing en Visual Basic).
Message	Cadena con el mensaje de error.

ArgumentException(SerializationInfo, StreamingContext)

Source:

ArgumentException.cs

Precaución

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Inicializa una nueva instancia de la clase ArgumentException con datos serializados.

protected:
 ArgumentException(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 ArgumentException (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 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.

context

StreamingContext

Información contextual acerca del origen o del destino.

Atributos

ObsoleteAttribute

Comentarios

Se llama a este constructor durante la deserialización para reconstituir el objeto de excepción transmitido en un flujo. Para obtener más información, consulte Serialización XML y SOAP.

Consulte también

• Serialización SOAP y XML

ArgumentException(String, Exception)

Source:

ArgumentException.cs

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.

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.

innerException

Exception

Excepción que es la causa de la excepción actual. 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.

Comentarios

Este constructor inicializa la Message propiedad de la nueva instancia mediante el valor del message parámetro . Se pretende que el contenido del parámetro message sea inteligible. El autor de llamada de este constructor debe asegurarse de que esta cadena se ha adaptado para la referencia cultural del sistema actual.

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. 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.

En la tabla siguiente se muestran los valores de propiedad iniciales para una instancia de ArgumentException.

Propiedad	Valor
InnerException	Referencia a la excepción interna.
Message	La cadena del mensaje de error localizado.

Consulte también

• Exception
• Controlar y generar excepciones

ArgumentException(String, String)

Source:

ArgumentException.cs

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.

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.

paramName

String

Nombre del parámetro que provocó la excepción actual.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar al ArgumentException constructor . Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase ArgumentException.

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;
}

let divideByTwo num =
    // If num is an odd number, raise an ArgumentException.
    if num % 2 = 1 then
        raise (ArgumentException("num", "Number must be even"))

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

Comentarios

Este constructor inicializa la Message propiedad de la nueva instancia mediante el valor del message parámetro . Se pretende que el contenido del parámetro message sea inteligible. El autor de llamada de este constructor debe asegurarse de que esta cadena se ha adaptado para la referencia cultural del sistema actual.

Este constructor inicializa la ParamName propiedad de la nueva instancia mediante paramName. Se pretende que el contenido de paramName sea inteligible.

En la tabla siguiente se muestran los valores de propiedad iniciales para una instancia de ArgumentException.

Propiedad	Value
Message	Cadena con el mensaje de error.
ParamName	Cadena de nombre de parámetro.

ArgumentException(String, String, Exception)

Source:

ArgumentException.cs

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.

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.

paramName

String

Nombre del parámetro que provocó la excepción actual.

innerException

Exception

Excepción que es la causa de la excepción actual. 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.

Comentarios

Este constructor inicializa la Message propiedad de la nueva instancia mediante el valor del message parámetro . Se pretende que el contenido del parámetro message sea inteligible. El autor de llamada de este constructor debe asegurarse de que esta cadena se ha adaptado para la referencia cultural del sistema actual.

Este constructor inicializa la ParamName propiedad de la nueva instancia mediante paramName. Se pretende que el contenido de paramName sea inteligible.

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. 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.

En la tabla siguiente se muestran los valores de propiedad iniciales para una instancia de ArgumentException.

Propiedad	Valor
InnerException	Referencia a la excepción interna.
Message	La cadena del mensaje de error localizado.
ParamName	Cadena de nombre de parámetro.

Consulte también

• Exception
• Controlar y generar excepciones