ArgumentNullException Sınıf

Tanım

Bir null başvuru (Visual BasicNothing) geçerli bir bağımsız değişken olarak kabul etmayan bir yönteme geçirildiğinde oluşturulan özel durum.The exception that is thrown when a null reference (Nothing in Visual Basic) is passed to a method that does not accept it as a valid argument.

public ref class ArgumentNullException : ArgumentException
public class ArgumentNullException : ArgumentException
[System.Serializable]
public class ArgumentNullException : ArgumentException
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class ArgumentNullException : ArgumentException
type ArgumentNullException = class
    inherit ArgumentException
Public Class ArgumentNullException
Inherits ArgumentException
Devralma
ArgumentNullException
Devralma
Öznitelikler

Açıklamalar

Bir yöntem çağrıldığında ve geçilen bağımsız değişkenlerden en az biri null, ancak hiçbir zaman nullolmaması durumunda ArgumentNullException bir özel durum oluşur.An ArgumentNullException exception is thrown when a method is invoked and at least one of the passed arguments is null but should never be null.

Her ikisi de geliştirici hatasını yansıtan aşağıdaki iki ana koşulda çalışma zamanında bir ArgumentNullException özel durum oluşturulur:An ArgumentNullException exception is thrown at run time in the following two major circumstances, both of which reflect developer error:

  • Örneği oluşturulmuş bir nesne yöntemine geçirilir.An uninstantiated object is passed to a method. Hatayı engellemek için, nesneyi örneğini oluşturun.To prevent the error, instantiate the object.

  • Bir yöntem çağrısından döndürülen bir nesne ikinci bir yönteme bir bağımsız değişken olarak geçirilir, ancak özgün döndürülen nesnenin değeri null.An object returned from a method call is then passed as an argument to a second method, but the value of the original returned object is null. Hatayı engellemek için null bir dönüş değeri denetleyin ve yalnızca dönüş değeri nulldeğilse ikinci yöntemi çağırın.To prevent the error, check for a return value that is null and call the second method only if the return value is not null.

ArgumentNullException ArgumentExceptionaynı şekilde davranır.ArgumentNullException behaves identically to ArgumentException. Uygulama kodu, null bağımsız değişkenlerin neden olduğu özel durumlar ve null olmayan bağımsız değişkenlerin neden olduğu özel durumlar arasında ayrım yapabilmesi için sağlanır.It is provided so that application code can differentiate between exceptions caused by null arguments and exceptions caused by arguments that are not null. Null olmayan bağımsız değişkenlerden kaynaklanan hatalar için bkz. ArgumentOutOfRangeException.For errors caused by arguments that are not null, see ArgumentOutOfRangeException.

ArgumentNullException, 0x80004003 değerine sahip olan HRESULT E_POINTER kullanır.ArgumentNullException uses the HRESULT E_POINTER, which has the value 0x80004003.

Bir ArgumentNullExceptionörneğine ilişkin ilk özellik değerlerinin listesi için, ArgumentNullException oluşturuculara bakın.For a list of initial property values for an instance of ArgumentNullException, see the ArgumentNullException constructors.

Oluşturucular

ArgumentNullException()

ArgumentNullException sınıfının yeni bir örneğini başlatır.Initializes a new instance of the ArgumentNullException class.

ArgumentNullException(SerializationInfo, StreamingContext)

ArgumentNullException sınıfının yeni bir örneğini serileştirilmiş verilerle başlatır.Initializes a new instance of the ArgumentNullException class with serialized data.

ArgumentNullException(String)

Bu özel duruma neden olan parametrenin adı ile ArgumentNullException sınıfının yeni bir örneğini başlatır.Initializes a new instance of the ArgumentNullException class with the name of the parameter that causes this exception.

ArgumentNullException(String, Exception)

Belirtilen bir hata iletisi ve bu özel durumun nedeni olan özel durum ile ArgumentNullException sınıfının yeni bir örneğini başlatır.Initializes a new instance of the ArgumentNullException class with a specified error message and the exception that is the cause of this exception.

ArgumentNullException(String, String)

Belirtilen bir hata iletisiyle ArgumentNullException sınıfının bir örneğini ve bu özel duruma neden olan parametrenin adını başlatır.Initializes an instance of the ArgumentNullException class with a specified error message and the name of the parameter that causes this exception.

Özellikler

Data

Özel durum hakkında ek kullanıcı tanımlı bilgiler sağlayan anahtar/değer çiftleri koleksiyonunu alır.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Devralındığı yer: Exception)
HelpLink

Bu özel durumla ilişkili Yardım dosyasının bağlantısını alır veya ayarlar.Gets or sets a link to the help file associated with this exception.

(Devralındığı yer: Exception)
HResult

Belirli bir özel duruma atanan kodlanmış bir sayısal değer olan HRESULT 'yi alır veya ayarlar.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Devralındığı yer: Exception)
InnerException

Geçerli özel duruma neden olan Exception örneğini alır.Gets the Exception instance that caused the current exception.

(Devralındığı yer: Exception)
Message

Hata iletisini ve parametre adını ya da parametre adı ayarlanmamışsa yalnızca hata iletisini alır.Gets the error message and the parameter name, or only the error message if no parameter name is set.

(Devralındığı yer: ArgumentException)
ParamName

Bu özel duruma neden olan parametrenin adını alır.Gets the name of the parameter that causes this exception.

(Devralındığı yer: ArgumentException)
Source

Uygulamanın veya hataya neden olan nesnenin adını alır veya ayarlar.Gets or sets the name of the application or the object that causes the error.

(Devralındığı yer: Exception)
StackTrace

Çağrı yığınında anlık çerçevelerin dize gösterimini alır.Gets a string representation of the immediate frames on the call stack.

(Devralındığı yer: Exception)
TargetSite

Geçerli özel durumu oluşturan yöntemi alır.Gets the method that throws the current exception.

(Devralındığı yer: Exception)

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneyle eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
GetBaseException()

Türetilmiş bir sınıfta geçersiz kılınırsa, bir veya daha fazla sonraki özel durumun kök nedeni olan Exception döndürür.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Devralındığı yer: Exception)
GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

(Devralındığı yer: Object)
GetObjectData(SerializationInfo, StreamingContext)

SerializationInfo nesnesini parametre adı ve ek özel durum bilgileri ile ayarlar.Sets the SerializationInfo object with the parameter name and additional exception information.

(Devralındığı yer: ArgumentException)
GetType()

Geçerli örneğin çalışma zamanı türünü alır.Gets the runtime type of the current instance.

(Devralındığı yer: Exception)
MemberwiseClone()

Geçerli Objectbasit bir kopyasını oluşturur.Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
ToString()

Geçerli özel durumun dize gösterimini oluşturur ve döndürür.Creates and returns a string representation of the current exception.

(Devralındığı yer: Exception)

Ekinlikler

SerializeObjectState

Özel durum hakkında serileştirilmiş veri içeren bir özel durum nesnesi oluşturmak için bir özel durum serileştirildiğinde gerçekleşir.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Devralındığı yer: Exception)

Şunlara uygulanır

Ayrıca bkz.