DataColumn DataColumn DataColumn DataColumn Class

Определение

Представляет схему столбца в DataTable.Represents the schema of a column in a DataTable.

public ref class DataColumn : System::ComponentModel::MarshalByValueComponent
public class DataColumn : System.ComponentModel.MarshalByValueComponent
type DataColumn = class
    inherit MarshalByValueComponent
Public Class DataColumn
Inherits MarshalByValueComponent
Наследование

Примеры

В следующем примере создается DataTable с несколькими DataColumn объектов.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); 
    } 
}
Private Sub MakeTable()
    ' Create a DataTable. 
    Dim table As DataTable = new DataTable("Product") 

    ' Create a DataColumn and set various properties. 
    Dim column As DataColumn = 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. 
    Dim row As DataRow 
    Dim i As Integer  
    For i = 0 to 9 
        row = table.NewRow() 
        row("Price") = i + 1 

        ' Be sure to add the new row to 
        ' the DataRowCollection. 
        table.Rows.Add(row) 
    Next i 
End Sub

Комментарии

DataColumn — Это фундаментальный блок построения для создания схемы DataTable.The DataColumn is the fundamental building block for creating the schema of a DataTable. Создание схемы, добавив один или несколько DataColumn объектов DataColumnCollection.You build the schema by adding one or more DataColumn objects to the DataColumnCollection. Дополнительные сведения см. в разделе Добавление столбцов к таблице DataTable.For more information, see Adding Columns to a DataTable.

Каждый DataColumn имеет DataType свойство, которое определяет, какие данные DataColumn содержит.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. Так как данных, содержащихся в DataTable обычно объединяются в его исходный источник данных, вы должны совпадать с типами данных к строкам в источнике данных.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. Дополнительные сведения см. в разделе сопоставления типов данных в ADO.NET.For more information, see Data Type Mappings in ADO.NET.

Свойства, такие как AllowDBNull, Unique, и ReadOnly устанавливать ограничения на ввод и обновление данных, тем самым помогая обеспечить целостность данных.Properties such as AllowDBNull, Unique, and ReadOnly put restrictions on the entry and updating of data, thereby helping to guarantee data integrity. Можно также использовать AutoIncrement, AutoIncrementSeed, и AutoIncrementStep свойства для управления автоматическим созданием данных.You can also use the AutoIncrement, AutoIncrementSeed, and AutoIncrementStep properties to control automatic data generation. Дополнительные сведения о AutoIncrement столбцы, см. в разделе Создание столбцов AutoIncrement.For more information about AutoIncrement columns, see Creating AutoIncrement Columns. Дополнительные сведения см. в разделе Определение первичных ключей.For more information, see Defining Primary Keys.

Также можно убедиться в том, что значения в DataColumn уникальны, создав UniqueConstraint и добавления его в ConstraintCollection из DataTable к которому DataColumn принадлежит.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 the DataColumn belongs. Дополнительные сведения см. в разделе ограничения таблиц данных.For more information, see DataTable Constraints.

Для создания отношения между DataColumn объекты, создают DataRelation и добавьте его к DataRelationCollection из DataSet.To create a relation between DataColumn objects, create a DataRelation object and add it to the DataRelationCollection of a DataSet.

Можно использовать Expression свойство DataColumn объекта для вычисления значений в столбце, или создания составного столбца.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 Creating Expression Columns.

Конструкторы

DataColumn() DataColumn() DataColumn() DataColumn()

Инициализирует новый экземпляр класса DataColumn в качестве строкового типа.Initializes a new instance of a DataColumn class as type string.

DataColumn(String) DataColumn(String) DataColumn(String) DataColumn(String)

Инициализирует новый экземпляр класса DataColumn как строку типа с использованием указанного имени столбца.Initializes a new instance of the DataColumn class, as type string, using the specified column name.

DataColumn(String, Type) DataColumn(String, Type) DataColumn(String, Type) DataColumn(String, Type)

Инициализирует новый экземпляр класса DataColumn с использованием указанного имени столбца и типа данных.Initializes a new instance of the DataColumn class using the specified column name and data type.

DataColumn(String, Type, String) DataColumn(String, Type, String) DataColumn(String, Type, String) DataColumn(String, Type, String)

Инициализирует новый экземпляр класса DataColumn с использованием указанного имени, типа данных и выражения.Initializes a new instance of the DataColumn class using the specified name, data type, and expression.

DataColumn(String, Type, String, MappingType) DataColumn(String, Type, String, MappingType) DataColumn(String, Type, String, MappingType) DataColumn(String, Type, String, MappingType)

Инициализирует новый экземпляр класса DataColumn с использованием указанного имени, типа данных, выражения и значения, определяющего, является ли столбец атрибутом.Initializes a new instance of the DataColumn class using the specified name, data type, expression, and value that determines whether the column is an attribute.

Свойства

AllowDBNull AllowDBNull AllowDBNull AllowDBNull

Возвращает или задает значение, указывающее на допустимость нулевых значений в этом столбце для строк, принадлежащих таблице.Gets or sets a value that indicates whether null values are allowed in this column for rows that belong to the table.

AutoIncrement AutoIncrement AutoIncrement AutoIncrement

Возвращает или задает значение, показывающее, увеличивать ли автоматически значение столбца для новых строк, добавляемых в таблицу.Gets or sets a value that indicates whether the column automatically increments the value of the column for new rows added to the table.

AutoIncrementSeed AutoIncrementSeed AutoIncrementSeed AutoIncrementSeed

Возвращает или задает начальное значение для столбца, свойству которого AutoIncrement задано значение true.Gets or sets the starting value for a column that has its AutoIncrement property set to true. Значение по умолчанию — 0.The default is 0.

AutoIncrementStep AutoIncrementStep AutoIncrementStep AutoIncrementStep

Возвращает или задает шаг приращения для столбца, свойству AutoIncrement которого задано значение true.Gets or sets the increment used by a column with its AutoIncrement property set to true.

Caption Caption Caption Caption

Возвращает или задает заголовок для столбца.Gets or sets the caption for the column.

ColumnMapping ColumnMapping ColumnMapping ColumnMapping

Возвращает или задает MappingType столбца.Gets or sets the MappingType of the column.

ColumnName ColumnName ColumnName ColumnName

Возвращает или задает имя столбца в DataColumnCollection.Gets or sets the name of the column in the DataColumnCollection.

Container Container Container Container

Возвращает контейнер для компонента.Gets the container for the component.

(Inherited from MarshalByValueComponent)
DataType DataType DataType DataType

Возвращает или задает тип данных, хранимых в столбце.Gets or sets the type of data stored in the column.

DateTimeMode DateTimeMode DateTimeMode DateTimeMode

Возвращает или задает DateTimeMode для столбца.Gets or sets the DateTimeMode for the column.

DefaultValue DefaultValue DefaultValue DefaultValue

Возвращает или задает значение по умолчанию для столбца при создании новых строк.Gets or sets the default value for the column when you are creating new rows.

DesignMode DesignMode DesignMode DesignMode

Возвращает значение, показывающее, находится ли компонент в настоящий момент в режиме разработки.Gets a value indicating whether the component is currently in design mode.

(Inherited from MarshalByValueComponent)
Events Events Events Events

Возвращает список обработчиков событий, которые прикреплены к этому компоненту.Gets the list of event handlers that are attached to this component.

(Inherited from MarshalByValueComponent)
Expression Expression Expression Expression

Возвращает или задает выражение, используемое для фильтрации строк, расчета значений в столбце либо для создания составного столбца.Gets or sets the expression used to filter rows, calculate the values in a column, or create an aggregate column.

ExtendedProperties ExtendedProperties ExtendedProperties ExtendedProperties

Возвращает коллекцию пользовательских сведений, связанных с DataColumn.Gets the collection of custom user information associated with a DataColumn.

MaxLength MaxLength MaxLength MaxLength

Возвращает или задает максимальную длину текстового столбца.Gets or sets the maximum length of a text column.

Namespace Namespace Namespace Namespace

Возвращает или задает пространство имен DataColumn.Gets or sets the namespace of the DataColumn.

Ordinal Ordinal Ordinal Ordinal

Возвращает отсчитываемую от нуля позицию столбца в коллекции DataColumnCollection.Gets the (zero-based) position of the column in the DataColumnCollection collection.

Prefix Prefix Prefix Prefix

Возвращает или задает префикс XML, который является псевдонимом пространства имен класса DataTable.Gets or sets an XML prefix that aliases the namespace of the DataTable.

ReadOnly ReadOnly ReadOnly ReadOnly

Возвращает или задает значение, указывающее на допустимость изменения столбца после добавления строки в таблицу.Gets or sets a value that indicates whether the column allows for changes as soon as a row has been added to the table.

Site Site Site Site

Получает или задает узел компонента.Gets or sets the site of the component.

(Inherited from MarshalByValueComponent)
Table Table Table Table

Возвращает DataTable, которому принадлежит столбец.Gets the DataTable to which the column belongs to.

Unique Unique Unique Unique

Возвращает или задает значение, указывающее, должны ли значения в каждой строке столбца быть уникальными.Gets or sets a value that indicates whether the values in each row of the column must be unique.

Методы

CheckNotAllowNull() CheckNotAllowNull() CheckNotAllowNull() CheckNotAllowNull()

Данный член предназначен для поддержки платформы .NET Framework и не должен вызываться напрямую из кода приложения.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

CheckUnique() CheckUnique() CheckUnique() CheckUnique()

Данный член предназначен для поддержки платформы .NET Framework и не должен вызываться напрямую из кода приложения.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Dispose() Dispose() Dispose() Dispose()

Освобождает все ресурсы, используемые объектом MarshalByValueComponent.Releases all resources used by the MarshalByValueComponent.

(Inherited from MarshalByValueComponent)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом MarshalByValueComponent, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the MarshalByValueComponent and optionally releases the managed resources.

(Inherited from MarshalByValueComponent)
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)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Возвращает средство реализации объекта IServiceProvider.Gets the implementer of the IServiceProvider.

(Inherited from MarshalByValueComponent)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs)

Данный член предназначен для поддержки платформы .NET Framework и не должен вызываться напрямую из кода приложения.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

RaisePropertyChanging(String) RaisePropertyChanging(String) RaisePropertyChanging(String) RaisePropertyChanging(String)

Данный член предназначен для поддержки платформы .NET Framework и не должен вызываться напрямую из кода приложения.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

SetOrdinal(Int32) SetOrdinal(Int32) SetOrdinal(Int32) SetOrdinal(Int32)

Изменяет порядковый номер или положение DataColumn на указанный порядковый номер или положение.Changes the ordinal or position of the DataColumn to the specified ordinal or position.

ToString() ToString() ToString() ToString()

Возвращает свойство Expression столбца, если оно существует.Gets the Expression of the column, if one exists.

События

Disposed Disposed Disposed Disposed

Добавляет обработчик событий, чтобы прослушивать событие Disposed для компонента.Adds an event handler to listen to the Disposed event on the component.

(Inherited from MarshalByValueComponent)

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

Потокобезопасность

Этот тип является безопасным для многопоточных операций чтения.This type is safe for multithreaded read operations. Необходимо синхронизировать все операции записи.You must synchronize any write operations.

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