DBNull Класс

Определение

Представляет несуществующее значение.Represents a nonexistent value. Этот класс не наследуется.This class cannot be inherited.

public ref class DBNull sealed : IConvertible, System::Runtime::Serialization::ISerializable
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public sealed class DBNull : IConvertible, System.Runtime.Serialization.ISerializable
type DBNull = class
    interface ISerializable
    interface IConvertible
Public NotInheritable Class DBNull
Implements IConvertible, ISerializable
Наследование
DBNull
Атрибуты
Реализации

Примеры

В следующем примере вызывается DBNull.Value.Equals метод, чтобы определить, имеет ли поле базы данных Contacts допустимое значение.The following example calls the DBNull.Value.Equals method to determine whether a database field in a contacts database has a valid value. Если это так, значение поля добавляется к строковому выходу в метке.If it does, the field value is appended to the string output in a label.

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;
}
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 Класс представляет несуществующее значение.The DBNull class represents a nonexistent value. Например, в базе данных столбец в строке таблицы может не содержать никаких данных.In a database, for example, a column in a row of a table might not contain any data whatsoever. То есть столбец считается несуществующим, а не просто не имеет значения.That is, the column is considered to not exist at all instead of merely not having a value. DBNull Объект представляет несуществующий столбец.A DBNull object represents the nonexistent column. Кроме того, COM-взаимодействие DBNull использует класс для различения варианта VT_NULL, который указывает на несуществующее значение, и VT_EMPTY Variant, который указывает на неопределенное значение.Additionally, COM interop uses the DBNull class to distinguish between a VT_NULL variant, which indicates a nonexistent value, and a VT_EMPTY variant, which indicates an unspecified value.

Тип является одноэлементным классом, то есть существует DBNull только один объект. DBNullThe DBNull type is a singleton class, which means only one DBNull object exists. Член представляет единственный DBNullобъект. DBNull.ValueThe DBNull.Value member represents the sole DBNull object. DBNull.Valueможно использовать для явного присвоения несуществующего значения полю базы данных, хотя большинство поставщиков ADO.NET данных автоматически присваивают значения DBNull , если поле не имеет допустимого значения.DBNull.Value can be used to explicitly assign a nonexistent value to a database field, although most ADO.NET data providers automatically assign values of DBNull when a field does not have a valid value. Можно определить, является DBNull ли значение, полученное из поля базы данных, значением, передав значение этого поля DBNull.Value.Equals в метод.You can determine whether a value retrieved from a database field is a DBNull value by passing the value of that field to the DBNull.Value.Equals method. Однако некоторые языки и объекты базы данных предоставляют методы, упрощающие определение, является DBNull.Valueли значение поля базы данных.However, some languages and database objects supply methods that make it easier to determine whether the value of a database field is DBNull.Value. К ним относятся функция IsDBNull Visual Basic Convert.IsDBNull , метод, DataTableReader.IsDBNull метод и IDataRecord.IsDBNull метод.These include the Visual Basic IsDBNull function, the Convert.IsDBNull method, the DataTableReader.IsDBNull method, and the IDataRecord.IsDBNull method.

Не путайте понятие null в объектно-ориентированном языке программирования DBNull с объектом.Do not confuse the notion of null in an object-oriented programming language with a DBNull object. В объектно-ориентированном языке null программирования означает отсутствие ссылки на объект.In an object-oriented programming language, null means the absence of a reference to an object. DBNullпредставляет неинициализированный вариант или несуществующий столбец базы данных.DBNull represents an uninitialized variant or nonexistent database column.

Поля

Value

Представляет единственный экземпляр класса DBNull.Represents the sole instance of the DBNull class.

Методы

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)

Реализует интерфейс ISerializable и возвращает данные, необходимые для сериализации объекта DBNull.Implements the ISerializable interface and returns the data needed to serialize the DBNull object.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
GetTypeCode()

Возвращает значение TypeCode для объекта DBNull.Gets the TypeCode value for DBNull.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает пустую строку (Empty).Returns an empty string (Empty).

ToString(IFormatProvider)

Возвращает пустую строку, используя заданный объект IFormatProvider.Returns an empty string using the specified IFormatProvider.

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

IConvertible.ToBoolean(IFormatProvider)

Данное преобразование не поддерживается.This conversion is not supported. Попытка выполнить такое преобразование приведет к возникновению исключения InvalidCastException.Attempting to make this conversion throws an InvalidCastException.

IConvertible.ToByte(IFormatProvider)

Данное преобразование не поддерживается.This conversion is not supported. Попытка выполнить такое преобразование приведет к возникновению исключения InvalidCastException.Attempting to make this conversion throws an InvalidCastException.

IConvertible.ToChar(IFormatProvider)

Данное преобразование не поддерживается.This conversion is not supported. Попытка выполнить такое преобразование приведет к возникновению исключения InvalidCastException.Attempting to make this conversion throws an InvalidCastException.

IConvertible.ToDateTime(IFormatProvider)

Данное преобразование не поддерживается.This conversion is not supported. Попытка выполнить такое преобразование приведет к возникновению исключения InvalidCastException.Attempting to make this conversion throws an InvalidCastException.

IConvertible.ToDecimal(IFormatProvider)

Данное преобразование не поддерживается.This conversion is not supported. Попытка выполнить такое преобразование приведет к возникновению исключения InvalidCastException.Attempting to make this conversion throws an InvalidCastException.

IConvertible.ToDouble(IFormatProvider)

Данное преобразование не поддерживается.This conversion is not supported. Попытка выполнить такое преобразование приведет к возникновению исключения InvalidCastException.Attempting to make this conversion throws an InvalidCastException.

IConvertible.ToInt16(IFormatProvider)

Данное преобразование не поддерживается.This conversion is not supported. Попытка выполнить такое преобразование приведет к возникновению исключения InvalidCastException.Attempting to make this conversion throws an InvalidCastException.

IConvertible.ToInt32(IFormatProvider)

Данное преобразование не поддерживается.This conversion is not supported. Попытка выполнить такое преобразование приведет к возникновению исключения InvalidCastException.Attempting to make this conversion throws an InvalidCastException.

IConvertible.ToInt64(IFormatProvider)

Данное преобразование не поддерживается.This conversion is not supported. Попытка выполнить такое преобразование приведет к возникновению исключения InvalidCastException.Attempting to make this conversion throws an InvalidCastException.

IConvertible.ToSByte(IFormatProvider)

Данное преобразование не поддерживается.This conversion is not supported. Попытка выполнить такое преобразование приведет к возникновению исключения InvalidCastException.Attempting to make this conversion throws an InvalidCastException.

IConvertible.ToSingle(IFormatProvider)

Данное преобразование не поддерживается.This conversion is not supported. Попытка выполнить такое преобразование приведет к возникновению исключения InvalidCastException.Attempting to make this conversion throws an InvalidCastException.

IConvertible.ToType(Type, IFormatProvider)

Преобразует текущий объект DBNull в объект заданного типа.Converts the current DBNull object to the specified type.

IConvertible.ToUInt16(IFormatProvider)

Данное преобразование не поддерживается.This conversion is not supported. Попытка выполнить такое преобразование приведет к возникновению исключения InvalidCastException.Attempting to make this conversion throws an InvalidCastException.

IConvertible.ToUInt32(IFormatProvider)

Данное преобразование не поддерживается.This conversion is not supported. Попытка выполнить такое преобразование приведет к возникновению исключения InvalidCastException.Attempting to make this conversion throws an InvalidCastException.

IConvertible.ToUInt64(IFormatProvider)

Данное преобразование не поддерживается.This conversion is not supported. Попытка выполнить такое преобразование приведет к возникновению исключения InvalidCastException.Attempting to make this conversion throws an InvalidCastException.

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

Дополнительно