How to Use string.IsNullOrWhiteSpace in C#

Use string.IsNullOrWhiteSpace in C# to check if a string is either null, empty, or contains only whitespace characters like spaces or tabs. It returns true if the string has no visible characters, otherwise false.

Syntax

The method string.IsNullOrWhiteSpace takes one string argument and returns a boolean value. It checks if the string is null, empty (""), or consists only of whitespace characters.

• string value: The string to test.
• Returns true if the string is null, empty, or whitespace only.
• Returns false otherwise.

csharp

bool result = string.IsNullOrWhiteSpace(value);

Example

This example shows how to use string.IsNullOrWhiteSpace to check different strings and print whether they are considered empty or whitespace.

csharp

using System;

class Program
{
    static void Main()
    {
        string[] testStrings = { null, "", "   ", "Hello", "\t\n" };

        foreach (var str in testStrings)
        {
            bool isEmptyOrWhiteSpace = string.IsNullOrWhiteSpace(str);
            Console.WriteLine($"Input: '{str ?? "null"}' -> IsNullOrWhiteSpace: {isEmptyOrWhiteSpace}");
        }
    }
}

Output

Input: 'null' -> IsNullOrWhiteSpace: True
Input: '' -> IsNullOrWhiteSpace: True
Input: '   ' -> IsNullOrWhiteSpace: True
Input: 'Hello' -> IsNullOrWhiteSpace: False
Input: '	
' -> IsNullOrWhiteSpace: True

Common Pitfalls

Some common mistakes when checking strings include:

• Using string.IsNullOrEmpty which returns false for strings with only spaces, unlike IsNullOrWhiteSpace.
• Manually trimming strings and checking length, which is less efficient and more error-prone.
• Not handling null strings before calling methods like Trim(), causing exceptions.

csharp

string input = "   ";

// Wrong: This returns false because input is not empty
bool wrongCheck = string.IsNullOrEmpty(input);

// Right: This returns true because input is whitespace only
bool rightCheck = string.IsNullOrWhiteSpace(input);

Quick Reference

Method	Returns True When	Example Input	Example Result
string.IsNullOrWhiteSpace	String is null, empty, or only whitespace	null, "", " "	true
string.IsNullOrEmpty	String is null or empty only	null, ""	true
Manual Trim + Length Check	String trimmed length is zero	" ".Trim().Length == 0	true but less efficient

Key Takeaways

Use string.IsNullOrWhiteSpace to check if a string is null, empty, or only whitespace.

It is safer and simpler than manually trimming strings before checking.

string.IsNullOrEmpty does not consider whitespace-only strings as empty.

Avoid calling methods like Trim() on null strings to prevent exceptions.

This method helps validate user input or text data effectively.