Describes the serialization format for DateTime columns in a System.Data.DataSet.
Syntax
Remarks
System.Data.DataSetDateTime cannot be set on non-DateTime columns. Setting the DataColumn.DateTimeMode property with the default value DataSetDateTime.UnspecifiedLocall on non-DateTime columns is permitted. Modifying the column data type from DateTime to any other type resets the DataColumn.DateTimeMode to the default value DataSetDateTime.UnspecifiedLocal.
Checking schema for merging, Relations, and ForeignKeyConstraints can be performed between DateTime columns with matching DataColumn.DateTimeMode properties. Otherwise the columns should be considered as non-matching on schema. The only exception is between DataSetDateTime.Unspecified and DataSetDateTime.UnspecifiedLocal. It is permitted to have a relation or a ForeignKeyConstraint between two DateTime columns with one in Unspecified and other in UnspecifiedLocal DataColumn.DateTimeMode.
Members
| Member Name | Description |
|---|---|
| Local |
DateTime is always stored in Local. If DataSetDateTime.Utc or DataSetDateTime.Unspecified is assigned to a column in this mode, it is first converted into Local. Serialization in this mode is always performed in Local. There is an offset during serialization. |
| Unspecified |
DateTime is always stored in Unspecified. If DataSetDateTime.Local or DataSetDateTime.Utc is assigned to a column in this mode, it is first converted into DataSetDateTime.Unspecified. Serialization in this mode does not cause an offset. |
| UnspecifiedLocal |
DateTime is stored in Unspecified. If DataSetDateTime.Local or DataSetDateTime.Utc is assigned to a column in this mode, it is first converted into DataSetDateTime.Unspecified. Serialization in this mode causes offset. This is the default behavior and is backward compatible. This option should be thought of as being Unspecified in storage but applying an offset that is similar to DataSetDateTime.Local during serialization. |
| Utc |
DateTime is stored in Universal Coordinated Time (UTC). If DataSetDateTime.Local or DataSetDateTime.Unspecified is assigned to a column in this mode, it is first converted into Utc format. Serialization in this mode is always performed in Utc. There is no offset during serialization. |
Requirements
Assembly: System.Data (in System.Data.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0