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
не был указан.
Примеры
В следующем примере создается новый 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
или пустая строка (""), то при добавлении объекта в коллекцию столбцов будет задано имя по умолчанию.
- 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
См. также раздел
- DefaultValue
- ColumnName
- Caption
- DataTable
- DataType
- Expression
- Использование наборов данных в ADO.NET
Применяется к
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
или пустая строка (""), то при добавлении объекта в коллекцию столбцов будет задано имя по умолчанию.
- 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 разделе свойство .
См. также раздел
- ColumnName
- ColumnMapping
- Caption
- DefaultValue
- DataTable
- DataType
- Использование наборов данных в ADO.NET