NullReferenceException Klasse
TOC
Inhaltsverzeichnis reduzieren
Inhaltsverzeichnis erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

NullReferenceException-Klasse

 

Die Ausnahme, die bei einem Versuch ausgelöst wird, einen Verweis auf ein NULL-Objekt zu dereferenzieren.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

System.Object
  System.Exception
    System.SystemException
      System.NullReferenceException

[<SerializableAttribute>]
[<ComVisibleAttribute(true)>]
type NullReferenceException = 
    class
        inherit SystemException
    end

NameBeschreibung
System_CAPS_pubmethodNullReferenceException()

Initialisiert eine neue Instanz der NullReferenceException-Klasse. Dabei wird die Message-Eigenschaft der neuen Instanz auf eine vom System gelieferte Meldung festgelegt, die den Fehler beschreibt, z. B. "Der Wert 'null' wurde gefunden, als eine Objektinstanz erforderlich war". Diese Meldung berücksichtigt die aktuelle Systemkultur.

System_CAPS_protmethodNullReferenceException(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der NullReferenceException-Klasse mit serialisierten Daten.

System_CAPS_pubmethodNullReferenceException(String)

Initialisiert eine neue Instanz der NullReferenceException-Klasse mit einer angegebenen Fehlermeldung.

System_CAPS_pubmethodNullReferenceException(String, Exception)

Initialisiert eine neue Instanz der NullReferenceException-Klasse mit einer angegebenen Fehlermeldung und einem Verweis auf die innere Ausnahme, die diese Ausnahme ausgelöst hat.

NameBeschreibung
System_CAPS_pubpropertyData

Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen über die Ausnahme bereitstellen.(Geerbt von Exception.)

System_CAPS_pubpropertyHelpLink

Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest.(Geerbt von Exception.)

System_CAPS_pubpropertyHResult

Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist.(Geerbt von Exception.)

System_CAPS_pubpropertyInnerException

Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat.(Geerbt von Exception.)

System_CAPS_pubpropertyMessage

Ruft eine Meldung ab, die die aktuelle Ausnahme beschreibt.(Geerbt von Exception.)

System_CAPS_pubpropertySource

Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest.(Geerbt von Exception.)

System_CAPS_pubpropertyStackTrace

Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab.(Geerbt von Exception.)

System_CAPS_pubpropertyTargetSite

Ruft die Methode ab, die die aktuelle Ausnahme auslöst.(Geerbt von Exception.)

NameBeschreibung
System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von Object.)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von Object.)

System_CAPS_pubmethodGetBaseException()

Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die ursprüngliche Ursache für eine oder mehrere nachfolgende Ausnahmen ist.(Geerbt von Exception.)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion. (Geerbt von Object.)

System_CAPS_pubmethodGetObjectData(SerializationInfo, StreamingContext)

Legt beim Überschreiben in einer abgeleiteten Klasse die SerializationInfo mit Informationen über die Ausnahme fest.(Geerbt von Exception.)

System_CAPS_pubmethodGetType()

Ruft den Laufzeittyp der aktuellen Instanz ab.(Geerbt von Exception.)

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von Object.)

System_CAPS_pubmethodToString()

Erstellt eine Zeichenfolgendarstellung der aktuellen Ausnahme und gibt diese zurück.(Geerbt von Exception.)

NameBeschreibung
System_CAPS_proteventSerializeObjectState

Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt zu erstellen, das serialisierte Daten für die Ausnahme enthält.(Geerbt von Exception.)

A NullReferenceException exception is thrown when you try to access a member on a type whose value is null.A NullReferenceException exception typically reflects developer error and is thrown in the following scenarios:

  • You've forgotten to instantiate a reference type.In the following example, names is declared but never instantiated:

    Derzeit ist kein Code Beispiel verfügbar, oder die Sprache wird nicht unterstützt.

    Some compilers issue a warning when they compile this code.Others issue an error, and the compilation fails.To address this problem, instantiate the object so that its value is no longer null.The following example does this by calling a type's class constructor.

    Derzeit ist kein Code Beispiel verfügbar, oder die Sprache wird nicht unterstützt.
  • You get a null return value from a method, and then call a method on the returned type.This sometimes is the result of a documentation error; the documentation fails to note that a method call can return null.In other cases, your code erroneously assumes that the method will always return a non-null value.

    The code in the following example assumes that the Array.Find<'T> method always returns Person object whose FirstName field matches a search string.Because there is no match, the runtime throws a NullReferenceException exception.

    Derzeit ist kein Code Beispiel verfügbar, oder die Sprache wird nicht unterstützt.

    To address this problem, test the method's return value to ensure that it is not null before calling any of its members, as the following example does.

    Derzeit ist kein Code Beispiel verfügbar, oder die Sprache wird nicht unterstützt.
  • A NullReferenceException exception is thrown by a method that is passed null.Some methods validate the arguments that are passed to them.If they do and one of the arguments is null, the method throws an System.ArgumentNullException exception.Otherwise, it throws a NullReferenceException exception.The following example illustrates this scenario.

    Derzeit ist kein Code Beispiel verfügbar, oder die Sprache wird nicht unterstützt.

    Um dieses Problem zu lösen, vergewissern Sie sich, dass das Argument, welches an die Methode übergebenen wird, nicht ein Nullverweis (Nothing in Visual Basic) ist, oder verarbeiten Sie die Ausnahme in einem try…catch…finally-Block. For more information, see Handling and Throwing Exceptions.

The following Microsoft intermediate language (MSIL) instructions throw NullReferenceException: callvirt, cpblk, cpobj, initblk, ldelem.<type>, ldelema, ldfld, ldflda, ldind.<type>, ldlen, stelem.<type>, stfld, stind.<type>, throw, and unbox.

NullReferenceException uses the HRESULT COR_E_NULLREFERENCE, which has the value 0x80004003.

For a list of initial property values for an instance of NullReferenceException, see the NullReferenceException constructors.

Universal Windows Platform
Verfügbar seit 4.5
.NET Framework
Verfügbar seit 1.1
Portable Class Library
Unterstützt in: portable .NET platforms
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1

Öffentliche statische (in Visual Basic freigegebene) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Zurück zum Anfang
Anzeigen:
© 2016 Microsoft