DataColumn コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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.cs
- ソース:
- DataColumn.cs
DataColumn クラスの新しいインスタンスを型文字列として初期化します。
public:
DataColumn();
public DataColumn();
Public Sub New ()
例
次の例では、新しいDataColumnを作成し、さまざまなプロパティを設定して、DataTable オブジェクトのDataColumnCollectionに追加します。
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に追加すると、ColumnNameに名前が割り当てられていない場合、既定の名前 ("Column1"、"Column2"など) が生成されます。
こちらもご覧ください
適用対象
DataColumn(String)
- ソース:
- DataColumn.cs
- ソース:
- DataColumn.cs
- ソース:
- 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または空の文字列 ("") に設定すると、列コレクションに追加されるときに既定の名前が指定されます。
例
次の例では、指定したColumnNameを使用して新しいDataColumnを作成します。
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.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は指定されませんでした。
例
次の例では、指定したColumnNameとDataTypeを使用して新しいDataColumnを作成します。
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.cs
- ソース:
- 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);
public DataColumn(string? columnName, Type dataType, string? expr);
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
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
こちらもご覧ください
適用対象
DataColumn(String, Type, String, MappingType)
- ソース:
- DataColumn.cs
- ソース:
- DataColumn.cs
- ソース:
- DataColumn.cs
- ソース:
- DataColumn.cs
- ソース:
- 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);
public DataColumn(string? columnName, Type dataType, string? expr, System.Data.MappingType type);
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
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値の 1 つ。
- 属性
例外
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 プロパティを設定します。 このプロパティは、DataSetが XML ドキュメントに変換されるときにDataColumnをマップする方法を指定します。 たとえば、列の名前が "fName" で、その列に含まれる値が "Bob" で、 type が MappingType.Attribute に設定されている場合、XML 要素は次のようになります。
<名前 fName = 'Bob'/>
列を要素または属性にマップする方法の詳細については、 ColumnMapping プロパティを参照してください。