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 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
- 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śćnullzwracaną i wywołaj drugą metodę tylko wtedy, gdy wartość zwracana nienulljest .
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 |
| 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 |
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) |