String.IsNullOrEmpty(String) Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

String.cs

Belirtilen dizenin mi yoksa boş bir dize mi ("") olduğunu null gösterir.

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

Parametreler

value

String

Test için dize.

Döndürülenler

Boolean

true value parametresi null veya boş bir dizeyse (""); aksi takdirde , false.

Örnekler

Aşağıdaki örnek üç dizeyi inceler ve her dizenin bir değeri olup olmadığını, boş bir dize mi yoksa olup nullolmadığını belirler.

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.

let test (s: string): string =
    if String.IsNullOrEmpty(s)
    then "is null or empty"
    else $"(\"{s}\") is neither null nor empty"

let s1 = "abcd"
let s2 = ""
let s3 = null

printfn "String s1 %s" (test s1)
printfn "String s2 %s" (test s2)
printfn "String s2 %s" (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.

Açıklamalar

IsNullOrEmpty, bir Stringnull veya değerinin String.Emptyolup olmadığını aynı anda test etmenizi sağlayan bir kolaylık yöntemidir. Aşağıdaki koda eşdeğerdir:

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

let testForNullOrEmpty (s: string): bool =
    s = null || s = String.Empty

let s1 = null
let s2 = ""

printfn "%b" (testForNullOrEmpty s1)
printfn "%b" (testForNullOrEmpty s2)

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

bir dizenin IsNullOrWhiteSpaceolup olmadığını, değerinin nullolup olmadığını veya yalnızca boşluk karakterlerinden mi oluştuğunu test etmek için String.Empty yöntemini kullanabilirsiniz.

Null dize nedir?

Bir dizeye değer atanmadığında (C++ ve Visual Basic'te) null olur veya açıkça nulldeğeri atanmışsa nullolur. bileşik biçimlendirme özelliği, bir null dizeyi sorunsuz bir şekilde işleyebilir; ancak aşağıdaki örnekte gösterildiği gibi, üyelerinden birini çağırmayı denemek bir NullReferenceExceptionoluşturur.

  String s = null;

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

  try 
  {
      Console.WriteLine($"String length is {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 Main3()
        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.

let (s: string) = null

printfn "The value of the string is '%s'" s

try
    printfn "String length is %d" s.Length
with
    | :? NullReferenceException as ex -> printfn "%s" ex.Message

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

Boş dize nedir?

Bir dize, açıkça boş bir dize ("") veya String.Emptyatanmışsa boş olur. Boş bir dizenin Length değeri 0'dır. Aşağıdaki örnek boş bir dize oluşturur ve değerini ve uzunluğunu görüntüler.

String s = "";
Console.WriteLine($"The length of '{s}' is {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.

let s = ""
printfn "The length of '%s' is %d." s s.Length

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

Ayrıca bkz.

• IsNullOrWhiteSpace(String)