String.IsNullOrWhiteSpace(String) メソッド


指定された文字列が null または空であるか、空白文字だけで構成されているかどうかを示します。Indicates whether a specified string is null, empty, or consists only of white-space characters.

 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



テストする文字列。The string to test.


true パラメーターが value または null であるか、Empty が空白文字だけで構成されている場合は valuetrue if the value parameter is null or Empty, or if value consists exclusively of white-space characters.

次の例では、文字列配列を作成し、配列の各要素を IsNullOrWhiteSpace メソッドに渡します。The following example creates a string array, and then passes each element of the array to the IsNullOrWhiteSpace method.

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)
// 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
   End Sub
End Module
' The example displays the following output:
'       True
'       True
'       False
'       True
'       True
'       True


IsNullOrWhiteSpace は、優れたパフォーマンスを提供する点を除いて、次のコードのような便利な方法です。IsNullOrWhiteSpace is a convenience method that is similar to the following code, except that it offers superior performance:

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

空白文字は、Unicode 規格で定義されています。White-space characters are defined by the Unicode standard. IsNullOrWhiteSpace メソッドは、Char.IsWhiteSpace メソッドに空白文字として渡されるときに true の値を返す任意の文字を解釈します。The IsNullOrWhiteSpace method interprets any character that returns a value of true when it is passed to the Char.IsWhiteSpace method as a white-space character.