英語で読む

次の方法で共有


DataColumn.ColumnName プロパティ

定義

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

public string ColumnName { get; set; }
[System.Data.DataSysDescription("DataColumnColumnNameDescr")]
public string ColumnName { get; set; }

プロパティ値

列の名前。

属性

例外

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

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

次の例では、 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);
}

注釈

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

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

適用対象

製品 バージョン
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

こちらもご覧ください