NullReferenceException Classe

Definição

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

Herança

Object

Exception

NullReferenceException

Herança

Object

Exception

SystemException

NullReferenceException

Atributos

SerializableAttribute ComVisibleAttribute

Comentários

Uma NullReferenceException exceção é gerada quando você tenta acessar um membro em um tipo cujo valor é null. Uma NullReferenceException exceção normalmente reflete o erro do desenvolvedor e é gerada nos seguintes cenários:

• Você esqueceu de instanciar um tipo de referência. No exemplo a seguir, é declarado, names mas nunca instanciado:

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

  Alguns compiladores emitem um aviso quando compilam esse código. Outros emitem um erro e a compilação falha. Para resolver esse problema, instancie o objeto para que seu valor não seja mais null. O exemplo a seguir faz isso chamando o construtor de classe de um tipo.

  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
  

• Você esqueceu de dimensionar uma matriz antes de inicializá-la. No exemplo a seguir, values é declarado como uma matriz de inteiros, mas o número de elementos que ele contém nunca é especificado. A tentativa de inicializar seus valores, portanto, lançou uma NullReferenceException exceção.

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

  Você pode eliminar a exceção declarando o número de elementos na matriz antes de inicializá-la, como faz o exemplo a seguir.

  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
  

  Para obter mais informações sobre como declarar e inicializar matrizes, consulte Matrizes e matrizes.

• Você obtém um valor retornado nulo de um método e, em seguida, chama um método no tipo retornado. Às vezes, isso é o resultado de um erro de documentação; a documentação não observa que uma chamada de método pode retornar null. Em outros casos, seu código pressupõe erroneamente que o método sempre retornará um valor não nulo .

  O código no exemplo a seguir pressupõe que o método sempre retorna Person um Array.Find objeto cujo FirstName campo corresponde a uma cadeia de caracteres de pesquisa. Como não há correspondência, o runtime gera uma NullReferenceException exceção.

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

  Para resolver esse problema, teste o valor retornado do método para garantir que ele não null seja antes de chamar nenhum de seus membros, como faz o exemplo a seguir.

  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
  

• Você está usando uma expressão (por exemplo, você está encadeando uma lista de métodos ou propriedades juntos) para recuperar um valor e, embora esteja verificando se o valor é null, o runtime ainda gera uma NullReferenceException exceção. Isso ocorre porque um dos valores intermediários na expressão retorna null. Como resultado, seu teste para null nunca é avaliado.

  O exemplo a seguir define um Pages objeto que armazena em cache informações sobre páginas da Web, que são apresentadas por Page objetos . O Example.Main método verifica se a página da Web atual tem um título não nulo e, se tiver, exibe o título. No entanto, apesar dessa marcar, o método gera uma NullReferenceException exceção.

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

  A exceção é gerada porque pages.CurrentPage retorna null se nenhuma informação de página é armazenada no cache. Essa exceção pode ser corrigida testando o valor da propriedade antes de CurrentPage recuperar a propriedade do Title objeto atualPage, como faz o exemplo a seguir:

  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.
  

• Você está enumerando os elementos de uma matriz que contém tipos de referência e sua tentativa de processar um dos elementos gera uma NullReferenceException exceção.

  O exemplo a seguir define uma matriz de cadeia de caracteres. Uma for instrução enumera os elementos na matriz e chama o método de Trim cada cadeia de caracteres antes de exibir a cadeia de caracteres.

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

  Essa exceção ocorrerá se você pressupor que cada elemento da matriz deve conter um valor não nulo e o valor do elemento de matriz é, na verdade null, . A exceção pode ser eliminada testando se o elemento é null antes de executar qualquer operação nesse elemento, como mostra o exemplo a seguir.

  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
  

• Uma NullReferenceException exceção pode ser gerada por um método quando acessa um membro de um de seus argumentos, mas esse argumento é null. O PopulateNames método no exemplo a seguir gera a exceção na linha names.Add(arrName);.

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

  Para resolver esse problema, verifique se o argumento passado para o método não nullé ou manipule a exceção gerada em um try…catch…finally bloco. Para obter mais informações, consulte Exceções.

As seguintes instruções de MSIL (Microsoft Intermediate Language) lançam : , , , cpobj, initblk, ldelem.<type>, ldelema, ldfldaldfld, ldind.<type>, ldlenstelem.<type>, stfld, stind.<type>, , throwe unbox. cpblkcallvirtNullReferenceException

NullReferenceException usa o COR_E_NULLREFERENCE HRESULT, que tem o valor 0x80004003.

Para obter uma lista de valores de propriedade inicial para uma instância do NullReferenceException, consulte o NullReferenceException construtores.

Manipulando NullReferenceException no código de versão

Geralmente, é melhor evitar um NullReferenceException do que tratá-lo depois que ele ocorre. Tratar uma exceção pode fazer com que seu código seja difícil de manter e entender e pode, algumas vezes, introduzir outros bugs. Uma NullReferenceException é frequentemente um erro não recuperável. Nesses casos, deixar a exceção interromper o aplicativo pode ser a melhor alternativa.

No entanto, há várias situações em que o tratamento do erro pode ser útil:

• Seu aplicativo pode ignorar objetos nulos. Por exemplo, se seu aplicativo recupera e processa gravações em um banco de dados, você pode ser capaz de ignorar um certo número de gravações ruins que resultam em objetos nulos. Gravar os dados ruins em um arquivo de log ou na interface de usuário do aplicativo pode ser tudo que você precisa fazer.

• Você pode recuperar a partir da exceção. Por exemplo, uma chamada para um serviço Web que retorna um tipo de referência pode retornar nulo se a conexão for perdida ou a conexão atingir o tempo limite. Você pode tentar restabelecer a conexão e tentar a chamada novamente.

• Você pode restaurar o estado de seu aplicativo para um estado válido. Por exemplo, pode ser que você esteja realizando uma tarefa de várias etapas que requer que as informações sejam salvas em um armazenamento de dados antes de chamar um método que lança uma NullReferenceException. Se o objeto não inicializado corromper a gravação de dados, você poderá remover os dados anteriores antes de fechar o aplicativo.

• Você deseja reportar a exceção. Por exemplo, se o erro foi causado por um erro do usuário do seu aplicativo, você pode gerar uma mensagem para ajudá-lo a fornecer as informações corretas. Você pode também registrar informações sobre o erro para ajudá-lo a solucionar o problema. Algumas estruturas, como o ASP.NET, tem um manipulador de exceção de alto nível que captura todos os erros para que o aplicativo nunca falhe; nesse caso, a exceção de registro em log pode ser a única maneira de saber que ele ocorre.

Construtores

Propriedades

Métodos

Eventos

Aplica-se a

Confira também

• Exception
• Manipulando e lançando exceções