String.IsNullOrWhiteSpace(String) Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

String.cs

Určuje, zda je nullzadaný řetězec , prázdný nebo se skládá pouze z prázdných znaků.

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

Parametry

value

String

Řetězec, který se má testovat.

Návraty

Boolean

true value pokud je null parametr nebo Empty, nebo pokud value se skládá výhradně z prázdných znaků.

Příklady

Následující příklad vytvoří řetězcové pole a poté předá každý prvek pole metodě IsNullOrWhiteSpace .

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

Poznámky

IsNullOrWhiteSpace je metoda usnadnění, která se podobá následujícímu kódu s tím rozdílem, že nabízí vynikající výkon:

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

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

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

Prázdné znaky jsou definovány standardem Unicode. Metoda IsNullOrWhiteSpace interpretuje libovolný znak, který vrací hodnotu true při předání Char.IsWhiteSpace metodě jako prázdný znak.

Viz také

• IsNullOrEmpty(String)