Прочитать на английском

Поделиться через


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

Определение

Инициализирует новый экземпляр класса DataColumn.

Перегрузки

DataColumn()

Инициализирует новый экземпляр класса в DataColumn виде строки типа.

DataColumn(String)

Инициализирует новый экземпляр класса DataColumn как строку типа с использованием указанного имени столбца.

DataColumn(String, Type)

Инициализирует новый экземпляр класса DataColumn с использованием указанного имени столбца и типа данных.

DataColumn(String, Type, String)

Инициализирует новый экземпляр класса DataColumn с использованием указанного имени, типа данных и выражения.

DataColumn(String, Type, String, MappingType)

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

DataColumn()

Исходный код:
DataColumn.cs
Исходный код:
DataColumn.cs
Исходный код:
DataColumn.cs

Инициализирует новый экземпляр класса в DataColumn виде строки типа.

public DataColumn ();

Примеры

В следующем примере создается новый DataColumnобъект , устанавливаются различные свойства и добавляются в DataColumnCollection объект для DataTable объекта .

private void AddDataColumn(DataTable table)
{
    DataColumn column = new DataColumn();

    // Set various properties.
    column.ColumnName = "id";
    column.DataType = System.Type.GetType("System.Int32");
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1;
    column.AutoIncrementStep = 1;
    column.ReadOnly = true;

    // Add to Columns collection.
    table.Columns.Add(column);
}

Комментарии

При создании DataColumn объект не имеет значения по умолчанию ColumnName или Caption. При добавлении DataColumnCollectionего в будет создано имя по умолчанию ("Столбец1", "Столбец2" и т. д.), если имя не было назначено ColumnName.

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

DataColumn(String)

Исходный код:
DataColumn.cs
Исходный код:
DataColumn.cs
Исходный код:
DataColumn.cs

Инициализирует новый экземпляр класса DataColumn как строку типа с использованием указанного имени столбца.

public DataColumn (string? columnName);
public DataColumn (string columnName);

Параметры

columnName
String

Строка, представляющая имя создаваемого столбца. Если установлено значение null или пустая строка (""), то при добавлении объекта в коллекцию столбцов будет задано имя по умолчанию.

Примеры

В следующем примере создается новый DataColumn объект с указанным ColumnName.

private void AddDataColumn(DataTable table)
{
    DataColumn column = new DataColumn("id");

    // Set various properties.
    column.DataType = System.Type.GetType("System.Int32");
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1;
    column.AutoIncrementStep = 1;
    column.ReadOnly = true;

    // Add to Columns collection.
    table.Columns.Add(column);
}

Комментарии

По умолчанию имя, относящееся к столбцу, становится значением Caption свойства.

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

DataColumn(String, Type)

Исходный код:
DataColumn.cs
Исходный код:
DataColumn.cs
Исходный код:
DataColumn.cs

Инициализирует новый экземпляр класса DataColumn с использованием указанного имени столбца и типа данных.

public DataColumn (string? columnName, Type dataType);
public DataColumn (string columnName, Type dataType);

Параметры

columnName
String

Строка, представляющая имя создаваемого столбца. Если установлено значение null или пустая строка (""), то при добавлении объекта в коллекцию столбцов будет задано имя по умолчанию.

dataType
Type

Поддерживаемый DataType.

Исключения

dataType не был указан.

Примеры

В следующем примере создается новый DataColumn объект с указанными ColumnName и DataType.

private void AddDataColumn(DataTable table)
{
    System.Type typeInt32 =
        System.Type.GetType("System.Int32");
    DataColumn column = new DataColumn("id", typeInt32);

    // Set various properties.
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1;
    column.AutoIncrementStep = 1;
    column.ReadOnly = true;

    // Add to Columns collection.
    table.Columns.Add(column);
}

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

DataColumn(String, Type, String)

Исходный код:
DataColumn.cs
Исходный код:
DataColumn.cs
Исходный код:
DataColumn.cs

Инициализирует новый экземпляр класса DataColumn с использованием указанного имени, типа данных и выражения.

public DataColumn (string? columnName, Type dataType, string? expr);
public DataColumn (string columnName, Type dataType, string expr);

Параметры

columnName
String

Строка, представляющая имя создаваемого столбца. Если установлено значение null или пустая строка (""), то при добавлении объекта в коллекцию столбцов будет задано имя по умолчанию.

dataType
Type

Поддерживаемый DataType.

expr
String

Выражение, используемое для создания этого столбца. Дополнительные сведения см. в описании свойства Expression.

Исключения

dataType не был указан.

Примеры

В следующем примере создается вычисляемый столбец.

private void AddDataColumn(DataTable table)
{
    System.Type decimalType;
    decimalType = System.Type.GetType("System.Decimal");

    // Create the column. The name is 'Tax,' with data type Decimal,and
    // an expression ('UnitPrice * .0862) to calculate the tax.
    DataColumn column = new DataColumn("Tax",
        decimalType, "UnitPrice * .0862");

    // Set various properties.
    column.AutoIncrement = false;
    column.ReadOnly = true;

    // Add to Columns collection.;
    table.Columns.Add(column);
}

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

DataColumn(String, Type, String, MappingType)

Исходный код:
DataColumn.cs
Исходный код:
DataColumn.cs
Исходный код:
DataColumn.cs

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

public DataColumn (string? columnName, Type dataType, string? expr, System.Data.MappingType type);
public DataColumn (string columnName, Type dataType, string expr, System.Data.MappingType type);

Параметры

columnName
String

Строка, представляющая имя создаваемого столбца. Если установлено значение null или пустая строка (""), то при добавлении объекта в коллекцию столбцов будет задано имя по умолчанию.

dataType
Type

Поддерживаемый DataType.

expr
String

Выражение, используемое для создания этого столбца. Дополнительные сведения см. в описании свойства Expression.

type
MappingType

Одно из значений перечисления MappingType.

Исключения

dataType не был указан.

Примеры

В следующем примере создается вычисляемый столбец.

private void CreateComputedColumn(DataTable table)
{
    System.Type myDataType =
        System.Type.GetType("System.Decimal");

    // The expression multiplies the "Price" column value
    // by the "Quantity" to create the "Total" column.
    string expression = "Price * Quantity";

    // Create the column, setting the type to Attribute.
    DataColumn column = new DataColumn("Total", myDataType,
        expression, MappingType.Attribute);

    // Set various properties.
    column.AutoIncrement = false;
    column.ReadOnly = true;

    // Add the column to a DataTable object's to DataColumnCollection.
    DataSet1.Tables["OrderDetails"].Columns.Add(column);
}

Комментарии

Аргумент type задает ColumnMapping свойство . Свойство указывает, как DataColumn сопоставляется при DataSet преобразовании в XML-документ. Например, если столбец имеет имя "fName", а его значение равно "Bob" и type имеет значение MappingType.Attribute, XML-элемент будет иметь следующий формат:

<Name fName = 'Bob'/>

Дополнительные сведения о сопоставлении столбцов с элементами или атрибутами см. в ColumnMapping разделе свойство .

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1