String.IsNullOrEmpty(String) Methode

Definition

Gibt an, ob die angegebene Zeichenfolge null oder eine leere Zeichenfolge ("") ist.Indicates whether the specified string is null or an empty string ("").

public:
 static bool IsNullOrEmpty(System::String ^ value);
public static bool IsNullOrEmpty (string value);
static member IsNullOrEmpty : string -> bool
Public Shared Function IsNullOrEmpty (value As String) As Boolean

Parameter

value
String

Die zu testende Zeichenfolge.The string to test.

Gibt zurück

true, wenn der value-Parameter null oder eine leere Zeichenfolge ("") ist; andernfalls false.true if the value parameter is null or an empty string (""); otherwise, false.

Beispiele

Im folgenden Beispiel werden drei Zeichen folgen überprüft und bestimmt, ob jede Zeichenfolge über einen Wert verfügt, eine leere Zeichenfolge ist oder null ist.The following example examines three strings and determines whether each string has a value, is an empty string, or is 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.

Hinweise

IsNullOrEmpty ist eine Hilfsmethode, die es Ihnen ermöglicht, gleichzeitig zu testen, ob ein String null oder sein Wert String.Empty ist.IsNullOrEmpty is a convenience method that enables you to simultaneously test whether a String is null or its value is String.Empty. Dies entspricht dem folgenden Code:It is equivalent to the following code:

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));
result = s Is Nothing OrElse s = String.Empty

Sie können die IsNullOrWhiteSpace-Methode verwenden, um zu testen, ob eine Zeichenfolge null ist, der Wert String.Empty ist oder nur aus Leerzeichen besteht.You can use the IsNullOrWhiteSpace method to test whether a string is null, its value is String.Empty, or it consists only of white-space characters.

Was ist eine NULL-Zeichenfolge?What is a null string?

Eine Zeichenfolge ist null, wenn ihr kein Wert zugewiesen wurde (in C++ und Visual Basic) oder explizit ein Wert von null zugewiesen wurde.A string is null if it has not been assigned a value (in C++ and Visual Basic) or if it has explicitly been assigned a value of null. Obwohl das Feature für die kombinierte Formatierung eine NULL-Zeichenfolge ordnungsgemäß verarbeiten kann, wie im folgenden Beispiel gezeigt, wird versucht, einen aufzurufen, wenn seine Member eine NullReferenceException auslösen.Although the composite formatting feature can gracefully handle a null string, as the following example shows, attempting to call one if its members throws a 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.

Was ist eine leere Zeichenfolge?What is an empty string?

Eine Zeichenfolge ist leer, wenn Ihr explizit eine leere Zeichenfolge ("") oder String.Empty zugewiesen wird.A string is empty if it is explicitly assigned an empty string ("") or String.Empty. Eine leere Zeichenfolge hat eine Length von 0.An empty string has a Length of 0. Im folgenden Beispiel wird eine leere Zeichenfolge erstellt und der zugehörige Wert und seine Länge angezeigt.The following example creates an empty string and displays its value and its length.

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.      

Gilt für:

Siehe auch