DataColumn Classe

Definizione

Rappresenta lo schema di una colonna di una DataTable.Represents the schema of a column in a DataTable.

public ref class DataColumn : System::ComponentModel::MarshalByValueComponent
public class DataColumn : System.ComponentModel.MarshalByValueComponent
type DataColumn = class
    inherit MarshalByValueComponent
Public Class DataColumn
Inherits MarshalByValueComponent
Ereditarietà

Esempio

Nell'esempio seguente viene creato un oggetto DataTable con diversi DataColumn oggetti.The following example creates a DataTable with several DataColumn objects.

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 .The DataColumn is the fundamental building block for creating the schema of a DataTable. Per compilare lo schema, è necessario aggiungere uno o più DataColumn oggetti a DataColumnCollection .You build the schema by adding one or more DataColumn objects to the DataColumnCollection. Per ulteriori informazioni, vedere aggiunta di colonne a un oggetto DataTable.For more information, see Adding Columns to a DataTable.

Ogni oggetto DataColumn dispone di una DataType proprietà che determina il tipo di dati DataColumn contenuti in.Each DataColumn has a DataType property that determines the kind of data the DataColumn contains. Ad esempio, è possibile limitare il tipo di dati a numeri interi, stringhe o decimali.For example, you can restrict the data type to integers, or strings, or decimals. Poiché i dati contenuti in DataTable vengono in genere Uniti nell'origine dati originale, è necessario associare i tipi di dati a quelli dell'origine dati.Because data that is contained by the DataTable is typically merged back into its original data source, you must match the data types to those in the data source. Per ulteriori informazioni, vedere mapping dei tipi di dati in ADO.NET.For more information, see Data Type Mappings in ADO.NET.

Proprietà come AllowDBNull , Unique e ReadOnly impostano restrizioni sulla voce e sull'aggiornamento dei dati, garantendo in tal modo l'integrità dei dati.Properties such as AllowDBNull, Unique, and ReadOnly put restrictions on the entry and updating of data, thereby helping to guarantee data integrity. È inoltre possibile utilizzare le AutoIncrement AutoIncrementSeed proprietà, e AutoIncrementStep per controllare la generazione automatica dei dati.You can also use the AutoIncrement, AutoIncrementSeed, and AutoIncrementStep properties to control automatic data generation. Per ulteriori informazioni sulle AutoIncrement colonne, vedere creazione di colonne AutoIncrement.For more information about AutoIncrement columns, see Creating AutoIncrement Columns. Per ulteriori informazioni, vedere definizione delle chiavi primarie.For more information, see Defining Primary Keys.

È inoltre possibile verificare che i valori in un oggetto DataColumn siano univoci creando un oggetto UniqueConstraint e aggiungendolo alla proprietà ConstraintCollection dell'oggetto DataTable a cui DataColumn appartiene.You can also make sure that values in a DataColumn are unique by creating a UniqueConstraint and adding it to the ConstraintCollection of the DataTable to which the DataColumn belongs. Per altre informazioni, vedere vincoli DataTable.For more information, see DataTable Constraints.

Per creare una relazione tra DataColumn oggetti, creare un DataRelation oggetto e aggiungerlo a DataRelationCollection di un oggetto DataSet .To create a relation between DataColumn objects, create a DataRelation object and add it to the DataRelationCollection of a DataSet.

È possibile utilizzare la Expression proprietà dell' DataColumn oggetto per calcolare i valori in una colonna o creare una colonna aggregata.You can use the Expression property of the DataColumn object to calculate the values in a column, or create an aggregate column. Per ulteriori informazioni, vedere creazione di colonne espressione.For more information, see Creating Expression Columns.

Costruttori

DataColumn()

Inizializza una nuova istanza di una classe DataColumn come tipo string.Initializes a new instance of a DataColumn class as type string.

DataColumn(String)

Inizializza una nuova istanza della classe DataColumn, come tipo string, utilizzando il nome di colonna specificato.Initializes a new instance of the DataColumn class, as type string, using the specified column name.

DataColumn(String, Type)

Inizializza una nuova istanza della classe DataColumn utilizzando il nome di colonna e il tipo di dati specificati.Initializes a new instance of the DataColumn class using the specified column name and data type.

DataColumn(String, Type, String)

Inizializza una nuova istanza della classe DataColumn con il nome, il tipo di dati e l'espressione specificati.Initializes a new instance of the DataColumn class using the specified name, data type, and expression.

DataColumn(String, Type, String, MappingType)

Inizializza una nuova istanza della classe DataColumn con il nome, il tipo di dati, l'espressione e il valore che determina se la colonna è un attributo.Initializes a new instance of the DataColumn class using the specified name, data type, expression, and value that determines whether the column is an attribute.

Proprietà

AllowDBNull

Ottiene o imposta un valore che indica se i valori null sono consentiti in questa colonna per le righe che appartengono alla tabella.Gets or sets a value that indicates whether null values are allowed in this column for rows that belong to the table.

AutoIncrement

Ottiene o imposta un valore che indica se nella colonna viene incrementato automaticamente il valore della colonna per le nuove righe aggiunte alla tabella.Gets or sets a value that indicates whether the column automatically increments the value of the column for new rows added to the table.

AutoIncrementSeed

Ottiene o imposta il valore iniziale di una colonna la cui proprietà AutoIncrement è impostata su true.Gets or sets the starting value for a column that has its AutoIncrement property set to true. Il valore predefinito è 0.The default is 0.

AutoIncrementStep

Ottiene o imposta l'incremento utilizzato da una colonna con la relativa proprietà AutoIncrement impostata su true.Gets or sets the increment used by a column with its AutoIncrement property set to true.

Caption

Ottiene o imposta la didascalia per la colonna.Gets or sets the caption for the column.

ColumnMapping

Ottiene o imposta l'oggetto MappingType della colonna.Gets or sets the MappingType of the column.

ColumnName

Ottiene o imposta il nome della colonna nell'insieme DataColumnCollection.Gets or sets the name of the column in the DataColumnCollection.

Container

Ottiene il contenitore del componente.Gets the container for the component.

(Ereditato da MarshalByValueComponent)
DataType

Ottiene o imposta il tipo di dati memorizzato nella colonna.Gets or sets the type of data stored in the column.

DateTimeMode

Ottiene o imposta DateTimeMode per la colonna.Gets or sets the DateTimeMode for the column.

DefaultValue

Ottiene o imposta il valore predefinito della colonna durante la creazione di nuove righe.Gets or sets the default value for the column when you are creating new rows.

DesignMode

Ottiene un valore che indica se il componente è in modalità progettazione.Gets a value indicating whether the component is currently in design mode.

(Ereditato da MarshalByValueComponent)
Events

Ottiene l'elenco dei gestori eventi allegati a questo componente.Gets the list of event handlers that are attached to this component.

(Ereditato da MarshalByValueComponent)
Expression

Ottiene o imposta l'espressione utilizzata per filtrare righe, calcolare i valori di una colonna o creare una colonna aggregata.Gets or sets the expression used to filter rows, calculate the values in a column, or create an aggregate column.

ExtendedProperties

Ottiene l'insieme di informazioni utente personalizzate associate a un oggetto DataColumn.Gets the collection of custom user information associated with a DataColumn.

MaxLength

Ottiene o imposta la lunghezza massima di una colonna di testo.Gets or sets the maximum length of a text column.

Namespace

Ottiene o imposta lo spazio dei nomi della classe DataColumn.Gets or sets the namespace of the DataColumn.

Ordinal

Ottiene la posizione in base zero della colonna nella raccolta DataColumnCollection.Gets the (zero-based) position of the column in the DataColumnCollection collection.

Prefix

Ottiene o imposta un prefisso XML che rappresenta l'alias dello spazio dei nomi della classe DataTable.Gets or sets an XML prefix that aliases the namespace of the DataTable.

ReadOnly

Ottiene o imposta un valore che indica se la colonna consente modifiche una volta che la riga è stata aggiunta alla tabella.Gets or sets a value that indicates whether the column allows for changes as soon as a row has been added to the table.

Site

Ottiene o imposta il sito del componente.Gets or sets the site of the component.

(Ereditato da MarshalByValueComponent)
Table

Ottiene l'oggetto DataTable a cui appartiene la colonna.Gets the DataTable to which the column belongs to.

Unique

Ottiene o imposta un valore che indica se i valori di ciascuna riga della colonna devono essere univoci.Gets or sets a value that indicates whether the values in each row of the column must be unique.

Metodi

CheckNotAllowNull()

Questo membro supporta l'infrastruttura .NET e non deve essere usato direttamente dal codice.This member supports .NET infrastructure and is not intended to be used directly from your code.

CheckUnique()

Questo membro supporta l'infrastruttura .NET e non deve essere usato direttamente dal codice.This member supports .NET infrastructure and is not intended to be used directly from your code.

Dispose()

Rilascia tutte le risorse usate da MarshalByValueComponent.Releases all resources used by the MarshalByValueComponent.

(Ereditato da MarshalByValueComponent)
Dispose(Boolean)

Rilascia le risorse non gestite usate da MarshalByValueComponent e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the MarshalByValueComponent and optionally releases the managed resources.

(Ereditato da MarshalByValueComponent)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetService(Type)

Ottiene l'implementatore dell'interfaccia IServiceProvider.Gets the implementer of the IServiceProvider.

(Ereditato da MarshalByValueComponent)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
OnPropertyChanging(PropertyChangedEventArgs)

Questo membro supporta l'infrastruttura .NET e non deve essere usato direttamente dal codice.This member supports .NET infrastructure and is not intended to be used directly from your code.

RaisePropertyChanging(String)

Questo membro supporta l'infrastruttura .NET e non deve essere usato direttamente dal codice.This member supports .NET infrastructure and is not intended to be used directly from your code.

SetOrdinal(Int32)

Modifica l'ordinale o la posizione della classe DataColumn nell'ordinale o nella posizione specificati.Changes the ordinal or position of the DataColumn to the specified ordinal or position.

ToString()

Ottiene la proprietà Expression della colonna, se disponibile.Gets the Expression of the column, if one exists.

Eventi

Disposed

Aggiunge un gestore evento per restare in attesa dell'evento Disposed sul componente.Adds an event handler to listen to the Disposed event on the component.

(Ereditato da MarshalByValueComponent)

Si applica a

Thread safety

Questo tipo è sicuro per le operazioni di lettura multithread.This type is safe for multithreaded read operations. È necessario sincronizzare le operazioni di scrittura.You must synchronize any write operations.

Vedi anche