Método System.String.IsNullOrEmpty (verifica se uma string é nula ou vazia)

Este artigo fornece comentários complementares à documentação de referência para esta API.

IsNullOrEmpty é um método de conveniência que permite que você teste simultaneamente se um String é null ou seu valor é String.Empty. Ele é equivalente ao seguinte código:

bool TestForNullOrEmpty(string s)
{
    bool result;
    result = s == null || s == string.Empty;
    return result;
}

string s1 = null;
string s2 = "";
Console.WriteLine(TestForNullOrEmpty(s1));
Console.WriteLine(TestForNullOrEmpty(s2));

// The example displays the following output:
//    True
//    True

result = s Is Nothing OrElse s = String.Empty

let testForNullOrEmpty (s: string): bool =
    s = null || s = String.Empty

let s1 = null
let s2 = ""

printfn "%b" (testForNullOrEmpty s1)
printfn "%b" (testForNullOrEmpty s2)

// The example displays the following output:
//    true
//    true

Você pode usar o IsNullOrWhiteSpace método para testar se uma cadeia de caracteres é null, seu valor é String.Emptyou consiste apenas em caracteres de espaço em branco.

O que é uma cadeia de caracteres nula?

Uma cadeia de caracteres será null se ela não tiver recebido um valor (no C++ e no Visual Basic) ou se tiver sido explicitamente atribuído um valor de null. Embora o recurso de formatação composta possa manipular normalmente uma cadeia de caracteres nula, como mostra o seguinte exemplo, tentar chamar um de seus membros gerará um NullReferenceException.

  String s = null;

  Console.WriteLine($"The value of the string is '{s}'");

  try 
  {
      Console.WriteLine($"String length is {s.Length}");
  }
  catch (NullReferenceException e) 
  {
      Console.WriteLine(e.Message);
  }

  // The example displays the following output:
  //     The value of the string is ''
  //     Object reference not set to an instance of an object.

Module Example
   Public Sub Main()
      Dim s As String

      Console.WriteLine("The value of the string is '{0}'", s)

      Try 
         Console.WriteLine("String length is {0}", s.Length)
      Catch e As NullReferenceException
         Console.WriteLine(e.Message)
      End Try   
   End Sub
End Module
' The example displays the following output:
'     The value of the string is ''
'     Object reference not set to an instance of an object.

let (s: string) = null

printfn "The value of the string is '%s'" s

try
    printfn "String length is %d" s.Length
with
    | :? NullReferenceException as ex -> printfn "%s" ex.Message

// The example displays the following output:
//     The value of the string is ''
//     Object reference not set to an instance of an object.

O que é uma cadeia de caracteres vazia?

Uma cadeia de caracteres estará vazia se for atribuída explicitamente uma cadeia de caracteres vazia ("") ou String.Empty. Uma cadeia de caracteres vazia tem um Length de 0. O exemplo a seguir cria uma cadeia de caracteres vazia e exibe seu valor e seu comprimento.

String s = "";
Console.WriteLine($"The length of '{s}' is {s.Length}.");

// The example displays the following output:
//       The length of '' is 0.

Dim s As String = ""
Console.WriteLine("The length of '{0}' is {1}.", s, s.Length)
' The example displays the following output:
'        The length of '' is 0.

let s = ""
printfn "The length of '%s' is %d." s s.Length

// The example displays the following output:
//       The length of '' is 0.