ArgumentNullException Klasa

Definicja

Wyjątek zgłaszany, gdy odwołanie o wartości null (Nothingw Visual Basic) jest przekazywane do metody, która nie akceptuje jej jako prawidłowy argument.

public ref class ArgumentNullException : ArgumentException
public class ArgumentNullException : ArgumentException
[System.Serializable]
public class ArgumentNullException : ArgumentException
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class ArgumentNullException : ArgumentException
type ArgumentNullException = class
    inherit ArgumentException
[<System.Serializable>]
type ArgumentNullException = class
    inherit ArgumentException
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ArgumentNullException = class
    inherit ArgumentException
Public Class ArgumentNullException
Inherits ArgumentException
Dziedziczenie
ArgumentNullException
Dziedziczenie
Atrybuty

Uwagi

Wyjątek ArgumentNullException jest zgłaszany, gdy wywoływana jest metoda i co najmniej jeden z przekazanych argumentów jest null , ale nigdy nie powinien być null.

Wyjątek ArgumentNullException jest zgłaszany w czasie wykonywania w następujących dwóch głównych okolicznościach, z których oba odzwierciedlają błąd dewelopera:

  • Nieinstantowany obiekt jest przekazywany do metody. Aby zapobiec błędowi, utwórz wystąpienie obiektu.

  • Obiekt zwrócony z wywołania metody jest następnie przekazywany jako argument do drugiej metody, ale wartość oryginalnego zwróconego obiektu to null. Aby zapobiec błędowi, sprawdź wartość null zwracaną i wywołaj drugą metodę tylko wtedy, gdy wartość zwracana nie nulljest .

ArgumentNullException zachowuje się identycznie z ArgumentException. Jest on dostarczany tak, aby kod aplikacji mógł rozróżniać wyjątki spowodowane argumentami null i wyjątkami spowodowanymi przez argumenty, które nie mają wartości null. W przypadku błędów spowodowanych argumentami, które nie mają wartości null, zobacz ArgumentOutOfRangeException.

ArgumentNullException używa E_POINTER HRESULT, który ma wartość 0x80004003.

Aby uzyskać listę początkowych wartości właściwości dla wystąpienia programu ArgumentNullException, zobacz ArgumentNullException konstruktory.

Konstruktory

ArgumentNullException()

Inicjuje nowe wystąpienie klasy ArgumentNullException.

ArgumentNullException(SerializationInfo, StreamingContext)

Inicjuje nowe wystąpienie klasy ArgumentNullException z zserializowanymi danymi.

ArgumentNullException(String)

Inicjuje nowe wystąpienie ArgumentNullException klasy o nazwie parametru, który powoduje ten wyjątek.

ArgumentNullException(String, Exception)

Inicjuje nowe wystąpienie ArgumentNullException klasy z określonym komunikatem o błędzie i wyjątkiem, który jest przyczyną tego wyjątku.

ArgumentNullException(String, String)

Inicjuje wystąpienie ArgumentNullException klasy z określonym komunikatem o błędzie i nazwą parametru, który powoduje ten wyjątek.

Właściwości

Data

Pobiera kolekcję par klucz/wartość, które zapewniają dodatkowe informacje zdefiniowane przez użytkownika dotyczące wyjątku.

(Odziedziczone po Exception)
HelpLink

Pobiera lub ustawia link do pliku pomocy skojarzonego z tym wyjątkiem.

(Odziedziczone po Exception)
HResult

Pobiera lub ustawia HRESULT, zakodowaną wartość liczbową przypisaną do określonego wyjątku.

(Odziedziczone po Exception)
InnerException

Exception Pobiera wystąpienie, które spowodowało bieżący wyjątek.

(Odziedziczone po Exception)
Message

Pobiera komunikat o błędzie i nazwę parametru lub tylko komunikat o błędzie, jeśli nie ustawiono nazwy parametru.

(Odziedziczone po ArgumentException)
ParamName

Pobiera nazwę parametru, który powoduje ten wyjątek.

(Odziedziczone po ArgumentException)
Source

Pobiera lub ustawia nazwę aplikacji lub obiektu, który powoduje błąd.

(Odziedziczone po Exception)
StackTrace

Pobiera reprezentację ciągu natychmiastowych ramek w stosie wywołań.

(Odziedziczone po Exception)
TargetSite

Pobiera metodę, która zgłasza bieżący wyjątek.

(Odziedziczone po Exception)

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetBaseException()

Po przesłonięciu w klasie pochodnej funkcja zwraca Exception główną przyczynę co najmniej jednego kolejnego wyjątku.

(Odziedziczone po Exception)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetObjectData(SerializationInfo, StreamingContext)

SerializationInfo Ustawia obiekt z nazwą parametru i dodatkowymi informacjami o wyjątku.

(Odziedziczone po ArgumentException)
GetType()

Pobiera typ środowiska uruchomieniowego bieżącego wystąpienia.

(Odziedziczone po Exception)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ThrowIfNull(Object, String)

Zgłasza wartość ArgumentNullException , jeśli argument ma wartość null.

ThrowIfNull(Void*, String)

Zgłasza wartość ArgumentNullException , jeśli argument ma wartość null.

ToString()

Tworzy i zwraca reprezentację ciągu bieżącego wyjątku.

(Odziedziczone po Exception)

Zdarzenia

SerializeObjectState
Nieaktualne.

Występuje, gdy wyjątek jest serializowany w celu utworzenia obiektu stanu wyjątku zawierającego serializowane dane o wyjątku.

(Odziedziczone po Exception)

Dotyczy

Zobacz też