ArgumentNullException Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Wyjątek, który jest zgłaszany, gdy odwołanie o wartości null (Nothing
w Visual Basic) jest przekazywane do metody, która nie akceptuje go 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
- 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 poważnych okolicznościach, z których oba odzwierciedlają błąd dewelopera:
Obiekt bez wystąpienia 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ść zwracaną, która jestnull
i wywołaj drugą metodę tylko wtedy, gdy zwracana wartość nienull
jest .
ArgumentNullException zachowuje się identycznie z ArgumentException. Jest on dostarczany tak, aby kod aplikacji mógł rozróżniać wyjątki spowodowane przez null
argumenty i wyjątki spowodowane 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óra ma wartość 0x80004003.
Aby uzyskać listę początkowych wartości właściwości dla wystąpienia ArgumentNullExceptionprogramu , 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 na 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 |
ThrowIfNull(Void*, String) |
Zgłasza wartość ArgumentNullException , jeśli |
ToString() |
Tworzy i zwraca reprezentację ciągu bieżącego wyjątku. (Odziedziczone po Exception) |
Zdarzenia
SerializeObjectState |
Przestarzałe.
Występuje, gdy wyjątek jest serializowany w celu utworzenia obiektu stanu wyjątku, który zawiera serializowane dane dotyczące wyjątku. (Odziedziczone po Exception) |