This topic has not yet been rated - Rate this topic

String.IsNullOrWhiteSpace Method

Silverlight

Other Versions

Indicates whether a specified string is null, empty, or consists only of white-space characters.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

Syntax

Copy

public static bool IsNullOrWhiteSpace(
	string value
)

Parameters

value: Type: System.String
The string to test.

Return Value

Type: System.Boolean
true if the value parameter is null or String.Empty, or if value consists exclusively of white-space characters.

Remarks

IsNullOrWhiteSpace is a convenience method that is equivalent to the following code, except that it offers superior performance:

Copy


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

White-space characters are defined by the Unicode standard. 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.

Examples

The following example creates a string array, and then passes each element of the array to the IsNullOrWhiteSpace method.

Copy


using System;

public class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      string[] values = { null, String.Empty, "ABCDE", 
                          new String(' ', 20), "  \t   ", 
                          new String('\u2000', 10) };
      foreach (string value in values)
         outputBlock.Text += String.IsNullOrWhiteSpace(value) + "\n";
   }
}
// The example displays the following output:
//       True
//       True
//       False
//       True
//       True
//       True

Version Information

Silverlight

Supported in: 5, 4

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Reference

String Class

System Namespace

IsNullOrEmpty

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ