ArgumentException Constructores

  • Referencia

Definición

Espacio de nombres:
System
Ensamblado:
System.Runtime.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.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
Source:
ArgumentException.cs
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.

Se aplica a

ArgumentException(String)

Source:
ArgumentException.cs
Source:
ArgumentException.cs
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);
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.

Se aplica a

ArgumentException(SerializationInfo, StreamingContext)

Source:
ArgumentException.cs
Source:
ArgumentException.cs
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);
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);
new ArgumentException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ArgumentException
[<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

Se aplica a

ArgumentException(String, Exception)

Source:
ArgumentException.cs
Source:
ArgumentException.cs
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);
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

Se aplica a

ArgumentException(String, String)

Source:
ArgumentException.cs
Source:
ArgumentException.cs
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);
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.

Se aplica a

ArgumentException(String, String, Exception)

Source:
ArgumentException.cs
Source:
ArgumentException.cs
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);
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

Se aplica a