String.IsNullOrEmpty メソッド

.NET Framework クラス ライブラリ リファレンス

String.IsNullOrEmpty メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定された String オブジェクトが null 参照 (Visual Basic では Nothing) または Empty 文字列であるかどうかを示します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Function IsNullOrEmpty
 ( _
    value As String _
) As Boolean

Visual Basic (使用法)

Dim value As String
Dim returnValue As Boolean

returnValue = String.IsNullOrEmpty(value)

C#

public static bool IsNullOrEmpty
 (
    string value
)

C++

public:
static bool IsNullOrEmpty (
    String^ value
)

J#

public static boolean IsNullOrEmpty (
    String value
)

JScript

public static function IsNullOrEmpty
 (
    value : String
) : boolean

パラメータ

value

String 参照。

戻り値
value パラメータが null 参照 (Visual Basic では Nothing) または空の文字列 ("") の場合は true。それ以外の場合は false。

解説

IsNullOrEmpty メソッドを使用すると、String が null 参照 (Visual Basic では Nothing) であるかどうかと、値が Empty であるかどうかを一度に判定できます。

使用例

3 つの文字列に対し、それぞれが空の文字列、または null 参照 (Visual Basic では Nothing) であるかを確認するコード例を次に示します。

Visual Basic

' This example demonstrates the String.IsNullOrEmpty() method
Imports System

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 'Main
   
   Public Shared Function
 Test(s As String) As [String]
      If [String].IsNullOrEmpty(s) = True Then
         Return "is null or empty"
      Else
         Return String.Format("(""{0}"")
 is not null or empty", s)
      End If
   End Function 'Test
End Class 'Sample 
'
'This example produces the following results:
'
'String s1 ("abcd") is not null or empty.
'String s2 is null or empty.
'String s3 is null or empty.
'

C#

// This example demonstrates the String.IsNullOrEmpty() method
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) == true) 
        return "is null or empty";
    else
        return String.Format("(\"{0}\") is not
 null or empty", s);
    }
}
/*
This example produces the following results:

String s1 ("abcd") is not null or empty.
String s2 is null or empty.
String s3 is null or empty.

*/

C++

// This example demonstrates the String.IsNullOrEmpty() method
using namespace System;
String^ Test( String^ s )
{
   if ( String::IsNullOrEmpty( s ) == true
 )
      return "is null or empty";
   else
      return String::Format( "(\"{0}\") is not
 null or 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 ) );
}

/*
This example produces the following results:

String s1 ("abcd") is not null or empty.
String s2 is null or empty.
String s3 is null or empty.

*/

J#

// This example demonstrates the String.IsNullOrEmpty() method
import System.*;

class Sample
{
    public static void main(String[]
 args)
    {
        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));
    } //main

    public static String Test(String s)
    {
        if (String.IsNullOrEmpty(s) == true)
 {
            return "is null or empty";
        }
        else {
            return String.Format("(\"{0}\") is not
 null or empty", s);
        }
    } //Test
} //Sample 
 /*
This example produces the following results:

String s1 ("abcd") is not null or empty.
String s2 is null or empty.
String s3 is null or empty.

*/

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
String クラス
String メンバ
System 名前空間