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

Определение

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

System.Data

Сборки:

netstandard.dll, System.Data.Common.dll

Инициализирует новый экземпляр класса 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 класса в виде строки типа.

public:
 DataColumn();

public DataColumn();

Public Sub New ()

Примеры

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

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);
}

Private Sub AddDataColumn(ByVal table As DataTable)
    Dim column As New DataColumn()

    ' Set various properties.
    With column
       .ColumnName = "id"
       .DataType = System.Type.GetType("System.Int32")
       .AutoIncrement = True
       .AutoIncrementSeed = 1
       .AutoIncrementStep = 1
       .ReadOnly = True
     End With

    ' Add to Columns collection.
    table.Columns.Add(column)
End Sub

Комментарии

При создании DataColumn объект не имеет значения по умолчанию ColumnName или Caption. При добавлении имени DataColumnCollectionпо умолчанию (Column1, Column2 и т. д.) будет создано, если имя не назначено ColumnName.

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

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• Использование наборов данных в ADO.NET

DataColumn(String)

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

DataColumn.cs

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

public:
 DataColumn(System::String ^ columnName);

public DataColumn(string? columnName);

new System.Data.DataColumn : string -> System.Data.DataColumn

Public Sub New (columnName As String)

Параметры

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);
}

Private Sub AddDataColumn(ByVal table As DataTable)
    Dim column As DataColumn 
    column = New DataColumn("id")

    ' Set various properties.
    With column
       .DataType = System.Type.GetType("System.Int32")
       .AutoIncrement = True
       .AutoIncrementSeed = 1
       .AutoIncrementStep = 1
       .ReadOnly = True
     End With

    ' Add to Columns collection.
    table.Columns.Add(column)
End Sub

Комментарии

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

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

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• Использование наборов данных в ADO.NET

DataColumn(String, Type)

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

DataColumn.cs

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

public:
 DataColumn(System::String ^ columnName, Type ^ dataType);

public DataColumn(string? columnName, Type dataType);

new System.Data.DataColumn : string * Type -> System.Data.DataColumn

Public Sub New (columnName As String, dataType As Type)

Параметры

columnName

String

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

dataType

Type

Поддерживаемый DataTypeобъект.

Исключения

ArgumentNullException

Не 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);
}

Private Sub AddDataColumn(ByVal table As DataTable)
    
   Dim typeInt32 As System.Type = _
      System.Type.GetType("System.Int32")
   Dim column As DataColumn = _
       New DataColumn("id", typeInt32)

   ' Set various properties.
   With column
      .AutoIncrement = True
      .AutoIncrementSeed = 1
      .AutoIncrementStep = 1
      .ReadOnly = True
    End With

   ' Add to Columns collection.
   table.Columns.Add(column)
End Sub

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

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• Использование наборов данных в ADO.NET

DataColumn(String, Type, String)

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

DataColumn.cs

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

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")]
public DataColumn(string? columnName, Type dataType, string? expr);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")>]
new System.Data.DataColumn : string * Type * string -> System.Data.DataColumn

Public Sub New (columnName As String, dataType As Type, expr As String)

Параметры

columnName

String

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

dataType

Type

Поддерживаемый DataTypeобъект.

expr

String

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

Атрибуты

RequiresUnreferencedCodeAttribute

Исключения

ArgumentNullException

Не 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);
}

Private Sub AddDataColumn(ByVal table As DataTable)
    Dim column As DataColumn 
    Dim decimalType As System.Type
 
    decimalType = System.Type.GetType("System.Decimal")
    column = New DataColumn("Tax", decimalType, "UnitPrice * .0862")

    ' Set various properties.
    With column
       .AutoIncrement = False
       .ReadOnly = True
    End With

    ' Add to Columns collection.
    table.Columns.Add(column)
 End Sub

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

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• Expression
• Использование наборов данных в ADO.NET

DataColumn(String, Type, String, MappingType)

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

DataColumn.cs

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

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr, System::Data::MappingType type);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")]
public DataColumn(string? columnName, Type dataType, string? expr, System.Data.MappingType type);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")>]
new System.Data.DataColumn : string * Type * string * System.Data.MappingType -> System.Data.DataColumn

Public Sub New (columnName As String, dataType As Type, expr As String, type As MappingType)

Параметры

columnName

String

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

dataType

Type

Поддерживаемый DataTypeобъект.

expr

String

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

type

MappingType

Одно из значений MappingType .

Атрибуты

RequiresUnreferencedCodeAttribute

Исключения

ArgumentNullException

Не 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);
}

Private Sub CreateComputedColumn(ByVal table As DataTable)
    Dim column As DataColumn
    Dim decimalType As System.Type = _
        System.Type.GetType("System.Decimal")

    ' The expression multiplies the "Price" column value by the 
    ' "Quantity" to create the "Total" column.
    Dim expression As String = "Price * Quantity"

    ' Create the column, setting the type to Attribute.
    column = New DataColumn("Total", decimalType, _
        expression, MappingType.Attribute)

    ' Set various properties.
    column.AutoIncrement = False
    column.ReadOnly = True

    ' Add the column to a DataTable object's DataColumnCollection.
    DataSet1.Tables("OrderDetails").Columns.Add(column)
End Sub

Комментарии

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

<Name fName = 'Bob'/>

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

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

• ColumnName
• ColumnMapping
• Caption
• DefaultValue
• DataTable
• DataType
• Использование наборов данных в ADO.NET