Convert.IsDBNull(Object) メソッド

定義

名前空間:

System

アセンブリ:

netstandard.dll, System.Runtime.dll

ソース:

Convert.cs

指定したオブジェクトの型が DBNull かどうかを示す値を返します。

C#

public static bool IsDBNull(object? value);

パラメーター

value

Object

オブジェクト。

戻り値

Boolean

true の型が value の場合は DBNull。それ以外の場合は false。

例

次の例では、 オブジェクトを SqlDataReader 使用してデータベースからアンケート データを取得します。 各行のフィールド値を配列に割り当て、各配列要素を メソッドに IsDBNull 渡します。 メソッドが を返す true場合、この例では文字列 "NA" を配列要素に割り当てます。 その後、配列がコントロールの Rows コレクションに System.Windows.Forms.DataGridView 追加されます。

C#

private void Form1_Load(object sender, EventArgs e)
{
   // Define ADO.NET objects.
   SqlConnection conn = new SqlConnection(connectionString);
   SqlCommand cmd = new SqlCommand();
   SqlDataReader dr;

   // Open connection, and retrieve dataset.
   conn.Open();

   // Define Command object.
   cmd.CommandText = "Select * From Responses";
   cmd.CommandType = CommandType.Text;
   cmd.Connection = conn;

   // Retrieve data reader.
   dr = cmd.ExecuteReader();

   int fieldCount = dr.FieldCount;
   object[] fieldValues = new object[fieldCount];
   string[] headers = new string[fieldCount];

   // Get names of fields.
   for (int ctr = 0; ctr < fieldCount; ctr++)
      headers[ctr] = dr.GetName(ctr);

   // Set up data grid.
   this.grid.ColumnCount = fieldCount;

   this.grid.ColumnHeadersDefaultCellStyle.BackColor = Color.Navy;
   this.grid.ColumnHeadersDefaultCellStyle.ForeColor = Color.White;
   this.grid.ColumnHeadersDefaultCellStyle.Font = new Font(this.grid.Font, FontStyle.Bold);

   this.grid.AutoSizeRowsMode = DataGridViewAutoSizeRowsMode.DisplayedCellsExceptHeaders;
   this.grid.ColumnHeadersBorderStyle = DataGridViewHeaderBorderStyle.Single;
   this.grid.CellBorderStyle = DataGridViewCellBorderStyle.Single;
   this.grid.GridColor = Color.Black;
   this.grid.RowHeadersVisible = true;

   for (int columnNumber = 0; columnNumber < headers.Length;  columnNumber++)
      this.grid.Columns[columnNumber].Name = headers[columnNumber];

   // Get data, replace missing values with "NA", and display it.
   while (dr.Read())
   {
      dr.GetValues(fieldValues);

      for (int fieldCounter = 0; fieldCounter < fieldCount; fieldCounter++)
      {
         if (Convert.IsDBNull(fieldValues[fieldCounter]))
            fieldValues[fieldCounter] = "NA";
      }
      grid.Rows.Add(fieldValues);
   }
   dr.Close();
}

注釈

メソッドは IsDBNull 、 パラメーターが value と等しいかどうかをテストします DBNull.Value。 これは、次のコードと同じです。

C#

return DBNull.Value.Equals(value);

注意

DBNull.Value は、不足している値を示すために使用されます。 または と同等nullString.Emptyではありません。 したがって、C# や Convert.IsDBNull(Nothing) Visual Basic の などのConvert.IsDBNull(null)コードは を返しますfalse。

適用対象

こちらもご覧ください

• DBNull