NullReferenceException Klasse

Referenz

Definition

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

public ref class NullReferenceException : Exception

public ref class NullReferenceException : SystemException

public class NullReferenceException : Exception

public class NullReferenceException : SystemException

[System.Serializable]
public class NullReferenceException : SystemException

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class NullReferenceException : SystemException

type NullReferenceException = class
    inherit Exception

type NullReferenceException = class
    inherit SystemException

[<System.Serializable>]
type NullReferenceException = class
    inherit SystemException

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type NullReferenceException = class
    inherit SystemException

Public Class NullReferenceException
Inherits Exception

Public Class NullReferenceException
Inherits SystemException

Vererbung: Object

Exception
NullReferenceException

Vererbung: Object

Exception

SystemException
NullReferenceException

Attribute: SerializableAttribute ComVisibleAttribute

Hinweise

Eine NullReferenceException Ausnahme wird ausgelöst, wenn Sie versuchen, auf ein Element auf einen Typ zuzugreifen, dessen Wert lautet null. Eine NullReferenceException Ausnahme spiegelt den Entwicklerfehler in der Regel wider und wird in den folgenden Szenarien ausgelöst:

Sie haben vergessen, einen Referenztyp zu instanziieren. Im folgenden Beispiel names wird jedoch nie instanziiert:

using System;
using System.Collections.Generic;

public class Example
{
   public static void Main(string[] args)
   {
      int value = Int32.Parse(args[0]);
      List<String> names;
      if (value > 0)
         names = new List<String>();

      names.Add("Major Major Major");
   }
}
// Compilation displays a warning like the following:
//    Example1.cs(10) : warning BC42104: Variable //names// is used before it
//    has been assigned a value. A null reference exception could result
//    at runtime.
//
//          names.Add("Major Major Major")
//          ~~~~~
// The example displays output like the following output:
//    Unhandled Exception: System.NullReferenceException: Object reference
//    not set to an instance of an object.
//       at Example.Main()

open System

[<EntryPoint>]
let main args =
    let value = Int32.Parse args[0]
    // Set names to null, don't initialize it. 
    let mutable names = Unchecked.defaultof<ResizeArray<string>>
    if value > 0 then
        names <- ResizeArray()
    names.Add "Major Major Major"
    0
// Compilation does not display a warning as this is an extremely rare occurance in F#.
// Creating a value without initalizing either requires using 'null' (not possible
// on types defined in F# without [<AllowNullLiteral>]) or Unchecked.defaultof.
//
// The example displays output like the following output:
//    Unhandled Exception: System.NullReferenceException: Object reference
//    not set to an instance of an object.
//       at Example.main()

Imports System.Collections.Generic

Module Example
   Public Sub Main()
      Dim names As List(Of String)
      names.Add("Major Major Major")       
   End Sub
End Module
' Compilation displays a warning like the following:
'    Example1.vb(10) : warning BC42104: Variable 'names' is used before it 
'    has been assigned a value. A null reference exception could result 
'    at runtime.
'    
'          names.Add("Major Major Major")
'          ~~~~~
' The example displays output like the following output:
'    Unhandled Exception: System.NullReferenceException: Object reference 
'    not set to an instance of an object.
'       at Example.Main()

Einige Compiler geben eine Warnung aus, wenn sie diesen Code kompilieren. Andere Stellen einen Fehler aus, und die Kompilierung schlägt fehl. Um dieses Problem zu beheben, instanziieren Sie das Objekt so, dass ihr Wert nicht mehr nullist. Im folgenden Beispiel wird dies durch Aufrufen des Klassenkonstruktors eines Typs ausgeführt.

using System;
using System.Collections.Generic;

public class Example
{
   public static void Main()
   {
      List<String> names = new List<String>();
      names.Add("Major Major Major");
   }
}

let names = ResizeArray()
names.Add "Major Major Major"

Imports System.Collections.Generic

Module Example
   Public Sub Main()
      Dim names As New List(Of String)()
      names.Add("Major Major Major")       
   End Sub
End Module

Sie haben vergessen, ein Array zu dimensionieren, bevor Sie es initialisieren. Im folgenden Beispiel wird ein ganzzahliges Array deklariert, aber die Anzahl der Elemente, die sie enthält, values wird nie angegeben. Der Versuch, seine Werte zu initialisieren, löst daher eine NullReferenceException Ausnahme aus.

using System;

public class Example
{
   public static void Main()
   {
       int[] values = null;
       for (int ctr = 0; ctr <= 9; ctr++)
          values[ctr] = ctr * 2;

       foreach (var value in values)
          Console.WriteLine(value);
   }
}
// The example displays the following output:
//    Unhandled Exception:
//       System.NullReferenceException: Object reference not set to an instance of an object.
//       at Example.Main()

let values: int[] = null
for i = 0 to 9 do
    values[i] <- i * 2

for value in values do
    printfn $"{value}"
// The example displays the following output:
//    Unhandled Exception:
//       System.NullReferenceException: Object reference not set to an instance of an object.
//       at <StartupCode$fs>.main()

Module Example
   Public Sub Main()
       Dim values() As Integer
       For ctr As Integer = 0 To 9
          values(ctr) = ctr * 2
       Next
          
       For Each value In values
          Console.WriteLine(value)
       Next      
   End Sub
End Module
' The example displays the following output:
'    Unhandled Exception: 
'       System.NullReferenceException: Object reference not set to an instance of an object.
'       at Example.Main()

Sie können die Ausnahme entfernen, indem Sie die Anzahl der Elemente im Array deklarieren, bevor Sie sie initialisieren, wie im folgenden Beispiel.

using System;

public class Example
{
   public static void Main()
   {
       int[] values = new int[10];
       for (int ctr = 0; ctr <= 9; ctr++)
          values[ctr] = ctr * 2;

       foreach (var value in values)
          Console.WriteLine(value);
   }
}
// The example displays the following output:
//    0
//    2
//    4
//    6
//    8
//    10
//    12
//    14
//    16
//    18

let values = Array.zeroCreate<int> 10
for i = 0 to 9 do
    values[i] <- i * 2

for value in values do
    printfn $"{value}"
// The example displays the following output:
//    0
//    2
//    4
//    6
//    8
//    10
//    12
//    14
//    16
//    18

Module Example
   Public Sub Main()
       Dim values(9) As Integer
       For ctr As Integer = 0 To 9
          values(ctr) = ctr * 2
       Next
          
       For Each value In values
          Console.WriteLine(value)
       Next      
   End Sub
End Module
' The example displays the following output:
'    0
'    2
'    4
'    6
'    8
'    10
'    12
'    14
'    16
'    18

Weitere Informationen zum Deklarieren und Initialisieren von Arrays finden Sie unter Arrays und Arrays.

Sie erhalten einen Null-Rückgabewert aus einer Methode, und rufen Sie dann eine Methode für den zurückgegebenen Typ auf. Dies ist manchmal das Ergebnis eines Dokumentationsfehlers; Die Dokumentation kann nicht beachten, dass ein Methodenaufruf zurückgegeben nullwerden kann. In anderen Fällen wird der Code falsch davon ausgegangen, dass die Methode immer einen Nicht-Null-Wert zurückgibt.

Der Code im folgenden Beispiel geht davon aus, dass die Array.Find Methode Person immer ein Objekt zurückgibt, dessen FirstName Feld einer Suchzeichenfolge entspricht. Da es keine Übereinstimmung gibt, löst die Laufzeit eine NullReferenceException Ausnahme aus.

using System;

public class Example
{
   public static void Main()
   {
      Person[] persons = Person.AddRange( new String[] { "Abigail", "Abra",
                                          "Abraham", "Adrian", "Ariella",
                                          "Arnold", "Aston", "Astor" } );
      String nameToFind = "Robert";
      Person found = Array.Find(persons, p => p.FirstName == nameToFind);
      Console.WriteLine(found.FirstName);
   }
}

public class Person
{
   public static Person[] AddRange(String[] firstNames)
   {
      Person[] p = new Person[firstNames.Length];
      for (int ctr = 0; ctr < firstNames.Length; ctr++)
         p[ctr] = new Person(firstNames[ctr]);

      return p;
   }

   public Person(String firstName)
   {
      this.FirstName = firstName;
   }

   public String FirstName;
}
// The example displays the following output:
//       Unhandled Exception: System.NullReferenceException:
//       Object reference not set to an instance of an object.
//          at Example.Main()

open System

type Person(firstName) =
    member _.FirstName = firstName

    static member AddRange(firstNames) =
        Array.map Person firstNames

let persons = 
    [| "Abigail"; "Abra"; "Abraham"; "Adrian"
       "Ariella"; "Arnold"; "Aston"; "Astor" |]
    |> Person.AddRange

let nameToFind = "Robert"
let found = Array.Find(persons, fun p -> p.FirstName = nameToFind)

printfn $"{found.FirstName}"

// The example displays the following output:
//       Unhandled Exception: System.NullReferenceException:
//       Object reference not set to an instance of an object.
//          at <StartupCode$fs>.main()

Module Example
   Public Sub Main()
      Dim persons() As Person = Person.AddRange( { "Abigail", "Abra",
                                                   "Abraham", "Adrian",
                                                   "Ariella", "Arnold", 
                                                   "Aston", "Astor" } )    
      Dim nameToFind As String = "Robert"
      Dim found As Person = Array.Find(persons, Function(p) p.FirstName = nameToFind)
      Console.WriteLine(found.FirstName)
   End Sub
End Module

Public Class Person
   Public Shared Function AddRange(firstNames() As String) As Person()
      Dim p(firstNames.Length - 1) As Person
      For ctr As Integer = 0 To firstNames.Length - 1
         p(ctr) = New Person(firstNames(ctr))
      Next   
      Return p
   End Function
   
   Public Sub New(firstName As String)
      Me.FirstName = firstName
   End Sub 
   
   Public FirstName As String
End Class
' The example displays the following output:
'       Unhandled Exception: System.NullReferenceException: 
'       Object reference not set to an instance of an object.
'          at Example.Main()

Um dieses Problem zu beheben, testen Sie den Rückgabewert der Methode, um sicherzustellen, dass es nicht null vor dem Aufrufen eines seiner Member erfolgt, wie im folgenden Beispiel.

using System;

public class Example
{
   public static void Main()
   {
      Person[] persons = Person.AddRange( new String[] { "Abigail", "Abra",
                                          "Abraham", "Adrian", "Ariella",
                                          "Arnold", "Aston", "Astor" } );
      String nameToFind = "Robert";
      Person found = Array.Find(persons, p => p.FirstName == nameToFind);
      if (found != null)
         Console.WriteLine(found.FirstName);
      else
         Console.WriteLine("{0} not found.", nameToFind);
   }
}

public class Person
{
   public static Person[] AddRange(String[] firstNames)
   {
      Person[] p = new Person[firstNames.Length];
      for (int ctr = 0; ctr < firstNames.Length; ctr++)
         p[ctr] = new Person(firstNames[ctr]);

      return p;
   }

   public Person(String firstName)
   {
      this.FirstName = firstName;
   }

   public String FirstName;
}
// The example displays the following output:
//        Robert not found

open System

[<AllowNullLiteral>]
type Person(firstName) =
    member _.FirstName = firstName

    static member AddRange(firstNames) =
        Array.map Person firstNames

let persons = 
    [| "Abigail"; "Abra"; "Abraham"; "Adrian"
       "Ariella"; "Arnold"; "Aston"; "Astor" |]
    |> Person.AddRange

let nameToFind = "Robert"
let found = Array.Find(persons, fun p -> p.FirstName = nameToFind)

if found <> null then
    printfn $"{found.FirstName}"
else 
    printfn $"{nameToFind} not found."

// Using F#'s Array.tryFind function
// This does not require a null check or [<AllowNullLiteral>]
let found2 = 
    persons |> Array.tryFind (fun p -> p.FirstName = nameToFind)

match found2 with
| Some firstName ->
    printfn $"{firstName}"
| None ->
    printfn $"{nameToFind} not found."

// The example displays the following output:
//        Robert not found.
//        Robert not found.

Module Example
   Public Sub Main()
      Dim persons() As Person = Person.AddRange( { "Abigail", "Abra",
                                                   "Abraham", "Adrian",
                                                   "Ariella", "Arnold", 
                                                   "Aston", "Astor" } )    
      Dim nameToFind As String = "Robert"
      Dim found As Person = Array.Find(persons, Function(p) p.FirstName = nameToFind)
      If found IsNot Nothing Then
         Console.WriteLine(found.FirstName)
      Else
         Console.WriteLine("{0} not found.", nameToFind)
      End If   
   End Sub
End Module

Public Class Person
   Public Shared Function AddRange(firstNames() As String) As Person()
      Dim p(firstNames.Length - 1) As Person
      For ctr As Integer = 0 To firstNames.Length - 1
         p(ctr) = New Person(firstNames(ctr))
      Next   
      Return p
   End Function
   
   Public Sub New(firstName As String)
      Me.FirstName = firstName
   End Sub 
   
   Public FirstName As String
End Class
' The example displays the following output:
'       Robert not found

Sie verwenden einen Ausdruck (z. B. verketten Sie eine Liste von Methoden oder Eigenschaften zusammen), um einen Wert abzurufen und obwohl Sie überprüfen, ob der Wert nullist, löst die Laufzeit weiterhin eine NullReferenceException Ausnahme aus. Dies tritt auf, da eine der Zwischenwerte im Ausdruck zurückgegeben wird null. Daher wird ihr Test nie null ausgewertet.

Im folgenden Beispiel wird ein Pages Objekt definiert, das Informationen zu Webseiten zwischenspeichert, die von Page Objekten dargestellt werden. Die Example.Main Methode überprüft, ob die aktuelle Webseite einen Nicht-NULL-Titel aufweist und wenn dies der Fall ist, den Titel anzeigt. Trotz dieser Überprüfung löst die Methode jedoch eine NullReferenceException Ausnahme aus.

using System;

public class Example
{
   public static void Main()
   {
      var pages = new Pages();
      if (! String.IsNullOrEmpty(pages.CurrentPage.Title)) {
         String title = pages.CurrentPage.Title;
         Console.WriteLine("Current title: '{0}'", title);
      }
   }
}

public class Pages
{
   Page[] page = new Page[10];
   int ctr = 0;

   public Page CurrentPage
   {
      get { return page[ctr]; }
      set {
         // Move all the page objects down to accommodate the new one.
         if (ctr > page.GetUpperBound(0)) {
            for (int ndx = 1; ndx <= page.GetUpperBound(0); ndx++)
               page[ndx - 1] = page[ndx];
         }
         page[ctr] = value;
         if (ctr < page.GetUpperBound(0))
            ctr++;
      }
   }

   public Page PreviousPage
   {
      get {
         if (ctr == 0) {
            if (page[0] == null)
               return null;
            else
               return page[0];
         }
         else {
            ctr--;
            return page[ctr + 1];
         }
      }
   }
}

public class Page
{
   public Uri URL;
   public String Title;
}
// The example displays the following output:
//    Unhandled Exception:
//       System.NullReferenceException: Object reference not set to an instance of an object.
//       at Example.Main()

open System

type Page() =
    [<DefaultValue>]
    val mutable public URL: Uri
    [<DefaultValue>]
    val mutable public Title: string

type Pages() =
    let pages = Array.zeroCreate<Page> 10
    let mutable i = 0

    member _.CurrentPage
        with get () = pages[i]
        and set (value) =
            // Move all the page objects down to accommodate the new one.
            if i > pages.GetUpperBound 0 then
                for ndx = 1 to pages.GetUpperBound 0 do
                    pages[ndx - 1] <- pages[ndx]

            pages[i] <- value
            if i < pages.GetUpperBound 0 then
                i <- i + 1

    member _.PreviousPage =
        if i = 0 then
            if box pages[0] = null then
                Unchecked.defaultof<Page>
            else
                pages[0]
        else
            i <- i - 1
            pages[i + 1]

let pages = Pages()
if String.IsNullOrEmpty pages.CurrentPage.Title |> not then
    let title = pages.CurrentPage.Title
    printfn $"Current title: '{title}'"


// The example displays the following output:
//    Unhandled Exception:
//       System.NullReferenceException: Object reference not set to an instance of an object.
//       at <StartupCode$fs>.main()

Module Example
   Public Sub Main()
      Dim pages As New Pages()
      Dim title As String = pages.CurrentPage.Title
   End Sub
End Module

Public Class Pages 
   Dim page(9) As Page
   Dim ctr As Integer = 0
   
   Public Property CurrentPage As Page
      Get
         Return page(ctr)
      End Get
      Set
         ' Move all the page objects down to accommodate the new one.
         If ctr > page.GetUpperBound(0) Then
            For ndx As Integer = 1 To page.GetUpperBound(0)
               page(ndx - 1) = page(ndx)
            Next
         End If    
         page(ctr) = value
         If ctr < page.GetUpperBound(0) Then ctr += 1 
      End Set
   End Property
   
   Public ReadOnly Property PreviousPage As Page
      Get
         If ctr = 0 Then 
            If page(0) Is Nothing Then
               Return Nothing
            Else
               Return page(0)
            End If   
         Else
            ctr -= 1
            Return page(ctr + 1)
         End If
      End Get
   End Property         
End Class

Public Class Page
   Public URL As Uri
   Public Title As String
End Class
' The example displays the following output:
'    Unhandled Exception: 
'       System.NullReferenceException: Object reference not set to an instance of an object.
'       at Example.Main()

Die Ausnahme wird ausgelöst, da pages.CurrentPage keine null Seiteninformationen im Cache gespeichert werden. Diese Ausnahme kann korrigiert werden, indem Sie den Wert der CurrentPage Eigenschaft testen, bevor Sie die Eigenschaft des aktuellen Page Objekts Title abrufen, wie im folgenden Beispiel:

using System;

public class Example
{
   public static void Main()
   {
      var pages = new Pages();
      Page current = pages.CurrentPage;
      if (current != null) {
         String title = current.Title;
         Console.WriteLine("Current title: '{0}'", title);
      }
      else {
         Console.WriteLine("There is no page information in the cache.");
      }
   }
}
// The example displays the following output:
//       There is no page information in the cache.

let pages = Pages()
let current = pages.CurrentPage
if box current <> null then
    let title = current.Title
    printfn $"Current title: '{title}'"
else
    printfn "There is no page information in the cache."
// The example displays the following output:
//       There is no page information in the cache.

Module Example
   Public Sub Main()
      Dim pages As New Pages()
      Dim current As Page = pages.CurrentPage
      If current IsNot Nothing Then 
         Dim title As String = current.Title
         Console.WriteLine("Current title: '{0}'", title)
      Else
         Console.WriteLine("There is no page information in the cache.")
      End If   
   End Sub
End Module
' The example displays the following output:
'       There is no page information in the cache.

Sie werden die Elemente eines Arrays aufzählen, das Referenztypen enthält, und Der Versuch, eine der Elemente zu verarbeiten, löst eine NullReferenceException Ausnahme aus.

Im folgenden Beispiel wird ein Zeichenfolgenarray definiert. Eine for Anweisung enumeiert die Elemente im Array und ruft die Methode der einzelnen Zeichenfolgen auf, bevor die Zeichenfolge Trim angezeigt wird.

using System;

public class Example
{
   public static void Main()
   {
      String[] values = { "one", null, "two" };
      for (int ctr = 0; ctr <= values.GetUpperBound(0); ctr++)
         Console.Write("{0}{1}", values[ctr].Trim(),
                       ctr == values.GetUpperBound(0) ? "" : ", ");
      Console.WriteLine();
   }
}
// The example displays the following output:
//    Unhandled Exception:
//       System.NullReferenceException: Object reference not set to an instance of an object.
//       at Example.Main()

open System

let values = [| "one"; null; "two" |]
for i = 0 to values.GetUpperBound 0 do
    printfn $"""{values[i].Trim()}{if i = values.GetUpperBound 0 then "" else ", "}"""
printfn ""
// The example displays the following output:
//    Unhandled Exception:
//       System.NullReferenceException: Object reference not set to an instance of an object.
//       at <StartupCode$fs>.main()

Module Example
   Public Sub Main()
      Dim values() As String = { "one", Nothing, "two" }
      For ctr As Integer = 0 To values.GetUpperBound(0)
         Console.Write("{0}{1}", values(ctr).Trim(), 
                       If(ctr = values.GetUpperBound(0), "", ", ")) 
      Next
      Console.WriteLine()
   End Sub
End Module
' The example displays the following output:
'    Unhandled Exception: System.NullReferenceException: 
'       Object reference not set to an instance of an object.
'       at Example.Main()

Diese Ausnahme tritt auf, wenn Sie davon ausgehen, dass jedes Element des Arrays einen Nicht-Null-Wert enthalten muss, und der Wert des Arrayelements ist tatsächlich null. Die Ausnahme kann entfernt werden, indem Sie testen, ob das Element vor dem Ausführen eines Vorgangs auf diesem Element null ausgeführt wird, wie im folgenden Beispiel gezeigt.

using System;

public class Example
{
   public static void Main()
   {
      String[] values = { "one", null, "two" };
      for (int ctr = 0; ctr <= values.GetUpperBound(0); ctr++)
         Console.Write("{0}{1}",
                       values[ctr] != null ? values[ctr].Trim() : "",
                       ctr == values.GetUpperBound(0) ? "" : ", ");
      Console.WriteLine();
   }
}
// The example displays the following output:
//       one, , two

open System

let values = [| "one"; null; "two" |]
for i = 0 to values.GetUpperBound 0 do
    printf $"""{if values[i] <> null then values[i].Trim() else ""}{if i = values.GetUpperBound 0 then "" else ", "}"""
Console.WriteLine()
// The example displays the following output:
//       one, , two

Module Example
   Public Sub Main()
      Dim values() As String = { "one", Nothing, "two" }
      For ctr As Integer = 0 To values.GetUpperBound(0)
         Console.Write("{0}{1}", 
                       If(values(ctr) IsNot Nothing, values(ctr).Trim(), ""), 
                       If(ctr = values.GetUpperBound(0), "", ", ")) 
      Next
      Console.WriteLine()
   End Sub
End Module
' The example displays the following output:
'       one, , two

Eine NullReferenceException Ausnahme wird von einer Methode ausgelöst, die übergeben nullwird. Einige Methoden überprüfen die Argumente, die an sie übergeben werden. Wenn sie tun und eine der Argumente lautet null, löst die Methode eine System.ArgumentNullException Ausnahme aus. Andernfalls wird eine NullReferenceException Ausnahme ausgelöst. Dies wird im folgenden Beispiel veranschaulicht.

using System;
using System.Collections.Generic;

public class Example
{
   public static void Main()
   {
      List<String> names = GetData();
      PopulateNames(names);
   }

   private static void PopulateNames(List<String> names)
   {
      String[] arrNames = { "Dakota", "Samuel", "Nikita",
                            "Koani", "Saya", "Yiska", "Yumaevsky" };
      foreach (var arrName in arrNames)
         names.Add(arrName);
   }

   private static List<String> GetData()
   {
      return null;
   }
}
// The example displays output like the following:
//    Unhandled Exception: System.NullReferenceException: Object reference
//    not set to an instance of an object.
//       at Example.PopulateNames(List`1 names)
//       at Example.Main()

let populateNames (names: ResizeArray<string>) =
    let arrNames =
        [ "Dakota"; "Samuel"; "Nikita"
          "Koani"; "Saya"; "Yiska"; "Yumaevsky" ]
    for arrName in arrNames do
        names.Add arrName

let getData () : ResizeArray<string> =
    null

let names = getData ()
populateNames names

// The example displays output like the following:
//    Unhandled Exception: System.NullReferenceException: Object reference
//    not set to an instance of an object.
//       at Example.PopulateNames(List`1 names)
//       at <StartupCode$fs>.main()

Imports System.Collections.Generic

Module Example
   Public Sub Main()
      Dim names As List(Of String) = GetData()
      PopulateNames(names)
   End Sub
   
   Private Sub PopulateNames(names As List(Of String))
      Dim arrNames() As String = { "Dakota", "Samuel", "Nikita",
                                   "Koani", "Saya", "Yiska", "Yumaevsky" }
      For Each arrName In arrNames
         names.Add(arrName)
      Next
   End Sub
   
   Private Function GetData() As List(Of String)
      Return Nothing   
   End Function
End Module
' The example displays output like the following:
'    Unhandled Exception: System.NullReferenceException: Object reference 
'    not set to an instance of an object.
'       at Example.PopulateNames(List`1 names)
'       at Example.Main()

Um dieses Problem zu beheben, stellen Sie sicher, dass das an die Methode übergebene Argument nicht nullist, oder behandeln Sie die ausgelöste Ausnahme in einem try…catch…finally Block. Weitere Informationen finden Sie unter Ausnahmendefiniert sind.

Die folgenden MSIL-Anweisungen (Microsoft Zwischensprache) werden ausgelöstNullReferenceException: callvirt, initblk``cpobj``ldfld``ldflda``ldelema``ldind.<type>``ldlen``ldelem.<type>``cpblk``stfld``stind.<type>``stelem.<type>``throwund .unbox

NullReferenceException verwendet die HRESULT-COR_E_NULLREFERENCE, die den Wert 0x80004003 hat.

Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz von NullReferenceException, finden Sie unter den NullReferenceException Konstruktoren.

Behandeln von NullReferenceException im Releasecode

Es ist normalerweise besser, eine NullReferenceException zu vermeiden, als sie nach dem Auftreten zu behandeln. Die Behandlung von Ausnahmen kann die Wartbarkeit und Lesbarkeit Ihres Codes erschweren und gelegentlich sogar zu neuen Problemen führen. NullReferenceExceptions sind oftmals nicht behebbare Fehler. In diesen Fällen macht es oft Sinn, wenn die Ausnahme die Anwendung beenden kann.

Oft ist es jedoch auch möglich, den Fehler auf sinnvolle Art zu behandeln.

Ihre Anwendung kann Objekte ignorieren, die null sind. Wenn Ihre Anwendung Einträge in einer Datenbank abruft und verarbeitet, können Sie z. B. ungültige Einträge ignorieren, die zu Nullobjekten führen. Möglicherweise reicht es aus, die ungültigen Daten in einer Protokolldatei oder der Anwendungs-GUI aufzuzeichnen.
Sie können nach einer Ausnahme fortfahren. Ein Aufruf eines Webdiensts, der einen Verweistyp zurückgibt, kann z. B. null zurückgeben, wenn die Verbindung verloren geht oder die Verbindungszeit deaktiviert ist. Sie können versuchen, die Verbindung neu zu erstellen und den Anruf erneut zu versuchen.
Sie können Ihre Anwendung zurück in einen gültigen Status versetzen. Wenn Sie z. B. eine Aufgabe mit mehreren Schritten ausführen, die Informationen in einem Datenspeicher ablegen muss, bevor eine Methode aufgerufen wird, die eine NullReferenceException zurückgibt. Wenn das nicht initialisierte Objekt den Datensatz ungültig machen würde, können Sie z. B. die vorherigen Daten entfernen, bevor Sie die Anwendung schließen.
Sie möchten die Ausnahme melden. Wenn beispielsweise der Fehler durch einen Fehler des Benutzers Ihrer App verursacht wurde, können Sie eine Nachricht generieren, um ihnen dabei zu helfen, die richtigen Informationen zu liefern. Außerdem können Sie Informationen über den Fehler protokollieren, um bei der Korrektur des Problems zu helfen. Einige Frameworks, wie ASP.NET, verfügen über einen hohen Ausnahmehandler, der alle Fehler aufzeichnet, damit die Anwendung nie abstürzt. In diesem Fall kann die Protokollierung der Ausnahme möglicherweise die einzige Möglichkeit sein, damit Sie wissen, dass sie auftritt.

Konstruktoren

NullReferenceException()	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.
NullReferenceException(SerializationInfo, StreamingContext)	Initialisiert eine neue Instanz der NullReferenceException-Klasse mit serialisierten Daten.
NullReferenceException(String)	Initialisiert eine neue Instanz der NullReferenceException-Klasse mit einer angegebenen Fehlermeldung.
NullReferenceException(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.

Eigenschaften

Data	Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zur Ausnahme bereitstellen. (Geerbt von Exception)
HelpLink	Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest. (Geerbt von Exception)
HResult	Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist. (Geerbt von Exception)
InnerException	Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat. (Geerbt von Exception)
Message	Ruft eine Meldung ab, mit der die aktuelle Ausnahme beschrieben wird. (Geerbt von Exception)
Source	Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest. (Geerbt von Exception)
StackTrace	Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab. (Geerbt von Exception)
TargetSite	Ruft die Methode ab, die die aktuelle Ausnahme auslöst. (Geerbt von Exception)

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetBaseException()	Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die Grundursache für eine oder mehrere nachfolgende Ausnahmen ist. (Geerbt von Exception)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetObjectData(SerializationInfo, StreamingContext)	Legt beim Überschreiben in einer abgeleiteten Klasse die SerializationInfo mit Informationen über die Ausnahme fest. (Geerbt von Exception)
GetType()	Ruft den Laufzeittyp der aktuellen Instanz ab. (Geerbt von Exception)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Erstellt eine Zeichenfolgendarstellung der aktuellen Ausnahme und gibt diese zurück. (Geerbt von Exception)

Ereignisse

SerializeObjectState

Veraltet.

Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt mit serialisierten Daten über die Ausnahme zu erstellen.

(Geerbt von Exception)

Gilt für: