DBNull Класс

Определение

public ref class DBNull sealed

public ref class DBNull sealed : IConvertible, System::Runtime::Serialization::ISerializable

public sealed class DBNull

public sealed class DBNull : IConvertible, System.Runtime.Serialization.ISerializable

[System.Serializable]
public sealed class DBNull : IConvertible, System.Runtime.Serialization.ISerializable

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class DBNull : IConvertible, System.Runtime.Serialization.ISerializable

type DBNull = class

type DBNull = class
    interface IConvertible
    interface ISerializable

[<System.Serializable>]
type DBNull = class
    interface ISerializable
    interface IConvertible

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type DBNull = class
    interface ISerializable
    interface IConvertible

Public NotInheritable Class DBNull

Public NotInheritable Class DBNull
Implements IConvertible, ISerializable

Наследование

Object

DBNull

Атрибуты

SerializableAttribute ComVisibleAttribute

Реализации

IConvertible ISerializable

Примеры

В следующем примере вызывается DBNull.Value.Equals метод , чтобы определить, имеет ли поле базы данных в базе данных контактов допустимое значение. Если это так, значение поля добавляется к строковым выходным данным в метке.

private void OutputLabels(DataTable dt)
{
   string label;

   // Iterate rows of table
   foreach (DataRow row in dt.Rows)
   {
      int labelLen;
      label = String.Empty;
      label += AddFieldValue(label, row, "Title");
      label += AddFieldValue(label, row, "FirstName");
      label += AddFieldValue(label, row, "MiddleInitial");
      label += AddFieldValue(label, row, "LastName");
      label += AddFieldValue(label, row, "Suffix");
      label += "\n";
      label += AddFieldValue(label, row, "Address1");
      label += AddFieldValue(label, row, "AptNo");
      label += "\n";
      labelLen = label.Length;
      label += AddFieldValue(label, row, "Address2");
      if (label.Length != labelLen)
         label += "\n";
      label += AddFieldValue(label, row, "City");
      label += AddFieldValue(label, row, "State");
      label += AddFieldValue(label, row, "Zip");
      Console.WriteLine(label);
      Console.WriteLine();
   }
}

private string AddFieldValue(string label, DataRow row,
                             string fieldName)
{
   if (! DBNull.Value.Equals(row[fieldName]))
      return (string) row[fieldName] + " ";
   else
      return String.Empty;
}

member this.OutputLabels(dt: DataTable) =
    let mutable label = ""

    // Iterate rows of table
    for row in dt.Rows do
        let mutable label = String.Empty
        label <- label + this.AddFieldValue(label, row, "Title")
        label <- label + this.AddFieldValue(label, row, "FirstName")
        label <- label + this.AddFieldValue(label, row, "MiddleInitial")
        label <- label + this.AddFieldValue(label, row, "LastName")
        label <- label + this.AddFieldValue(label, row, "Suffix")
        label <- label + "\n"
        label <- label + this.AddFieldValue(label, row, "Address1")
        label <- label + this.AddFieldValue(label, row, "AptNo")
        label <- label + "\n"
        let labelLen = label.Length
        label <- label + this.AddFieldValue(label, row, "Address2")
        let labelLen =
            if label.Length <> labelLen then
                label + "\n"
            else label
        label <- label + this.AddFieldValue(label, row, "City")
        label <- label + this.AddFieldValue(label, row, "State")
        label <- label + this.AddFieldValue(label, row, "Zip")
        printfn $"{label}"
        printfn ""

member _.AddFieldValue(label: string, row: DataRow, fieldName: string) =
    if DBNull.Value.Equals row[fieldName] |> not then
        (string row[fieldName]) + " "
    else
        String.Empty

Private Sub OUtputLabels(dt As DataTable)
   Dim label As String 

   ' Iterate rows of table
   For Each row As DataRow In dt.Rows
      Dim labelLen As Integer
      label = String.Empty
      label += AddFieldValue(label, row, "Title")
      label += AddFieldValue(label, row, "FirstName")
      label += AddFieldValue(label, row, "MiddleInitial")
      label += AddFieldValue(label, row, "LastName")
      label += AddFieldValue(label, row, "Suffix")
      label += vbCrLf
      label += AddFieldValue(label, row, "Address1")
      label += AddFieldValue(label, row, "AptNo")
      label += vbCrLf
      labelLen = Len(label)
      label += AddFieldValue(label, row, "Address2")
      If Len(label) <> labelLen Then label += vbCrLf
      label += AddFieldValue(label, row, "City")
      label += AddFieldValue(label, row, "State")
      label += AddFieldValue(label, row, "Zip")
      Console.WriteLine(label)
      Console.WriteLine()
   Next
End Sub

Private Function AddFieldValue(label As String, row As DataRow, _
                          fieldName As String) As String
   If Not DbNull.Value.Equals(row.Item(fieldName)) Then
      Return CStr(row.Item(fieldName)) & " "
   Else
      Return Nothing
   End If
End Function

Комментарии

Класс DBNull представляет несуществующее значение. Например, в базе данных столбец в строке таблицы может не содержать никаких данных. То есть столбец считается вовсе не существующим, а просто не имеет значения. Объект DBNull представляет несуществующий столбец. Кроме того, COM-взаимодействие использует DBNull класс для различения варианта VT_NULL, указывающего несуществующее значение, и варианта VT_EMPTY, указывающего на неопределенное значение.

Тип DBNull является одноэлементным классом, то есть существует только один DBNull объект. Элемент DBNull.Value представляет единственный DBNull объект . DBNull.Value может использоваться для явного назначения несуществующего значения полю базы данных, хотя большинство поставщиков данных ADO.NET автоматически присваивают значения , DBNull если поле не имеет допустимого значения. Можно определить, является ли значение, полученное из поля базы данных, значением DBNull , передав значение этого поля в DBNull.Value.Equals метод . Однако некоторые языки и объекты базы данных предоставляют методы, упрощающие определение того, равно DBNull.Valueли значение поля базы данных . К ним относятся функция Visual Basic IsDBNull , Convert.IsDBNull метод , DataTableReader.IsDBNull метод и IDataRecord.IsDBNull метод .

Не путайте понятие null в объектно-ориентированном языке программирования с DBNull объектом . В объектно-ориентированном языке null программирования означает отсутствие ссылки на объект. DBNull представляет неинициализированный вариант или несуществующий столбец базы данных.

Поля

Методы

Явные реализации интерфейса

Применяется к

См. также раздел

• DBNull
• IsDBNull(Object)
• VarEnum