String.IsNullOrEmpty(String) Méthode

Référence

Définition

Espace de noms:: System

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Indique si la chaîne spécifiée est null ou une chaîne vide ("").

public:
 static bool IsNullOrEmpty(System::String ^ value);

public static bool IsNullOrEmpty (string value);

public static bool IsNullOrEmpty (string? value);

static member IsNullOrEmpty : string -> bool

Public Shared Function IsNullOrEmpty (value As String) As Boolean

Paramètres

value: String

Chaîne à tester.

Retours

Boolean

true si le paramètre value est null ou une chaîne vide ("") ; sinon, false.

Exemples

L’exemple suivant examine trois chaînes et détermine si chaque chaîne a une valeur, si est une chaîne vide ou si a la valeur null .

using namespace System;
String^ Test( String^ s )
{
   if (String::IsNullOrEmpty(s))
      return "is null or empty";
   else
      return String::Format( "(\"{0}\") is neither null nor empty", s );
}

int main()
{
   String^ s1 = "abcd";
   String^ s2 = "";
   String^ s3 = nullptr;
   Console::WriteLine( "String s1 {0}.", Test( s1 ) );
   Console::WriteLine( "String s2 {0}.", Test( s2 ) );
   Console::WriteLine( "String s3 {0}.", Test( s3 ) );
}
// The example displays the following output:
//       String s1 ("abcd") is neither null nor empty.
//       String s2 is null or empty.
//       String s3 is null or empty.

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));

String Test(string s)
{
if (String.IsNullOrEmpty(s))
    return "is null or empty";
else
    return String.Format("(\"{0}\") is neither null nor empty", s);
}

// The example displays the following output:
//       String s1 ("abcd") is neither null nor empty.
//       String s2 is null or empty.
//       String s3 is null or empty.

Class Sample
   Public Shared Sub Main()
      Dim s1 As String = "abcd"
      Dim s2 As String = ""
      Dim s3 As String = Nothing
      
      Console.WriteLine("String s1 {0}.", Test(s1))
      Console.WriteLine("String s2 {0}.", Test(s2))
      Console.WriteLine("String s3 {0}.", Test(s3))
   End Sub
   
   Public Shared Function Test(s As String) As String
      If String.IsNullOrEmpty(s) Then
         Return "is null or empty"
      Else
         Return String.Format("(""{0}"") is neither null nor empty", s)
      End If
   End Function 
End Class  
' The example displays the following output:
'       String s1 ("abcd") is neither null nor empty.
'       String s2 is null or empty.
'       String s3 is null or empty.

Remarques

IsNullOrEmpty est une méthode pratique qui vous permet de tester simultanément si a String null ou sa valeur est String.Empty . Elle est équivalente au code suivant :

result = s == nullptr || s == String::Empty;

bool TestForNullOrEmpty(string s)
{
    bool result;
    result = s == null || s == string.Empty;
    return result;
}

string s1 = null;
string s2 = "";
Console.WriteLine(TestForNullOrEmpty(s1));
Console.WriteLine(TestForNullOrEmpty(s2));

// The example displays the following output:
//    True
//    True

result = s Is Nothing OrElse s = String.Empty

Vous pouvez utiliser la IsNullOrWhiteSpace méthode pour vérifier si une chaîne est null , si sa valeur est String.Empty , ou si elle se compose uniquement d’espaces blancs.

Qu’est-ce qu’une chaîne null ?

une chaîne est null si aucune valeur n’a été assignée (en C++ et Visual Basic) ou si une valeur a été explicitement assignée à null . Bien que la fonctionnalité de mise en forme composite puisse gérer gracieusement une chaîne NULL, comme le montre l’exemple suivant, en tentant d’en appeler une si ses membres lèvent une exception NullReferenceException .

using namespace System;

void main()
{
   String^ s;
  
   Console::WriteLine("The value of the string is '{0}'", s);

   try {
      Console::WriteLine("String length is {0}", s->Length);
   }
   catch (NullReferenceException^ e) {
      Console::WriteLine(e->Message);
   }   
}
// The example displays the following output:
//     The value of the string is ''
//     Object reference not set to an instance of an object.

  String s = null;

  Console.WriteLine("The value of the string is '{0}'", s);

  try 
  {
      Console.WriteLine("String length is {0}", s.Length);
  }
  catch (NullReferenceException e) 
  {
      Console.WriteLine(e.Message);
  }

  // The example displays the following output:
  //     The value of the string is ''
  //     Object reference not set to an instance of an object.

Module Example
   Public Sub Main()
      Dim s As String

      Console.WriteLine("The value of the string is '{0}'", s)

      Try 
         Console.WriteLine("String length is {0}", s.Length)
      Catch e As NullReferenceException
         Console.WriteLine(e.Message)
      End Try   
   End Sub
End Module
' The example displays the following output:
'     The value of the string is ''
'     Object reference not set to an instance of an object.

Qu’est-ce qu’une chaîne vide ?

Une chaîne est vide si une chaîne vide ("") est assignée explicitement ("") ou String.Empty . Une chaîne vide a une valeur Length de 0. L’exemple suivant crée une chaîne vide et affiche sa valeur et sa longueur.

String^ s = "";
Console::WriteLine("The length of '{0}' is {1}.", s, s->Length);
// The example displays the following output:
//       The length of '' is 0.

String s = "";
Console.WriteLine("The length of '{0}' is {1}.", s, s.Length);

// The example displays the following output:
//       The length of '' is 0.

Dim s As String = ""
Console.WriteLine("The length of '{0}' is {1}.", s, s.Length)
' The example displays the following output:
'        The length of '' is 0.

S’applique à

Voir aussi

IsNullOrWhiteSpace(String)