DataColumn Класс

Определение

Представляет схему столбца в 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 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

Комментарии

Является фундаментальным стандартным блоком для создания схемы DataTable. DataColumnThe 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. Дополнительные сведения см. в разделе Добавление столбцов в таблицуданных.For more information, see Adding Columns to a DataTable.

Каждый DataColumn DataColumn имеет свойство, определяющее тип данных, которые содержит. DataTypeEach 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. Для управления автоматическим созданием AutoIncrementSeedданных можно AutoIncrementStep также использовать AutoIncrementсвойства, и.You can also use the AutoIncrement, AutoIncrementSeed, and AutoIncrementStep properties to control automatic data generation. Дополнительные сведения о 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. Дополнительные сведения см. в разделе ограничения DataTable.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 в качестве строкового типа.Initializes a new instance of a DataColumn class as type string.

DataColumn(String)

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

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 с использованием указанного имени, типа данных и выражения.Initializes a new instance of the DataColumn class using the specified name, data type, and expression.

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

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

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

Возвращает или задает начальное значение для столбца, свойству которого 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

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

Caption

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

ColumnMapping

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

ColumnName

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

Container

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

(Унаследовано от MarshalByValueComponent)
DataType

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

DateTimeMode

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

DefaultValue

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

DesignMode

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

(Унаследовано от MarshalByValueComponent)
Events

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

(Унаследовано от MarshalByValueComponent)
Expression

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

ExtendedProperties

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

MaxLength

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

Namespace

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

Ordinal

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

Prefix

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

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

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

(Унаследовано от MarshalByValueComponent)
Table

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

Unique

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

Методы

CheckNotAllowNull()

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

CheckUnique()

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

Dispose()

Освобождает все ресурсы, занятые модулем MarshalByValueComponent.Releases all resources used by the MarshalByValueComponent.

(Унаследовано от MarshalByValueComponent)
Dispose(Boolean)

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

(Унаследовано от MarshalByValueComponent)
Equals(Object)

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

(Унаследовано от Object)
GetHashCode()

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

(Унаследовано от Object)
GetService(Type)

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

(Унаследовано от MarshalByValueComponent)
GetType()

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

(Унаследовано от Object)
MemberwiseClone()

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

(Унаследовано от Object)
OnPropertyChanging(PropertyChangedEventArgs)

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

RaisePropertyChanging(String)

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

SetOrdinal(Int32)

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

ToString()

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

События

Disposed

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

(Унаследовано от MarshalByValueComponent)

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

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

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

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