DataColumn Classe

Definizione

Spazio dei nomi:

System.Data

Assembly:

netstandard.dll, System.Data.Common.dll

Origine:

DataColumn.cs

Rappresenta lo schema di una colonna in un oggetto DataTable.

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

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

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
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.

Costruttori

Nome	Descrizione
DataColumn()	Inizializza una nuova istanza della DataColumn classe come stringa di tipo.
DataColumn(String, Type, String, MappingType)	Inizializza una nuova istanza della DataColumn classe utilizzando il nome, il tipo di dati, l'espressione e il valore specificati che determina se la colonna è un attributo.
DataColumn(String, Type, String)	Inizializza una nuova istanza della DataColumn classe utilizzando il nome, il tipo di dati e l'espressione specificati.
DataColumn(String, Type)	Inizializza una nuova istanza della DataColumn classe utilizzando il nome della colonna e il tipo di dati specificati.
DataColumn(String)	Inizializza una nuova istanza della DataColumn classe, come stringa di tipo, utilizzando il nome di colonna specificato.

Proprietà

Nome	Descrizione
AllowDBNull	Ottiene o imposta un valore che indica se in questa colonna sono consentiti valori Null per le righe che appartengono alla tabella.
AutoIncrement	Ottiene o imposta un valore che indica se la colonna incrementa automaticamente il valore della colonna per le nuove righe aggiunte alla tabella.
AutoIncrementSeed	Ottiene o imposta il valore iniziale di una colonna con la relativa AutoIncrement proprietà impostata su true. Il valore predefinito è 0.
AutoIncrementStep	Ottiene o imposta l'incremento utilizzato da una colonna con la relativa AutoIncrement proprietà impostata su true.
Caption	Ottiene o imposta la didascalia per la colonna.
ColumnMapping	Ottiene o imposta l'oggetto MappingType della colonna.
ColumnName	Ottiene o imposta il nome della colonna nell'oggetto DataColumnCollection.
Container	Ottiene il contenitore per il componente. (Ereditato da MarshalByValueComponent)
DataType	Ottiene o imposta il tipo di dati archiviati nella colonna.
DateTimeMode	Ottiene o imposta l'oggetto DateTimeMode per la colonna.
DefaultValue	Ottiene o imposta il valore predefinito per la colonna quando si creano nuove righe.
DesignMode	Ottiene un valore che indica se il componente è attualmente in modalità progettazione. (Ereditato da MarshalByValueComponent)
Events	Ottiene l'elenco dei gestori eventi associati a questo componente. (Ereditato da MarshalByValueComponent)
Expression	Ottiene o imposta l'espressione utilizzata per filtrare le righe, calcolare i valori in una colonna o creare una colonna di aggregazione.
ExtendedProperties	Ottiene la raccolta di informazioni utente personalizzate associate a un oggetto DataColumn.
MaxLength	Ottiene o imposta la lunghezza massima di una colonna di testo.
Namespace	Ottiene o imposta lo spazio dei nomi dell'oggetto DataColumn.
Ordinal	Ottiene la posizione (in base zero) della colonna nell'insieme DataColumnCollection .
Prefix	Ottiene o imposta un prefisso XML che aliasa lo spazio dei nomi dell'oggetto DataTable.
ReadOnly	Ottiene o imposta un valore che indica se la colonna consente modifiche non appena una riga è stata aggiunta alla tabella.
Site	Ottiene o imposta il sito del componente. (Ereditato da MarshalByValueComponent)
Table	Ottiene l'oggetto DataTable a cui appartiene la colonna.
Unique	Ottiene o imposta un valore che indica se i valori in ogni riga della colonna devono essere univoci.

Metodi

Nome	Descrizione
CheckNotAllowNull()	Questo membro supporta l'infrastruttura .NET e non deve essere usato direttamente dal codice.
CheckUnique()	Questo membro supporta l'infrastruttura .NET e non deve essere usato direttamente dal codice.
Dispose()	Rilascia tutte le risorse usate da MarshalByValueComponent. (Ereditato da MarshalByValueComponent)
Dispose(Boolean)	Rilascia le risorse non gestite usate da MarshalByValueComponent e, facoltativamente, rilascia le risorse gestite. (Ereditato da MarshalByValueComponent)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetService(Type)	Ottiene l'implementatore dell'oggetto IServiceProvider. (Ereditato da MarshalByValueComponent)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
OnPropertyChanging(PropertyChangedEventArgs)	Questo membro supporta l'infrastruttura .NET e non deve essere usato direttamente dal codice.
RaisePropertyChanging(String)	Questo membro supporta l'infrastruttura .NET e non deve essere usato direttamente dal codice.
SetOrdinal(Int32)	Modifica il numero ordinale o la posizione dell'oggetto DataColumn nell'ordinale o nella posizione specificata.
ToString()	Ottiene l'oggetto Expression della colonna, se presente.

Eventi

Nome	Descrizione
Disposed	Aggiunge un gestore eventi per restare in ascolto dell'evento Disposed nel componente. (Ereditato da MarshalByValueComponent)

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