String.IsNullOrWhiteSpace(String) Метод

  • Ссылка

Определение

Пространство имен:
System
Сборка:
System.Runtime.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll
Исходный код:
String.cs
Исходный код:
String.cs
Исходный код:
String.cs

Указывает, имеет ли указанная строка значение null, является ли она пустой строкой или строкой, состоящей только из символов-разделителей.

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

Параметры

value
String

Строка для проверки.

Возвращаемое значение

Boolean

Значение true, если параметр value имеет значение null или Empty, либо если параметр value содержит только символы-разделители.

Примеры

В следующем примере создается строковый массив, а затем каждый элемент массива передается методу 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

Комментарии

IsNullOrWhiteSpace — это удобный метод, который аналогичен следующему коду, за исключением того, что он обеспечивает превосходную производительность:

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

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

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

Пробелы определяются стандартом Юникода. Метод IsNullOrWhiteSpace интерпретирует любой символ, возвращающий значение true , когда он передается методу Char.IsWhiteSpace , как символ пробела.

Применяется к

См. также раздел