ArgumentException Oluşturucular

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

ArgumentException sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

ArgumentException()	ArgumentException sınıfının yeni bir örneğini başlatır.
ArgumentException(String)	Belirtilen hata iletisiyle sınıfının yeni bir örneğini ArgumentException başlatır.
ArgumentException(SerializationInfo, StreamingContext)	Geçersiz. ArgumentException sınıfının yeni bir örneğini serileştirilmiş verilerle başlatır.
ArgumentException(String, Exception)	Belirtilen bir hata iletisi ve bu özel durumun nedeni olan iç özel duruma başvuru ile sınıfının yeni bir örneğini ArgumentException başlatır.
ArgumentException(String, String)	Belirtilen hata iletisi ve bu özel duruma neden olan parametrenin adı ile sınıfının yeni bir örneğini ArgumentException başlatır.
ArgumentException(String, String, Exception)	Sınıfın ArgumentException yeni bir örneğini belirtilen bir hata iletisi, parametre adı ve bu özel durumun nedeni olan iç özel duruma başvuru ile başlatır.

ArgumentException()

Kaynak:

ArgumentException.cs

ArgumentException sınıfının yeni bir örneğini başlatır.

public:
 ArgumentException();

public ArgumentException ();

Public Sub New ()

Açıklamalar

Bu oluşturucu, yeni örneğin özelliğini sistem tarafından sağlanan ve "Geçersiz bir bağımsız değişken belirtildi" gibi hatayı açıklayan bir iletiye başlatır Message . Bu ileti geçerli sistem kültürünü dikkate alır.

Aşağıdaki tablo, ArgumentException öğesinin bir örneği için başlangıç özellik değerlerini gösterir.

Özellik	Değer
InnerException	Null başvuru (Nothing Visual Basic'te).
Message	Yerelleştirilmiş hata ileti dizesi.

ArgumentException(String)

Kaynak:

ArgumentException.cs

Belirtilen hata iletisiyle sınıfının yeni bir örneğini ArgumentException başlatır.

public:
 ArgumentException(System::String ^ message);

public ArgumentException (string? message);

new ArgumentException : string -> ArgumentException

Public Sub New (message As String)

Parametreler

message

String

Özel durumun nedenini açıklayan hata iletisi.

Açıklamalar

Bu oluşturucu, yeni örneğin özelliğini sistem tarafından sağlanan ve "Geçersiz bir bağımsız değişken belirtildi" gibi hatayı açıklayan bir iletiye başlatır Message . Bu ileti geçerli sistem kültürünü dikkate alır.

Aşağıdaki tablo, ArgumentException öğesinin bir örneği için başlangıç özellik değerlerini gösterir.

Özellik	Değer
InnerException	Null başvuru (Nothing Visual Basic'te).
Message	Hata iletisi dizesi.

ArgumentException(SerializationInfo, StreamingContext)

Kaynak:

ArgumentException.cs

Dikkat

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

ArgumentException sınıfının yeni bir örneğini serileştirilmiş verilerle başlatır.

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)

Parametreler

info

SerializationInfo

Serileştirilmiş nesne verilerini tutan nesne.

context

StreamingContext

Kaynak veya hedefle ilgili bağlamsal bilgi.

Öznitelikler

ObsoleteAttribute

Açıklamalar

Bu oluşturucu, bir akış üzerinden iletilen özel durum nesnesini yeniden oluşturmak için seri durumundan çıkarma sırasında çağrılır. Daha fazla bilgi için bkz. XML ve SOAP Serileştirme.

Ayrıca bkz.

• XML ve SOAP Serileştirme

ArgumentException(String, Exception)

Kaynak:

ArgumentException.cs

Belirtilen bir hata iletisi ve bu özel durumun nedeni olan iç özel duruma başvuru ile sınıfının yeni bir örneğini ArgumentException başlatır.

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)

Parametreler

message

String

Özel durumun nedenini açıklayan hata iletisi.

innerException

Exception

Geçerli özel durumun nedeni olan özel durum. innerException Parametre null başvuru değilse, geçerli özel durum iç özel durumu işleyen bir catch blokta oluşturulur.

Açıklamalar

Bu oluşturucu, parametresinin değerini message kullanarak yeni örneğin özelliğini başlatırMessage. parametresinin message içeriği insanlar tarafından anlaşılması amaçlanmıştır. Bu yapıcının çağırıcısı, bu dizenin geçerli sistem kültürü için yerelleştirilmiş olduğundan emin olmak için gereklidir.

Bir önceki özel durumun doğrudan bir sonucu olarak oluşturulan bir özel durum, InnerException özelliğindeki önceki özel duruma başvuru içermelidir. InnerException özelliği, oluşturucuya iletilen aynı değeri ya da InnerException özelliği oluşturucuya iç özel durum değeri sağlamıyorsa null değerini döndürür.

Aşağıdaki tablo, ArgumentException öğesinin bir örneği için başlangıç özellik değerlerini gösterir.

Özellik	Değer
InnerException	İç özel duruma başvuru.
Message	Yerelleştirilmiş hata ileti dizesi.

Ayrıca bkz.

• Exception
• Özel Durumları İşleme ve Oluşturma

ArgumentException(String, String)

Kaynak:

ArgumentException.cs

Belirtilen hata iletisi ve bu özel duruma neden olan parametrenin adı ile sınıfının yeni bir örneğini ArgumentException başlatır.

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)

Parametreler

message

String

Özel durumun nedenini açıklayan hata iletisi.

paramName

String

Geçerli özel duruma neden olan parametrenin adı.

Örnekler

Aşağıdaki kod örneği oluşturucunun nasıl çağrılduğunu ArgumentException gösterir. Bu kod örneği, sınıfı için ArgumentException sağlanan daha büyük bir örneğin parçasıdır.

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;

Açıklamalar

Bu oluşturucu, parametresinin değerini message kullanarak yeni örneğin özelliğini başlatırMessage. parametresinin message içeriği insanlar tarafından anlaşılması amaçlanmıştır. Bu yapıcının çağırıcısı, bu dizenin geçerli sistem kültürü için yerelleştirilmiş olduğundan emin olmak için gereklidir.

Bu oluşturucu kullanarak paramNameyeni örneğin özelliğini başlatırParamName. içeriğinin paramName insanlar tarafından anlaşılması amaçlanmıştır.

Aşağıdaki tablo, ArgumentException öğesinin bir örneği için başlangıç özellik değerlerini gösterir.

Özellik	Değer
Message	Hata iletisi dizesi.
ParamName	Parametre adı dizesi.

ArgumentException(String, String, Exception)

Kaynak:

ArgumentException.cs

Sınıfın ArgumentException yeni bir örneğini belirtilen bir hata iletisi, parametre adı ve bu özel durumun nedeni olan iç özel duruma başvuru ile başlatır.

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)

Parametreler

message

String

Özel durumun nedenini açıklayan hata iletisi.

paramName

String

Geçerli özel duruma neden olan parametrenin adı.

innerException

Exception

Geçerli özel durumun nedeni olan özel durum. innerException Parametre null başvuru değilse, geçerli özel durum iç özel durumu işleyen bir catch blokta oluşturulur.

Açıklamalar

Bu oluşturucu, parametresinin değerini message kullanarak yeni örneğin özelliğini başlatırMessage. parametresinin message içeriği insanlar tarafından anlaşılması amaçlanmıştır. Bu yapıcının çağırıcısı, bu dizenin geçerli sistem kültürü için yerelleştirilmiş olduğundan emin olmak için gereklidir.

Bu oluşturucu kullanarak paramNameyeni örneğin özelliğini başlatırParamName. içeriğinin paramName insanlar tarafından anlaşılması amaçlanmıştır.

Bir önceki özel durumun doğrudan bir sonucu olarak oluşturulan bir özel durum, InnerException özelliğindeki önceki özel duruma başvuru içermelidir. InnerException özelliği, oluşturucuya iletilen aynı değeri ya da InnerException özelliği oluşturucuya iç özel durum değeri sağlamıyorsa null değerini döndürür.

Aşağıdaki tablo, ArgumentException öğesinin bir örneği için başlangıç özellik değerlerini gösterir.

Özellik	Değer
InnerException	İç özel duruma başvuru.
Message	Yerelleştirilmiş hata ileti dizesi.
ParamName	Parametre adı dizesi.

Ayrıca bkz.

• Exception
• Özel Durumları İşleme ve Oluşturma