System.String.IsNullOrWhiteSpace 方法

方法描述

指示指定的字符串是 null、空还是仅由空白字符组成。

语法定义(C# System.String.IsNullOrWhiteSpace 方法 的用法)

public static bool IsNullOrWhiteSpace(
	string value
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
value System-String 要测试的字符串。
返回值 System.Boolean 如果 value 参数为 null 或 String.Empty,或者如果 value 仅由空白字符组成,则为 true。

提示和注释

IsNullOrWhiteSpace 是与以下代码类似的便捷方法,只不过它提供更高的性能:

C#

VB

复制

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

空白字符由 Unicode 标准定义。 IsNullOrWhiteSpace 方法解释在作为空白字符传递到 Char.IsWhiteSpace 方法时返回 true 值的任何字符。

System.String.IsNullOrWhiteSpace 方法例子

下面的示例创建字符串数组,然后将数组的每个元素传递给 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

异常

异常 异常描述

命名空间

namespace: System

程序集: mscorlib(在 mscorlib.dll 中)

版本信息

.NET Framework 受以下版本支持:4 .NET Framework Client Profile 受以下版本支持:4

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。