DBNull DBNull DBNull DBNull Class

Определение

Представляет несуществующее значение.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
Наследование
DBNullDBNullDBNullDBNull
Атрибуты
Реализации

Примеры

В следующем примере вызывается DBNull.Value.Equals метод, чтобы определить, имеет ли поле базы данных в базе данных контактов является допустимым значением.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, указывает неопределенное значение.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 Тип является singleton-класса, что означает только одно DBNull объект существует.The DBNull type is a singleton class, which means only one DBNull object exists. DBNull.Value Член представляет отдельное DBNull объекта.The 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. К ним относятся Visual Basic IsDBNull функции 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 Value Value Value

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

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

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

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
GetTypeCode() GetTypeCode() GetTypeCode() GetTypeCode()

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

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

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

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

IConvertible.ToBoolean(IFormatProvider) IConvertible.ToBoolean(IFormatProvider) IConvertible.ToBoolean(IFormatProvider) IConvertible.ToBoolean(IFormatProvider)

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

IConvertible.ToByte(IFormatProvider) IConvertible.ToByte(IFormatProvider) IConvertible.ToByte(IFormatProvider) IConvertible.ToByte(IFormatProvider)

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

IConvertible.ToChar(IFormatProvider) IConvertible.ToChar(IFormatProvider) IConvertible.ToChar(IFormatProvider) IConvertible.ToChar(IFormatProvider)

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

IConvertible.ToDateTime(IFormatProvider) IConvertible.ToDateTime(IFormatProvider) IConvertible.ToDateTime(IFormatProvider) IConvertible.ToDateTime(IFormatProvider)

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

IConvertible.ToDecimal(IFormatProvider) IConvertible.ToDecimal(IFormatProvider) IConvertible.ToDecimal(IFormatProvider) IConvertible.ToDecimal(IFormatProvider)

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

IConvertible.ToDouble(IFormatProvider) IConvertible.ToDouble(IFormatProvider) IConvertible.ToDouble(IFormatProvider) IConvertible.ToDouble(IFormatProvider)

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

IConvertible.ToInt16(IFormatProvider) IConvertible.ToInt16(IFormatProvider) IConvertible.ToInt16(IFormatProvider) IConvertible.ToInt16(IFormatProvider)

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

IConvertible.ToInt32(IFormatProvider) IConvertible.ToInt32(IFormatProvider) IConvertible.ToInt32(IFormatProvider) IConvertible.ToInt32(IFormatProvider)

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

IConvertible.ToInt64(IFormatProvider) IConvertible.ToInt64(IFormatProvider) IConvertible.ToInt64(IFormatProvider) IConvertible.ToInt64(IFormatProvider)

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

IConvertible.ToSByte(IFormatProvider) IConvertible.ToSByte(IFormatProvider) IConvertible.ToSByte(IFormatProvider) IConvertible.ToSByte(IFormatProvider)

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

IConvertible.ToSingle(IFormatProvider) IConvertible.ToSingle(IFormatProvider) IConvertible.ToSingle(IFormatProvider) IConvertible.ToSingle(IFormatProvider)

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

IConvertible.ToType(Type, IFormatProvider) IConvertible.ToType(Type, IFormatProvider) IConvertible.ToType(Type, IFormatProvider) IConvertible.ToType(Type, IFormatProvider)

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

IConvertible.ToUInt16(IFormatProvider) IConvertible.ToUInt16(IFormatProvider) IConvertible.ToUInt16(IFormatProvider) IConvertible.ToUInt16(IFormatProvider)

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

IConvertible.ToUInt32(IFormatProvider) IConvertible.ToUInt32(IFormatProvider) IConvertible.ToUInt32(IFormatProvider) IConvertible.ToUInt32(IFormatProvider)

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

IConvertible.ToUInt64(IFormatProvider) IConvertible.ToUInt64(IFormatProvider) IConvertible.ToUInt64(IFormatProvider) IConvertible.ToUInt64(IFormatProvider)

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

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

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