DataColumn Класс

Определение

Пространство имен:

System.Data

Сборки:

netstandard.dll, System.Data.Common.dll

Исходный код:

DataColumn.cs

Представляет схему столбца в объекте DataTable.

public ref class DataColumn : System::ComponentModel::MarshalByValueComponent

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class DataColumn : System.ComponentModel.MarshalByValueComponent

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
type DataColumn = class
    inherit MarshalByValueComponent

Public Class DataColumn
Inherits MarshalByValueComponent

Наследование

Object

MarshalByValueComponent

DataColumn

Атрибуты

DynamicallyAccessedMembersAttribute

Примеры

В следующем примере создается несколько DataTableDataColumn объектов.

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 New DataTable("Product")

    ' Create a DataColumn and set various properties. 
    Dim column As 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. Вы создаете схему, добавляя в него DataColumnCollectionодин или несколько DataColumn объектов. Дополнительные сведения см. в разделе "Добавление столбцов в таблицу данных".

Каждый DataColumn из них имеет DataType свойство, определяющее тип данных, DataColumn содержащихся. Например, можно ограничить тип данных целыми числами, строками или десятичными знаками. Так как данные, содержащиеся в DataTable источнике данных, обычно объединяются обратно в исходный источник данных, необходимо сопоставить типы данных с данными в источнике данных. Дополнительные сведения см. в разделе "Сопоставления типов данных" в ADO.NET.

Такие свойства, как AllowDBNull, Uniqueи ReadOnly ограничения на запись и обновление данных, тем самым помогая гарантировать целостность данных. Вы также можете использовать AutoIncrementAutoIncrementSeedсвойства и AutoIncrementStep свойства для управления автоматическим созданием данных. Дополнительные сведения о столбцах см. в AutoIncrement разделе "Создание столбцов автоинкремента". Дополнительные сведения см. в разделе "Определение первичных ключей".

Кроме того, можно убедиться, что значения в объекте DataColumnUniqueConstraint уникальны, создав и добавив его в ConstraintCollection тот, DataTable к которому DataColumn принадлежит этот объект. Дополнительные сведения см. в разделе "Ограничения DataTable".

Чтобы создать связь между DataColumn объектами DataRelation , создайте объект и добавьте его в DataRelationCollection объект DataSet.

Свойство объекта можно использовать Expression для вычисления значений DataColumn в столбце или создания статистического столбца. Дополнительные сведения см. в разделе "Создание столбцов выражений".

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

Имя	Описание
DataColumn()	Инициализирует новый экземпляр DataColumn класса в виде строки типа.
DataColumn(String, Type, String, MappingType)	Инициализирует новый экземпляр класса с помощью указанного DataColumn имени, типа данных, выражения и значения, определяющего, является ли столбец атрибутом.
DataColumn(String, Type, String)	Инициализирует новый экземпляр класса с помощью указанного DataColumn имени, типа данных и выражения.
DataColumn(String, Type)	Инициализирует новый экземпляр класса с помощью указанного имени столбца DataColumn и типа данных.
DataColumn(String)	Инициализирует новый экземпляр DataColumn класса в виде строки типа, используя указанное имя столбца.

Свойства

Имя	Описание
AllowDBNull	Возвращает или задает значение, указывающее, разрешены ли значения NULL в этом столбце для строк, принадлежащих таблице.
AutoIncrement	Возвращает или задает значение, указывающее, увеличивает ли столбец значение столбца для новых строк, добавленных в таблицу.
AutoIncrementSeed	Возвращает или задает начальное значение для столбца, в котором задано trueего AutoIncrement свойство. Значение по умолчанию — 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 и не предназначен для использования непосредственно из кода.
CheckUnique()	Этот элемент поддерживает инфраструктуру .NET и не предназначен для использования непосредственно из кода.
Dispose()	Освобождает все ресурсы, используемые параметром MarshalByValueComponent. (Унаследовано от MarshalByValueComponent)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые MarshalByValueComponent и при необходимости освобождает управляемые ресурсы. (Унаследовано от MarshalByValueComponent)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetService(Type)	Возвращает реализующего объект IServiceProvider. (Унаследовано от MarshalByValueComponent)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnPropertyChanging(PropertyChangedEventArgs)	Этот элемент поддерживает инфраструктуру .NET и не предназначен для использования непосредственно из кода.
RaisePropertyChanging(String)	Этот элемент поддерживает инфраструктуру .NET и не предназначен для использования непосредственно из кода.
SetOrdinal(Int32)	Изменяет порядковый номер или положение указанного DataColumn порядкового номера или позиции.
ToString()	Expression Возвращает столбец, если он существует.

События

Имя	Описание
Disposed	Добавляет обработчик событий для прослушивания Disposed события компонента. (Унаследовано от MarshalByValueComponent)

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

Этот тип является безопасным для многопоточных операций чтения. Необходимо синхронизировать все операции записи.

См. также раздел

• Add(DataColumn)
• DataColumnCollection
• Constraints
• ConstraintCollection
• DataGrid
• DataRow
• DataTable
• DataSet
• NewRow()
• DataRowCollection
• UniqueConstraint
• Использование наборов данных в ADO.NET