DataColumn.ColumnName Propiedad

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.Common.dll

Source:

DataColumn.cs

Obtiene o establece el nombre de la columna en el DataColumnCollection.

public:
 property System::String ^ ColumnName { System::String ^ get(); void set(System::String ^ value); };

public string ColumnName { get; set; }

member this.ColumnName : string with get, set

Public Property ColumnName As String

Valor de propiedad

String

El nombre de la columna.

Excepciones

ArgumentException

La propiedad se establece en null o es una cadena vacía y la columna pertenece a una colección.

DuplicateNameException

Ya existe una columna con el mismo nombre en la colección. La comparación de nombres no distingue entre mayúsculas y minúsculas.

Ejemplos

En los ejemplos siguientes se obtiene para ColumnName cada columna de cada tabla de .DataSet En el ejemplo también se muestra cómo crear un DataColumn con un nuevo ColumnName.

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

Comentarios

Cuando se crea un DataColumn objeto , no tiene ningún ColumnName valor. Sin embargo, cuando DataColumn se agrega a para DataColumnCollection un DataTable objeto , se le asigna un nombre predeterminado ("Column1", "Column2", etc.).

De forma predeterminada, el Caption valor se establece en el ColumnName valor .

Consulte también

• Caption
• Uso de conjuntos de datos en ADO.NET