String.IsNullOrWhiteSpace(String) Método

  • Referencia

Definición

Espacio de nombres:
System
Ensamblado:
System.Runtime.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll
Source:
String.cs
Source:
String.cs
Source:
String.cs

Indica si la cadena especificada es null, está vacía o consta únicamente de caracteres de espacio en blanco.

public:
 static bool IsNullOrWhiteSpace(System::String ^ value);
public static bool IsNullOrWhiteSpace (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

Cadena que se va a comprobar.

Devoluciones

Boolean

Es true si el parámetro value es null o Empty, o bien si value consta únicamente de caracteres de espacio en blanco.

Ejemplos

En el ejemplo siguiente se crea una matriz de cadenas y, a continuación, se pasa cada elemento de la matriz al IsNullOrWhiteSpace método .

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

open System

let values = 
    [| null; String.Empty; "ABCDE"
       String(' ', 20); "  \t   "
       String('\u2000', 10) |]

for value in values do
    printfn $"{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

Comentarios

IsNullOrWhiteSpace es un método de conveniencia similar al código siguiente, salvo que ofrece un rendimiento superior:

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

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

Return String.IsNullOrEmpty(value) OrElse value.Trim().Length = 0

Los caracteres de espacio en blanco se definen mediante el estándar Unicode. El IsNullOrWhiteSpace método interpreta cualquier carácter que devuelva un valor de true cuando se pasa al Char.IsWhiteSpace método como un carácter de espacio en blanco.

Se aplica a

Consulte también