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

Nell'esempio seguente viene creato DataTable un oggetto DataColumn con diversi 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 blocco predefinito fondamentale per la creazione dello schema di un DataTableoggetto. DataColumnThe DataColumn is the fundamental building block for creating the schema of a DataTable. Per compilare lo schema, è necessario aggiungere uno DataColumn o più oggetti a. DataColumnCollectionYou 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 DataColumn oggetto dispone DataType di una proprietà che determina DataColumn il tipo di dati 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 DataTable in 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, Uniquee 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 AutoIncrementproprietà AutoIncrementSeed, 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 DataColumn oggetto siano univoci creando UniqueConstraint un oggetto ConstraintCollection e aggiungendolo alla proprietà DataTable dell'oggetto a DataColumn cui 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 DataRelationCollection e aggiungerlo a di un DataSetoggetto.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à DataColumn dell'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() 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 multithread.This type is safe for multithreaded read operations. È necessario sincronizzare le operazioni di scrittura.You must synchronize any write operations.

Vedi anche