NullReferenceException Klass

Definition

Namnområde:: System

Sammansättningar:: mscorlib.dll, System.Runtime.dll

Sammansättning:: mscorlib.dll

Sammansättning:: System.Runtime.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Undantaget som utlöses när det görs ett försök att avrefereras en null-objektreferens.

public ref class NullReferenceException : Exception

public ref class NullReferenceException : SystemException

public class NullReferenceException : Exception

[System.Serializable]
public class NullReferenceException : SystemException

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

public class NullReferenceException : SystemException

type NullReferenceException = class
    inherit Exception

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

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

type NullReferenceException = class
    inherit SystemException

Public Class NullReferenceException
Inherits Exception

Public Class NullReferenceException
Inherits SystemException

Arv: Object

Exception
NullReferenceException

Arv: Object

Exception

SystemException
NullReferenceException

Attribut: SerializableAttribute ComVisibleAttribute

Kommentarer

Ett NullReferenceException undantag utlöses när du försöker komma åt en medlem på en typ vars värde är null. Ett NullReferenceException undantag återspeglar vanligtvis utvecklarfel och utlöses i följande scenarier:

Note

Du kan undvika de flesta NullReferenceException undantag i C# med hjälp av operatorn null-conditional (?.) eller null-coalescing-operatorn (??). För mer information, se nullbara referenstyper. Följande C#-exempel förutsätter att den nullbara kontexten är inaktiverad (rekommenderas inte).

Du har glömt att instansiera en referenstyp. I följande exempel names deklareras men instansieras aldrig (den berörda raden kommenteras ut i C#-exemplet eftersom den inte kompileras):

using System.Collections.Generic;

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

        //names.Add("Major Major Major");
    }
}

// Compilation displays a warning like the following:
//    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 UseBeforeAssignExample.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()

Vissa kompilatorer utfärdar en varning när de kompilerar den här koden. Andra utfärdar ett fel och kompilering misslyckas. Åtgärda problemet genom att instansiera objektet så att dess värde inte längre nullär . Följande exempel gör detta genom att anropa en typs klasskonstruktor.

using System.Collections.Generic;

public class AnotherExample
{
    public static void Main()
    {
        List<string> names = ["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

Du glömde att dimensionera en matris innan du initierade den. I följande exempel values deklareras som en heltalsmatris, men antalet element som den innehåller har aldrig angetts. Försöket att initiera dess värden genererar därför ett NullReferenceException undantag.

int[] values = null;
for (int ctr = 0; ctr <= 9; ctr++)
    values[ctr] = ctr * 2;

foreach (int 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 Array3Example.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()

Du kan eliminera undantaget genom att deklarera antalet element i matrisen innan du initierar det, som i följande exempel.

int[] values = new int[10];
for (int ctr = 0; ctr <= 9; ctr++)
    values[ctr] = ctr * 2;

foreach (int 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

Mer information om hur du deklarerar och initierar matriser finns i Matriser och matriser.

Du får ett null-returvärde från en metod och anropar sedan en metod för den returnerade typen. Detta beror ibland på ett dokumentationsfel. dokumentationen kan inte notera att ett metodanrop kan returnera null. I andra fall förutsätter koden felaktigt att metoden alltid returnerar ett värde som inte är null.

Koden i följande exempel förutsätter att Array.Find metoden alltid returnerar Person objekt vars FirstName fält matchar en söksträng. Eftersom det inte finns någon matchning utlöser körningen ett NullReferenceException undantag.

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

// The example displays the following output:
//       Unhandled Exception: System.NullReferenceException:
//       Object reference not set to an instance of an object.

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()

För att lösa det här problemet testar du metodens returvärde för att se till att det inte null är innan någon av dess medlemmar anropas, som i följande exempel.

public static void ExampleWithNullCheck()
{
    Person[] persons = Person.AddRange([ "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($"'{nameToFind}' not found.");
}

// 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

Du använder ett uttryck (till exempel länkade du en lista med metoder eller egenskaper tillsammans) för att hämta ett värde, och även om du kontrollerar om värdet är nullgenererar körningen fortfarande ett NullReferenceException undantag. Detta beror på att ett av mellanliggande värden i uttrycket returnerar null. Därför utvärderas aldrig ditt test för null .

I följande exempel definieras ett Pages objekt som cachelagrar information om webbsidor som presenteras av Page objekt. Metoden Example.Main kontrollerar om den aktuella webbsidan har en rubrik som inte är null och, om den gör det, visar rubriken. Trots den här kontrollen genererar metoden dock ett NullReferenceException undantag.

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

public class Pages
{
    readonly 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] is 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 Chain1Example.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()

Undantaget genereras eftersom pages.CurrentPage returnerar null om ingen sidinformation lagras i cacheminnet. Det här undantaget kan korrigeras genom att testa värdet för CurrentPage egenskapen innan du hämtar det aktuella Page objektets Title egenskap, som i följande exempel:

var pages = new Pages();
Page current = pages.CurrentPage;
if (current != null)
{
    string title = current.Title;
    Console.WriteLine($"Current title: '{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.

Du räknar upp elementen i en matris som innehåller referenstyper och ditt försök att bearbeta ett av elementen genererar ett NullReferenceException undantag.

I följande exempel definieras en strängmatris. En for instruktion räknar upp elementen i matrisen och anropar varje strängs Trim -metod innan strängen visas.

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.

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()

Det här undantaget inträffar om du antar att varje element i matrisen måste innehålla ett värde som inte är null och värdet för matriselementet i själva verket nullär . Undantaget kan elimineras genom att testa om elementet är null innan någon åtgärd utförs på det elementet, vilket visas i följande exempel.

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

En metod när den kommer åt en medlem i ett av argumenten, men det argumentet är null. Metoden PopulateNames i följande exempel genererar undantaget på raden names.Add(arrName);.

using System.Collections.Generic;

public class NRE2Example
{
    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 (string 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 NRE2Example.PopulateNames(List`1 names)
//       at NRE2Example.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()

Om du vill åtgärda det här problemet kontrollerar du att argumentet som skickas till metoden inte nullär eller hanterar undantaget som genereras i ett try…catch…finally block. Mer information finns i Undantag.

En lista skapas utan att du känner till typen och listan initierades inte. Metoden GetList i följande exempel genererar undantaget på raden emptyList.Add(value).

using System;
using System.Collections.Generic;
using System.Collections;
using System.Runtime.Serialization;

public class NullReferenceExample
{
    public static void Main()
    {
        var listType = GetListType();
        _ = GetList(listType);
    }

    private static Type GetListType()
    {
        return typeof(List<int>);
    }

    private static IList GetList(Type type)
    {
        var emptyList = (IList)FormatterServices.GetUninitializedObject(type); // Does not call list constructor
        var value = 1;
        emptyList.Add(value);
        return emptyList;
    }
}
// The example displays output like the following:
//    Unhandled Exception: System.NullReferenceException: 'Object reference
//    not set to an instance of an object.'
//    at System.Collections.Generic.List`1.System.Collections.IList.Add(Object item)
//    at NullReferenceExample.GetList(Type type): line 24

Åtgärda problemet genom att kontrollera att listan har initierats (ett sätt att göra detta är att anropa Activator.CreateInstance i stället för FormatterServices.GetUninitializedObject) eller hantera undantaget som genereras i ett try…catch…finally block. Mer information finns i Undantag.

Följande instruktioner för Microsoft mellanliggande språk (MSIL) genererar NullReferenceException: callvirt, cpblk, cpobj, initblk, ldelem.<type>, ldelema, ldfld, ldflda, ldind.<type>, ldlen, stelem.<type>, stfld, stind.<type>, throw och unbox.

NullReferenceException använder HRESULT COR_E_NULLREFERENCE, som har värdet 0x80004003.

För en lista över inledande egenskapsvärden för en instans av NullReferenceException, se i NullReferenceException-konstruktorn.

När du ska hantera NullReferenceException-undantag

Det är vanligtvis bättre att undvika en NullReferenceException än att hantera den när den inträffar. Att hantera ett undantag kan göra koden svårare att underhålla och förstå och kan ibland introducera andra buggar. NullReferenceException är ofta ett fel som inte kan återställas. I dessa fall kan det bästa alternativet vara att låta undantaget stoppa appen.

Det finns dock många situationer där hanteringen av felet kan vara användbar:

Din app kan ignorera objekt som är null. Om din app till exempel hämtar och bearbetar poster i en databas kanske du kan ignorera ett antal felaktiga poster som resulterar i null-objekt. Att registrera felaktiga data i en loggfil eller i programmets användargränssnitt kan vara allt du behöver göra.
Du kan återställa från undantaget. Ett anrop till en webbtjänst som returnerar en referenstyp kan till exempel returnera null om anslutningen går förlorad eller om anslutningen överskrids. Du kan försöka återupprätta anslutningen och försöka anropa igen.
Du kan återställa appens tillstånd till ett giltigt tillstånd. Du kanske till exempel utför en uppgift i flera steg som kräver att du sparar information i ett datalager innan du anropar en metod som genererar en NullReferenceException. Om det oinitierade objektet skulle skada dataposten kan du ta bort tidigare data innan du stänger appen.
Du vill rapportera undantaget. Om felet till exempel orsakades av ett misstag från appens användare kan du generera ett meddelande som hjälper dem att ange rätt information. Du kan också logga information om felet som hjälper dig att åtgärda problemet. Vissa ramverk, till exempel ASP.NET, har en undantagshanterare på hög nivå som samlar in alla fel som appen aldrig kraschar. I så fall kan loggning av undantaget vara det enda sättet att veta att det inträffar.

Konstruktorer

Name	Description
NullReferenceException()	Initierar en ny instans av NullReferenceException klassen och anger egenskapen för den nya instansen Message till ett meddelande från systemet som beskriver felet, till exempel "Värdet "null" hittades där en instans av ett objekt krävdes. Det här meddelandet tar hänsyn till den aktuella systemkulturen.
NullReferenceException(SerializationInfo, StreamingContext)	Initierar en ny instans av NullReferenceException klassen med serialiserade data.
NullReferenceException(String, Exception)	Initierar en ny instans av NullReferenceException klassen med ett angivet felmeddelande och en referens till det inre undantaget som är orsaken till det här undantaget.
NullReferenceException(String)	Initierar en ny instans av NullReferenceException klassen med ett angivet felmeddelande.

Egenskaper

Name	Description
Data	Hämtar en samling nyckel/värde-par som ger ytterligare användardefinierad information om undantaget. (Ärvd från Exception)
HelpLink	Hämtar eller anger en länk till hjälpfilen som är associerad med det här undantaget. (Ärvd från Exception)
HResult	Hämtar eller anger HRESULT, ett kodat numeriskt värde som har tilldelats ett specifikt undantag. (Ärvd från Exception)
InnerException	Hämtar den Exception instans som orsakade det aktuella undantaget. (Ärvd från Exception)
Message	Hämtar ett meddelande som beskriver det aktuella undantaget. (Ärvd från Exception)
Source	Hämtar eller anger namnet på programmet eller objektet som orsakar felet. (Ärvd från Exception)
StackTrace	Hämtar en strängrepresentation av de omedelbara ramarna i anropsstacken. (Ärvd från Exception)
TargetSite	Hämtar den metod som utlöser det aktuella undantaget. (Ärvd från Exception)

Metoder

Name	Description
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
GetBaseException()	När den åsidosätts i en härledd klass returnerar den Exception som är rotorsaken till ett eller flera efterföljande undantag. (Ärvd från Exception)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetObjectData(SerializationInfo, StreamingContext)	När åsidosättas i en härledd klass anger du SerializationInfo med information om undantaget. (Ärvd från Exception)
GetType()	Hämtar körningstypen för den aktuella instansen. (Ärvd från Exception)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
ToString()	Skapar och returnerar en strängrepresentation av det aktuella undantaget. (Ärvd från Exception)

Händelser

Name	Description
SerializeObjectState	Inträffar när ett undantag serialiseras för att skapa ett undantagstillståndsobjekt som innehåller serialiserade data om undantaget. (Ärvd från Exception)

Gäller för

Se även

Feedback

Var den här sidan till hjälp?