String.IsNullOrWhiteSpace(String) Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Source:

String.cs

Indique si une chaîne spécifiée est null, vide ou se compose uniquement d'espaces blancs.

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

Paramètres

value

String

Chaîne à tester.

Retours

Boolean

true si le paramètre value est null ou Empty, ou si value est composé exclusivement d'espaces blancs.

Exemples

L’exemple suivant crée un tableau de chaînes, puis passe chaque élément du tableau à la IsNullOrWhiteSpace méthode .

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

Remarques

IsNullOrWhiteSpace est une méthode pratique similaire au code suivant, sauf qu’elle offre des performances supérieures :

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

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

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

Les espaces blancs sont définis par la norme Unicode. La IsNullOrWhiteSpace méthode interprète tout caractère qui retourne une valeur de true quand il est passé à la Char.IsWhiteSpace méthode en tant que caractère d’espace blanc.

Voir aussi

• IsNullOrEmpty(String)