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

Definição

Indica se uma cadeia de caracteres especificada é null, vazia ou consiste apenas em caracteres de espaço em branco.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

Parâmetros

value
String String String String

A cadeia de caracteres a ser testada.The string to test.

Retornos

true se o parâmetro value for null ou Empty, ou se value consistir exclusivamente em caracteres de espaço em branco.true if the value parameter is null or Empty, or if value consists exclusively of white-space characters.

Exemplos

O exemplo a seguir cria uma matriz de cadeia de caracteres e, em seguida, passa cada IsNullOrWhiteSpace elemento da matriz para o método.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

Comentários

IsNullOrWhiteSpaceé um método de conveniência semelhante ao código a seguir, exceto pelo fato de que ele oferece desempenho superior: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

Os caracteres de espaço em branco são definidos pelo padrão Unicode.White-space characters are defined by the Unicode standard. O IsNullOrWhiteSpace método interpreta qualquer caractere que retorna um true valor quando é passado para o Char.IsWhiteSpace método como um caractere de espaço em branco.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.

Aplica-se a

Veja também