DataColumn.ColumnName プロパティ

  • リファレンス

定義

名前空間:
System.Data
アセンブリ:
System.Data.Common.dll
アセンブリ:
System.Data.dll
アセンブリ:
netstandard.dll
ソース:
DataColumn.cs
ソース:
DataColumn.cs
ソース:
DataColumn.cs

DataColumnCollection 内の列名を取得または設定します。

public:
 property System::String ^ ColumnName { System::String ^ get(); void set(System::String ^ value); };
public string ColumnName { get; set; }
[System.Data.DataSysDescription("DataColumnColumnNameDescr")]
public string ColumnName { get; set; }
member this.ColumnName : string with get, set
[<System.Data.DataSysDescription("DataColumnColumnNameDescr")>]
member this.ColumnName : string with get, set
Public Property ColumnName As String

プロパティ値

String

列の名前。

属性
DataSysDescriptionAttribute

例外

ArgumentException

このプロパティは null または空の文字列に設定され、列がコレクションに属しています。

DuplicateNameException

同じ名前の列がコレクション内に既に存在します。 名前の比較では、大文字と小文字が区別されません。

例

次の例では、 ColumnName 内のすべてのテーブル DataSetのすべての列の を取得します。 この例では、新しい ColumnNameを使用して をDataColumn作成する方法も示しています。

private void PrintColumnNames(DataSet dataSet)
{
    // For each DataTable, print the ColumnName.
    foreach(DataTable table in dataSet.Tables)
    {
        foreach(DataColumn column in table.Columns)
        {
            Console.WriteLine(column.ColumnName);
        }
    }
}

private void AddColumn(DataTable table)
{
    DataColumn column;
    column = new DataColumn();
    column.ColumnName = "SupplierID";
    column.DataType = System.Type.GetType("System.String");
    column.Unique = true;
    column.AutoIncrement = false;
    column.Caption = "SupplierID";
    column.ReadOnly = false;

    // Add the column to the table's columns collection.
    table.Columns.Add(column);
}

Private Sub PrintColumnNames(dataSet As DataSet)
    Dim table As DataTable
    Dim column As DataColumn 

    ' For each DataTable, print the ColumnName.
    For Each table in dataSet.Tables
        For Each column in table.Columns
        Console.WriteLine(column.ColumnName)
        Next
    Next
End Sub

Private Sub AddColumn(table As DataTable)
    Dim column As DataColumn
    column = New DataColumn()

    With column
        .ColumnName = "SupplierID"
        .DataType = System.Type.GetType("System.String")
        .Unique = True
        .AutoIncrement = False
        .Caption = "SupplierID"
        .ReadOnly = False
    End With

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

注釈

DataColumnが作成されると、値はありませんColumnName。 ただし、 が オブジェクトの DataTable にDataColumnCollection追加されるとDataColumn、既定の名前 ("Column1"、"Column2"など) が指定されます。

既定では、 Caption 値は 値に ColumnName 設定されます。

適用対象

こちらもご覧ください