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


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();
public DataColumn ();
Public Sub New ()

Примеры

В следующем примере создается новый 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);
}
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его в будет создано имя по умолчанию ("Столбец1", "Столбец2" и т. д.), если имя не было назначено ColumnName.

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

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

DataColumn(String)

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

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

public:
 DataColumn(System::String ^ columnName);
public DataColumn (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 свойства.

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

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

DataColumn(String, Type)

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

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

public:
 DataColumn(System::String ^ columnName, Type ^ dataType);
public DataColumn (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.

Исключения

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

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

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

DataColumn(String, Type, String)

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

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

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr);
public DataColumn (string? columnName, Type dataType, string? expr);
public DataColumn (string columnName, Type dataType, string expr);
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.

Исключения

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

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

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

DataColumn(String, Type, String, MappingType)

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

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

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr, System::Data::MappingType type);
public DataColumn (string? columnName, Type dataType, string? expr, System.Data.MappingType type);
public DataColumn (string columnName, Type dataType, string expr, System.Data.MappingType type);
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.

Исключения

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 разделе свойство .

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

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