String.IsNullOrWhiteSpace(String) Metoda

  • Reference

Definice

Obor názvů:
System
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll
Zdroj:
String.cs
Zdroj:
String.cs
Zdroj:
String.cs

Určuje, zda zadaný řetězec je null, 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);
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ý chcete otestovat.

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ří pole řetězců a pak předá každý prvek pole IsNullOrWhiteSpace metodě.

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 pro 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 jakýkoli znak, který vrací hodnotu true při předání do Char.IsWhiteSpace metody jako prázdný znak.

Platí pro

Viz také