String.IsNullOrWhiteSpace(String) Methode

Definitie

Naamruimte:
System
Assembly's:
mscorlib.dll, System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll

Hiermee wordt aangegeven of een opgegeven tekenreeks leeg is nullof alleen uit spatietekens bestaat.

public:
 static bool IsNullOrWhiteSpace(System::String ^ value);
public static bool IsNullOrWhiteSpace(string value);
static member IsNullOrWhiteSpace : string -> bool
Public Shared Function IsNullOrWhiteSpace (value As String) As Boolean

Parameters

value
String

De tekenreeks die moet worden getest.

Retouren

Boolean

true als de value parameter is null of Empty, of value uitsluitend uit spatietekens bestaat.

Voorbeelden

In het volgende voorbeeld wordt een tekenreeksmatrix gemaakt en vervolgens elk element van de matrix doorgegeven aan de IsNullOrWhiteSpace methode.

using System;

public class Example
{
   public static void Main()
   {
      string[] values = { null, String.Empty, "ABCDE", 
                          new String(' ', 20), "  \t   ", 
                          new String('\u2000', 10) };
      foreach (string value in values)
         Console.WriteLine(String.IsNullOrWhiteSpace(value));
   }
}
// The example displays the following output:
//       True
//       True
//       False
//       True
//       True
//       True

open System

let values = 
    [| null; String.Empty; "ABCDE"
       String(' ', 20); "  \t   "
       String('\u2000', 10) |]

for value in values do
    printfn $"{String.IsNullOrWhiteSpace value}"
// The example displays the following output:
//       True
//       True
//       False
//       True
//       True
//       True

Module Example
   Public Sub Main()
      Dim values() As String = { Nothing, String.Empty, "ABCDE", 
                                 New String(" "c, 20), "  " + vbTab + "   ", 
                                 New String(ChrW(&h2000), 10) }
      For Each value As String In values
         Console.WriteLine(String.IsNullOrWhiteSpace(value))
      Next
   End Sub
End Module
' The example displays the following output:
'       True
'       True
'       False
'       True
'       True
'       True

Opmerkingen

IsNullOrWhiteSpace is een handige methode die vergelijkbaar is met de volgende code, behalve dat deze superieure prestaties biedt:

return String.IsNullOrEmpty(value) || value.Trim().Length == 0;

String.IsNullOrEmpty value || value.Trim().Length = 0

Return String.IsNullOrEmpty(value) OrElse value.Trim().Length = 0

Spatietekens worden gedefinieerd door de Unicode-standaard. De IsNullOrWhiteSpace methode interpreteert elk teken dat een waarde retourneert van true wanneer deze als witruimteteken aan de Char.IsWhiteSpace methode wordt doorgegeven.

Van toepassing op

Zie ook