DataColumn DataColumn DataColumn DataColumn Class

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à

Esempi

L'esempio seguente crea una DataTable con alcuni 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 DataTable = new DataTable("Product") 

    ' Create a DataColumn and set various properties. 
    Dim column As DataColumn = 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

Il DataColumn è il blocco predefinito fondamentale per la creazione dello schema di un DataTable.The DataColumn is the fundamental building block for creating the schema of a DataTable. Lo schema viene compilato mediante l'aggiunta di uno o più DataColumn gli oggetti per il DataColumnCollection.You build the schema by adding one or more DataColumn objects to the DataColumnCollection. Per altre informazioni, vedere aggiunta di colonne a un oggetto DataTable.For more information, see Adding Columns to a DataTable.

Ciascuna DataColumn ha un DataType proprietà che determina il tipo di dati di DataColumn contiene.Each DataColumn has a DataType property that determines the kind of data the DataColumn contains. Ad esempio, è possibile limitare il tipo di dati per valori integer, stringhe o numeri decimali.For example, you can restrict the data type to integers, or strings, or decimals. Poiché i dati contenuti dal DataTable viene in genere unita all'origine dati originale, è necessario far corrispondere i tipi di dati a quelle nell'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 altre informazioni, vedere mapping dei tipi di dati in ADO.NET.For more information, see Data Type Mappings in ADO.NET.

Proprietà, ad esempio AllowDBNull, Unique, e ReadOnly inserire restrizioni per la voce e l'aggiornamento dei dati, che consente di proteggere per garantire 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. È anche possibile usare la AutoIncrement, AutoIncrementSeed, e AutoIncrementStep proprietà per determinare la generazione automatica dei dati.You can also use the AutoIncrement, AutoIncrementSeed, and AutoIncrementStep properties to control automatic data generation. Per altre informazioni sulle AutoIncrement colonne, vedere creazione di colonne AutoIncrement.For more information about AutoIncrement columns, see Creating AutoIncrement Columns. Per altre informazioni, vedere definizione di chiavi primarie.For more information, see Defining Primary Keys.

È anche possibile assicurarsi che i valori una DataColumn siano univoci tramite la creazione di un UniqueConstraint e aggiungendolo al ConstraintCollection del DataTable a cui il 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 dell'oggetto e aggiungerlo alle DataRelationCollection di un DataSet.To create a relation between DataColumn objects, create a DataRelation object and add it to the DataRelationCollection of a DataSet.

È possibile usare la Expression proprietà del DataColumn per calcolare i valori in una colonna dell'oggetto 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 altre informazioni, vedere creazione di colonne espressioni.For more information, see Creating Expression Columns.

Costruttori

DataColumn() DataColumn() DataColumn() 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) DataColumn(String) DataColumn(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) DataColumn(String, Type) DataColumn(String, Type) 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) DataColumn(String, Type, String) DataColumn(String, Type, String) 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) DataColumn(String, Type, String, MappingType) DataColumn(String, Type, String, MappingType) 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 AllowDBNull AllowDBNull 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 AutoIncrement AutoIncrement 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 AutoIncrementSeed AutoIncrementSeed 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 AutoIncrementStep AutoIncrementStep 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 Caption Caption Caption

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

ColumnMapping ColumnMapping ColumnMapping ColumnMapping

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

ColumnName ColumnName ColumnName ColumnName

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

Container Container Container Container

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

(Inherited from MarshalByValueComponent)
DataType DataType DataType DataType

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

DateTimeMode DateTimeMode DateTimeMode DateTimeMode

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

DefaultValue DefaultValue DefaultValue 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 DesignMode DesignMode DesignMode

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

(Inherited from MarshalByValueComponent)
Events Events Events Events

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

(Inherited from MarshalByValueComponent)
Expression Expression Expression 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 ExtendedProperties ExtendedProperties 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 MaxLength MaxLength MaxLength

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

Namespace Namespace Namespace Namespace

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

Ordinal Ordinal Ordinal 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 Prefix Prefix 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 ReadOnly ReadOnly 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 Site Site Site

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

(Inherited from MarshalByValueComponent)
Table Table Table Table

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

Unique Unique Unique 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() CheckNotAllowNull() CheckNotAllowNull() CheckNotAllowNull()

Questo membro supporta l'infrastruttura .NET Framework e non è possibile usarlo direttamente dal codice.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

CheckUnique() CheckUnique() CheckUnique() CheckUnique()

Questo membro supporta l'infrastruttura .NET Framework e non è possibile usarlo direttamente dal codice.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Dispose() Dispose() Dispose() Dispose()

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

(Inherited from MarshalByValueComponent)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) 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.

(Inherited from MarshalByValueComponent)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

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

(Inherited from MarshalByValueComponent)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs)

Questo membro supporta l'infrastruttura .NET Framework e non è possibile usarlo direttamente dal codice.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

RaisePropertyChanging(String) RaisePropertyChanging(String) RaisePropertyChanging(String) RaisePropertyChanging(String)

Questo membro supporta l'infrastruttura .NET Framework e non è possibile usarlo direttamente dal codice.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

SetOrdinal(Int32) SetOrdinal(Int32) SetOrdinal(Int32) 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() ToString() ToString() ToString()

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

Eventi

Disposed Disposed Disposed Disposed

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

(Inherited from MarshalByValueComponent)

Si applica a

Thread safety

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

Vedi anche