ArgumentException Constructores

Definición

Espacio de nombres:

System

Ensamblados:

netstandard.dll, System.Runtime.dll

Inicializa una nueva instancia de la clase ArgumentException.

Sobrecargas

Nombre	Description
ArgumentException()	Inicializa una nueva instancia de la clase ArgumentException.
ArgumentException(String)	Inicializa una nueva instancia de la ArgumentException clase con un mensaje de error especificado.
ArgumentException(SerializationInfo, StreamingContext)	Obsoletos. Inicializa una nueva instancia de la ArgumentException clase con datos serializados.
ArgumentException(String, Exception)	Inicializa una nueva instancia de la ArgumentException clase con un mensaje de error especificado y una referencia a la excepción interna que es la causa de esta excepción.
ArgumentException(String, String)	Inicializa una nueva instancia de la ArgumentException clase 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 ArgumentException clase con un mensaje de error especificado, el nombre del parámetro y una referencia a la excepción interna que es 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 de una instancia de ArgumentException.

Propiedad	Importancia
InnerException	Referencia nula (Nothing en Visual Basic).
Message	Cadena de mensaje de error localizada.

ArgumentException(String)

Source:

ArgumentException.cs

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

Propiedad	Importancia
InnerException	Referencia nula (Nothing en Visual Basic).
Message	Cadena del 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 ArgumentException clase 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 serializado.

context

StreamingContext

Información contextual sobre el origen o el destino.

Atributos

ObsoleteAttribute

Comentarios

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

Consulte también

• Serialización XML y SOAP

ArgumentException(String, Exception)

Source:

ArgumentException.cs

Inicializa una nueva instancia de la ArgumentException clase con un mensaje de error especificado y una referencia a la excepción interna que es 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 innerException parámetro no es una referencia nula, la excepción actual se genera en un catch bloque que controla la excepción interna.

Comentarios

Este constructor inicializa la Message propiedad de la nueva instancia mediante el valor del message parámetro . El contenido del message parámetro está pensado para ser comprendido por los seres humanos. El autor de la llamada de este constructor es necesario para asegurarse de que esta cadena se ha localizado para la referencia cultural del sistema actual.

Una excepción que se produce como resultado directo de una excepción anterior debe incluir una referencia a la excepción anterior en la InnerException propiedad . La InnerException propiedad devuelve el mismo valor que se pasa al constructor o null si la InnerException propiedad no proporciona el valor de excepción interno al constructor.

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

Propiedad	Importancia
InnerException	Referencia de excepción interna.
Message	Cadena de mensaje de error localizada.

Consulte también

• Exception
• Control y inicio de excepciones

ArgumentException(String, String)

Source:

ArgumentException.cs

Inicializa una nueva instancia de la ArgumentException clase 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 forma parte de un ejemplo más grande proporcionado para la ArgumentException clase .

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 . El contenido del message parámetro está pensado para ser comprendido por los seres humanos. El autor de la llamada de este constructor es necesario para asegurarse de que esta cadena se ha localizado para la referencia cultural del sistema actual.

Este constructor inicializa la ParamName propiedad de la nueva instancia mediante paramName. El contenido de paramName está pensado para ser comprendido por los seres humanos.

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

Propiedad	Importancia
Message	Cadena del mensaje de error.
ParamName	Cadena de nombre de parámetro.

ArgumentException(String, String, Exception)

Source:

ArgumentException.cs

Inicializa una nueva instancia de la ArgumentException clase con un mensaje de error especificado, el nombre del parámetro y una referencia a la excepción interna que es 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 innerException parámetro no es una referencia nula, la excepción actual se genera en un catch bloque que controla la excepción interna.

Comentarios

Este constructor inicializa la Message propiedad de la nueva instancia mediante el valor del message parámetro . El contenido del message parámetro está pensado para ser comprendido por los seres humanos. El autor de la llamada de este constructor es necesario para asegurarse de que esta cadena se ha localizado para la referencia cultural del sistema actual.

Este constructor inicializa la ParamName propiedad de la nueva instancia mediante paramName. El contenido de paramName está pensado para ser comprendido por los seres humanos.

Una excepción que se produce como resultado directo de una excepción anterior debe incluir una referencia a la excepción anterior en la InnerException propiedad . La InnerException propiedad devuelve el mismo valor que se pasa al constructor o null si la InnerException propiedad no proporciona el valor de excepción interno al constructor.

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

Propiedad	Importancia
InnerException	Referencia de excepción interna.
Message	Cadena de mensaje de error localizada.
ParamName	Cadena de nombre de parámetro.

Consulte también

• Exception
• Control y inicio de excepciones