String.IsNullOrWhiteSpace(String) String.IsNullOrWhiteSpace(String) String.IsNullOrWhiteSpace(String) String.IsNullOrWhiteSpace(String) Method

定義

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

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

パラメーター

value
String String String String

テストする文字列。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)
         Console.WriteLine(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は、より優れたパフォーマンスを提供する点を除いて、次のコードのような便利なメソッドです。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. メソッドは、空白文字としてChar.IsWhiteSpaceメソッドにtrue渡されたときに、値を返す任意の文字を解釈します。 IsNullOrWhiteSpaceThe 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.

適用対象

こちらもご覧ください