DBNull

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

DBNull クラス

null 値を表します。

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

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class
 DBNull
    Implements ISerializable, IConvertible

Visual Basic (使用法)

Dim instance As DBNull

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public sealed class DBNull : ISerializable,
 IConvertible

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class DBNull sealed : ISerializable,
 IConvertible

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public final class DBNull implements ISerializable,
 IConvertible

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public final class DBNull implements ISerializable,
 IConvertible

解説

このクラスは、通常は、データベース アプリケーションに既知の値が存在しないことを示すために使用されます。

データベース アプリケーションでは、null オブジェクトは、フィールドの有効な値です。このクラスでは、null 値 (null オブジェクト) と初期化されていない値 (DBNull.Value のインスタンス) は区別されます。たとえば、テーブルに、初期化されていないフィールドを持つレコードを保持できます。既定では、このような初期化されていないフィールドには DBNull 値が格納されます。

このクラスは、null オブジェクトに関連付けられている VT_NULL バリアントと、DBNull.Value のインスタンスに関連付けられている VT_EMPTY バリアントを区別するために、COM 相互運用でも使用されます。

DBNull は、他のどの値とも等しくなりません。

DBNull はシングルトン クラスです。つまり、このクラスのインスタンスは 1 つしか存在できません。その唯一のインスタンスは DBNull.Value です。

データ処理を重点的に行い、SQL データベースにアクセスするアプリケーションでは、System.Data.SqlTypes のクラスを使用する必要があります。これらのクラスでは、null 値を継承してサポートできます。

継承階層

System.Object
  System.DBNull

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DBNull メンバ
System 名前空間
Convert.DBNull
Convert.IsDBNull
System.Runtime.InteropServices.VarEnum
System.Data.SqlTypes

DBNull フィールド

パブリック フィールド

	名前	説明
	Value	DBNull クラスの唯一のインスタンスを表します。

参照

関連項目

DBNull クラス
System 名前空間
Convert.DBNull
Convert.IsDBNull
System.Runtime.InteropServices.VarEnum
System.Data.SqlTypes

DBNull メソッド

パブリック メソッド

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetObjectData	ISerializable インターフェイスを実装し、DBNull オブジェクトをシリアル化するために必要なデータを返します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	GetTypeCode	DBNull の TypeCode 値を取得します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	オーバーロードされます。 オーバーライドされます。 空の文字列を返します。

明示的インターフェイスの実装

	名前	説明
	System.IConvertible.ToBoolean	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToByte	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToChar	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToDateTime	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToDecimal	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToDouble	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToInt16	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToInt32	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToInt64	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToSByte	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToSingle	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToType	現在の DBNull オブジェクトを指定した型に変換します。
	System.IConvertible.ToUInt16	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToUInt32	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToUInt64	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。

参照

関連項目

DBNull クラス
System 名前空間
Convert.DBNull
Convert.IsDBNull
System.Runtime.InteropServices.VarEnum
System.Data.SqlTypes

DBNull メンバ

null 値を表します。

DBNull データ型で公開されるメンバを以下の表に示します。

パブリック フィールド

	名前	説明
	Value	DBNull クラスの唯一のインスタンスを表します。

パブリック メソッド

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetObjectData	ISerializable インターフェイスを実装し、DBNull オブジェクトをシリアル化するために必要なデータを返します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	GetTypeCode	DBNull の TypeCode 値を取得します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	オーバーロードされます。 オーバーライドされます。 空の文字列を返します。

明示的インターフェイスの実装

	名前	説明
	System.IConvertible.ToBoolean	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToByte	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToChar	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToDateTime	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToDecimal	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToDouble	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToInt16	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToInt32	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToInt64	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToSByte	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToSingle	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToType	現在の DBNull オブジェクトを指定した型に変換します。
	System.IConvertible.ToUInt16	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToUInt32	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。
	System.IConvertible.ToUInt64	この変換はサポートされていません。この変換を試みると、InvalidCastException がスローされます。

参照

関連項目

DBNull クラス
System 名前空間
Convert.DBNull
Convert.IsDBNull
System.Runtime.InteropServices.VarEnum
System.Data.SqlTypes