Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês
Esta documentação foi arquivada e não está sendo atualizada.

Método String.IsNullOrEmpty

Indica se a String especificada é uma referência nula (Nothing no Visual Basic) ou uma string Empty (vazia).

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

public static bool IsNullOrEmpty(
	string value
)

Parâmetros

value
Tipo: System.String
A seqüência de teste.

Valor de retorno

Tipo: System.Boolean
true Se a value parâmetro é null ou uma seqüência vazia (""); Caso contrário, false.

IsNullOrEmpty é um método de conveniência que permite que você teste simultaneamente se um String é null ou seu valor é Empty. É equivalente ao seguinte código:


result = s == null || s == String.Empty;


O exemplo a seguir determina se cada um dos três seqüências de caracteres tem um valor, é uma seqüência vazia ou é null.


using System;

class Sample 
{
    public static void Main() 
    {
    string s1 = "abcd";
    string s2 = "";
    string s3 = null;

    Console.WriteLine("String s1 {0}.", Test(s1));
    Console.WriteLine("String s2 {0}.", Test(s2));
    Console.WriteLine("String s3 {0}.", Test(s3));
    }

    public static String Test(string s)
    {
    if (String.IsNullOrEmpty(s)) 
        return "is null or empty";
    else
        return String.Format("(\"{0}\") is not null or empty", s);
    }
}
// The example displays the following output:
//       String s1 ("abcd") is not null or empty.
//       String s2 is null or empty.
//       String s3 is null or empty.


.NET Framework

Com suporte em: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core não compatível), Windows Server 2008 R2 (Server Core não compatível com SP1 ou posterior), Windows Server 2003 SP2

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos de sistema do .NET Framework.

Date

Histórico

Motivo

Dezembro de 2010

Expandir a seção de comentários e modificado o exemplo.

Comentários do cliente.

Mostrar: