DataColumn Classe

Definizione

public ref class DataColumn : System::ComponentModel::MarshalByValueComponent

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class DataColumn : System.ComponentModel.MarshalByValueComponent

public class DataColumn : System.ComponentModel.MarshalByValueComponent

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
type DataColumn = class
    inherit MarshalByValueComponent

type DataColumn = class
    inherit MarshalByValueComponent

Public Class DataColumn
Inherits MarshalByValueComponent

Ereditarietà

Object

MarshalByValueComponent

DataColumn

Attributi

DynamicallyAccessedMembersAttribute

Esempio

Nell'esempio seguente viene creato un oggetto DataTable con diversi DataColumn oggetti .

private void MakeTable()
{
    // Create a DataTable.
    DataTable table = new DataTable("Product");

    // Create a DataColumn and set various properties.
    DataColumn column = new DataColumn();
    column.DataType = System.Type.GetType("System.Decimal");
    column.AllowDBNull = false;
    column.Caption = "Price";
    column.ColumnName = "Price";
    column.DefaultValue = 25;

    // Add the column to the table.
    table.Columns.Add(column);

    // Add 10 rows and set values.
    DataRow row;
    for(int i = 0; i < 10; i++)
    {
        row = table.NewRow();
        row["Price"] = i + 1;

        // Be sure to add the new row to the
        // DataRowCollection.
        table.Rows.Add(row);
    }
}

Private Sub MakeTable()
    ' Create a DataTable. 
    Dim table As New DataTable("Product")

    ' Create a DataColumn and set various properties. 
    Dim column As New DataColumn()
    column.DataType = System.Type.GetType("System.Decimal") 
    column.AllowDBNull = False 
    column.Caption = "Price"  
    column.ColumnName = "Price" 
    column.DefaultValue = 25 

    ' Add the column to the table. 
    table.Columns.Add(column) 

    ' Add 10 rows and set values. 
    Dim row As DataRow 
    Dim i As Integer  
    For i = 0 to 9 
        row = table.NewRow() 
        row("Price") = i + 1 

        ' Be sure to add the new row to 
        ' the DataRowCollection. 
        table.Rows.Add(row) 
    Next i 
End Sub

Commenti

DataColumn è il blocco predefinito fondamentale per la creazione dello schema di un oggetto DataTable. Per compilare lo schema, aggiungere uno o più DataColumn oggetti a DataColumnCollection. Per altre informazioni, vedere Aggiunta di colonne a un oggetto DataTable.

Ogni DataColumn oggetto dispone di una DataType proprietà che determina il tipo di dati DataColumn che contiene. Ad esempio, è possibile limitare il tipo di dati a numeri interi, stringhe o decimali. Poiché i dati contenuti da DataTable vengono in genere uniti di nuovo nell'origine dati originale, è necessario associare i tipi di dati a quelli nell'origine dati. Per altre informazioni, vedere Mapping dei tipi di dati in ADO.NET.

Le proprietà, ad esempio AllowDBNull, Uniquee ReadOnly impostano restrizioni per l'immissione e l'aggiornamento dei dati, consentendo così di garantire l'integrità dei dati. È anche possibile usare le AutoIncrementproprietà , AutoIncrementSeede AutoIncrementStep per controllare la generazione automatica dei dati. Per altre informazioni sulle AutoIncrement colonne, vedere Creazione di colonne autoincrement. Per altre informazioni, vedere Definizione delle chiavi primarie.

È anche possibile assicurarsi che i valori in un DataColumn oggetto siano univoci creando un UniqueConstraint oggetto e aggiungendolo all'oggetto ConstraintCollectionDataTable a cui appartiene l'oggetto DataColumn . Per ulteriori informazioni, consultare Vincoli della tabella dati.

Per creare una relazione tra DataColumn oggetti, creare un DataRelation oggetto e aggiungerlo all'oggetto DataRelationCollection di un oggetto DataSet.

È possibile utilizzare la Expression proprietà dell'oggetto DataColumn per calcolare i valori in una colonna o creare una colonna di aggregazione. Per altre informazioni, vedere Creazione di colonne di espressioni.

Thread safety

Questo tipo è sicuro per le operazioni di lettura multithreading. È necessario sincronizzare tutte le operazioni di scrittura.

Vedi anche

• Add(DataColumn)
• DataColumnCollection
• Constraints
• ConstraintCollection
• DataGrid
• DataRow
• DataTable
• DataSet
• NewRow()
• DataRowCollection
• UniqueConstraint
• Uso di DataSet in ADO.NET