System.String.IsNullOrEmpty-Methode

Dieser Artikel enthält ergänzende Hinweise zur Referenzdokumentation für diese API.

IsNullOrEmpty ist eine bequeme Methode, mit der Sie gleichzeitig testen können, ob ein Stringnull ist oder ob sein Wert String.Empty ist. Sie entspricht dem folgenden Code:

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

Sie können die IsNullOrWhiteSpace-Methode verwenden, um zu testen, ob eine Zeichenfolge null ist, ob der Wert String.Empty ist, oder ob sie nur aus Leerzeichen besteht.

Was ist eine NULL-Zeichenfolge?

Eine Zeichenfolge ist null , wenn ihm kein Wert (in C++ und Visual Basic) zugewiesen wurde oder ihm explizit ein Wert zugewiesen nullwurde. Obwohl die Funktion für die zusammengesetzte Formatierung eine NULL-Zeichenfolge ordnungsgemäß verarbeiten kann, wie im folgenden Beispiel gezeigt wird, löst der Versuch zum Aufruf eines Members NullReferenceException aus.

  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.

Was ist eine leere Zeichenfolge?

Eine Zeichenfolge ist leer, wenn explizit eine leere Zeichenfolge ("") oder String.Empty zugewiesen wird. Eine leere Zeichenfolge weist einen Length Wert von 0 auf. Im folgenden Beispiel wird eine leere Zeichenfolge erstellt, und ihr Wert und ihre Länge werden angezeigt.

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.