http://msdn.microsoft.com/zh-cn/library/system.data.datacolumn(v=vs.80).aspx
DataColumn 类
表示 DataTable 中的列的架构。
命名空间: System.Data
程序集: System.Data(在 System.Data.dll 中)
DataColumn 类型公开以下成员。
名称 | 说明 | |
---|---|---|
DataColumn() | 将 DataColumn 类的新实例初始化为类型字符串。 | |
DataColumn(String) | 使用指定的列名称将 DataColumn 类的新实例初始化为类型字符串。 | |
DataColumn(String, Type) | 使用指定列名称和数据类型初始化 DataColumn 类的新实例。 | |
DataColumn(String, Type, String) | 使用指定的名称、数据类型和表达式初始化 DataColumn 类的新实例。 | |
DataColumn(String, Type, String, MappingType) | 使用指定名称、数据类型、表达式和确定列是否为特性的值,初始化 DataColumn 类的新实例。 |
名称 | 说明 | |
---|---|---|
AllowDBNull | 获取或设置一个值,该值指示对于属于该表的行,此列中是否允许空值。 | |
AutoIncrement | 获取或设置一个值,该值指示对于添加到该表中的新行,列是否将列的值自动递增。 | |
AutoIncrementSeed | 获取或设置其 AutoIncrement 属性设置为 true 的列的起始值。 默认值为 0。 | |
AutoIncrementStep | 获取或设置其 AutoIncrement 属性设置为 true 的列使用的增量。 | |
Caption | 获取或设置列的标题。 | |
ColumnMapping | 获取或设置列的 MappingType。 | |
ColumnName | 获取或设置 DataColumnCollection 中的列的名称。 | |
Container | 获取组件的容器。 (继承自 MarshalByValueComponent。) | |
DataType | 获取或设置存储在列中的数据的类型。 | |
DateTimeMode | 获取或设置列的 DateTimeMode。 | |
DefaultValue | 在创建新行时获取或设置列的默认值。 | |
DesignMode | 获取指示组件当前是否处于设计模式的值。 (继承自 MarshalByValueComponent。) | |
Events | 获取附加到该组件的事件处理程序的列表。 (继承自 MarshalByValueComponent。) | |
Expression | 获取或设置表达式,用于筛选行、计算列中的值或创建聚合列。 | |
ExtendedProperties | 获取与 DataColumn 相关的自定义用户信息的集合。 | |
MaxLength | 获取或设置文本列的最大长度。 | |
Namespace | 获取或设置 DataColumn 的命名空间。 | |
Ordinal | 获取列在 DataColumnCollection 集合中的位置(从零开始)。 | |
Prefix | 获取或设置一个 XML 前缀,该前缀是 DataTable 的命名空间的别名。 | |
ReadOnly | 获取或设置一个值,该值指示一旦向表中添加了行,列是否还允许更改。 | |
Site | 获取或设置组件的位置。 (继承自 MarshalByValueComponent。) | |
Table | 获取列所属的 DataTable。 | |
Unique | 获取或设置一个值,该值指示列的每一行中的值是否必须是唯一的。 |
名称 | 说明 | |
---|---|---|
CheckNotAllowNull | 基础结构。该成员支持 .NET Framework 结构,不应从代码直接使用。 | |
CheckUnique | 基础结构。该成员支持 .NET Framework 结构,不应从代码直接使用。 | |
Dispose() | 释放由 MarshalByValueComponent 使用的所有资源。 (继承自 MarshalByValueComponent。) | |
Dispose(Boolean) | 释放由 MarshalByValueComponent 占用的非托管资源,还可以另外再释放托管资源。 (继承自 MarshalByValueComponent。) | |
Equals(Object) | 确定指定的对象是否等于当前对象。 (继承自 Object。) | |
Finalize | 允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。 (继承自 MarshalByValueComponent。) | |
GetHashCode | 作为默认哈希函数。 (继承自 Object。) | |
GetService | 获取 IServiceProvider 的实施者。 (继承自 MarshalByValueComponent。) | |
GetType | 获取当前实例的 Type。 (继承自 Object。) | |
MemberwiseClone | 创建当前 Object 的浅表副本。 (继承自 Object。) | |
OnPropertyChanging | 该成员支持 .NET Framework 结构,不应从代码直接使用。 | |
RaisePropertyChanging | 该成员支持 .NET Framework 结构,不应从代码直接使用。 | |
SetOrdinal | 将 DataColumn 的序号或位置更改为指定的序号或位置。 | |
ToString | 获取列的 Expression(如果存在的话)。 (重写 MarshalByValueComponent.ToString()。) |
The DataColumn is the fundamental building block for creating the schema of a DataTable. You build the schema by adding one or more DataColumn objects to theDataColumnCollection. For more information, see 向数据表中添加列.
Each DataColumn has a DataType property that determines the kind of data the DataColumn contains. For example, you can restrict the data type to integers, or strings, or decimals. Because data that is contained by the DataTable is typically merged back into its original data source, you must match the data types to those in the data source. For more information, see ADO.NET 中的数据类型映射.
Properties such as AllowDBNull, Unique, and ReadOnly put restrictions on the entry and updating of data, thereby helping to guarantee data integrity. You can also use theAutoIncrement, AutoIncrementSeed, and AutoIncrementStep properties to control automatic data generation. For more information about AutoIncrement columns, see 创建 AutoIncrement 列. For more information, see 定义主键.
You can also make sure that values in a DataColumn are unique by creating a UniqueConstraint and adding it to the ConstraintCollection of the DataTable to which theDataColumn belongs. For more information, see 数据表约束.
To create a relation between DataColumn objects, create a DataRelation object and add it to the DataRelationCollection of a DataSet.
You can use the Expression property of the DataColumn object to calculate the values in a column, or create an aggregate column. For more information, see 创建表达式列.
The following example creates a DataTable with several DataColumn objects.
private void MakeTable() { // Create a DataTable. DataTable table = new DataTable("Product"); // Create a DataColumn and set various properties. DataColumn column = new DataColumn(); column.DataType = System.Type.GetType("System.Decimal"); column.AllowDBNull = false; column.Caption = "Price"; column.ColumnName = "Price"; column.DefaultValue = 25; // Add the column to the table. table.Columns.Add(column); // Add 10 rows and set values. DataRow row; for(int i = 0; i < 10; i++) { row = table.NewRow(); row["Price"] = i + 1; // Be sure to add the new row to the // DataRowCollection. table.Rows.Add(row); } }
Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008(不支持服务器核心角色), Windows Server 2008 R2(支持带 SP1 或更高版本的服务器核心角色;不支持 Itanium)
.NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参阅.NET Framework 系统要求。