Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe DataColumn

 

Data di pubblicazione: ottobre 2016

Rappresenta lo schema di una colonna in un DataTable.

Spazio dei nomi:   System.Data
Assembly:  System.Data (in System.Data.dll)


public class DataColumn : MarshalByValueComponent

NomeDescrizione
System_CAPS_pubmethodDataColumn()

Inizializza una nuova istanza di un DataColumn classe come tipo string.

System_CAPS_pubmethodDataColumn(String)

Inizializza una nuova istanza di DataColumn (classe), come stringa di tipo, utilizzando il nome della colonna specificata.

System_CAPS_pubmethodDataColumn(String, Type)

Inizializza una nuova istanza di DataColumn classe utilizzando il tipo di nome e i dati di colonna specificata.

System_CAPS_pubmethodDataColumn(String, Type, String)

Inizializza una nuova istanza di DataColumn classe utilizzando l'espressione, un tipo di dati e un nome specificato.

System_CAPS_pubmethodDataColumn(String, Type, String, MappingType)

Inizializza una nuova istanza di DataColumn classe utilizzando il nome specificato, tipo di dati, l'espressione e valore che determina se la colonna è un attributo.

NomeDescrizione
System_CAPS_pubpropertyAllowDBNull

Ottiene o imposta un valore che indica se in questa colonna sono consentiti valori null per le righe che appartengono alla tabella.

System_CAPS_pubpropertyAutoIncrement

Ottiene o imposta un valore che indica se la colonna viene incrementato automaticamente il valore della colonna per le nuove righe aggiunte alla tabella.

System_CAPS_pubpropertyAutoIncrementSeed

Ottiene o imposta il valore iniziale di una colonna con il relativo AutoIncrement impostata su true. Il valore predefinito è 0.

System_CAPS_pubpropertyAutoIncrementStep

Ottiene o imposta l'incremento utilizzato da una colonna con il relativo AutoIncrement impostata su true.

System_CAPS_pubpropertyCaption

Ottiene o imposta la didascalia per la colonna.

System_CAPS_pubpropertyColumnMapping

Ottiene o imposta il MappingType della colonna.

System_CAPS_pubpropertyColumnName

Ottiene o imposta il nome della colonna di DataColumnCollection.

System_CAPS_pubpropertyContainer

Ottiene il contenitore per il componente.(Ereditato da MarshalByValueComponent.)

System_CAPS_pubpropertyDataType

Ottiene o imposta il tipo di dati archiviati nella colonna.

System_CAPS_pubpropertyDateTimeMode

Ottiene o imposta il DateTimeMode per la colonna.

System_CAPS_pubpropertyDefaultValue

Ottiene o imposta il valore predefinito per la colonna durante la creazione di nuove righe.

System_CAPS_pubpropertyDesignMode

Ottiene un valore che indica se il componente è attualmente in modalità progettazione.(Ereditato da MarshalByValueComponent.)

System_CAPS_protpropertyEvents

Ottiene l'elenco di gestori eventi associati a questo componente.(Ereditato da MarshalByValueComponent.)

System_CAPS_pubpropertyExpression

Ottiene o imposta l'espressione utilizzata per filtrare le righe, calcolare i valori in una colonna o creare una colonna aggregata.

System_CAPS_pubpropertyExtendedProperties

Ottiene la raccolta di informazioni utente personalizzata associate a un DataColumn.

System_CAPS_pubpropertyMaxLength

Ottiene o imposta la lunghezza massima di una colonna di testo.

System_CAPS_pubpropertyNamespace

Ottiene o imposta lo spazio dei nomi di DataColumn.

System_CAPS_pubpropertyOrdinal

Ottiene la posizione della colonna (in base zero) il DataColumnCollection insieme.

System_CAPS_pubpropertyPrefix

Ottiene o imposta un prefisso XML che rappresenta l'alias lo spazio dei nomi di DataTable.

System_CAPS_pubpropertyReadOnly

Ottiene o imposta un valore che indica se la colonna consente le modifiche non appena è stata aggiunta una riga alla tabella.

System_CAPS_pubpropertySite

Ottiene o imposta il sito del componente.(Ereditato da MarshalByValueComponent.)

System_CAPS_pubpropertyTable

Ottiene il DataTable a cui appartiene la colonna.

System_CAPS_pubpropertyUnique

Ottiene o imposta un valore che indica se i valori in ogni riga della colonna devono essere univoci.

NomeDescrizione
System_CAPS_protmethodCheckNotAllowNull()

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Questo membro supporta l'infrastruttura .NET Framework e non è possibile usarlo direttamente dal codice.

System_CAPS_protmethodCheckUnique()

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Questo membro supporta l'infrastruttura .NET Framework e non è possibile usarlo direttamente dal codice.

System_CAPS_pubmethodDispose()

Rilascia tutte le risorse usate da MarshalByValueComponent.(Ereditato da MarshalByValueComponent.)

System_CAPS_protmethodDispose(Boolean)

Rilascia le risorse non gestite usate da MarshalByValueComponent e, facoltativamente, le risorse gestite.(Ereditato da MarshalByValueComponent.)

System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object.)

System_CAPS_protmethodFinalize()

Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da MarshalByValueComponent.)

System_CAPS_pubmethodGetHashCode()

Funge da funzione hash predefinita.(Ereditato da Object.)

System_CAPS_pubmethodGetService(Type)

Ottiene l'implementatore di IServiceProvider.(Ereditato da MarshalByValueComponent.)

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.(Ereditato da Object.)

System_CAPS_protmethodOnPropertyChanging(PropertyChangedEventArgs)

Questo membro supporta l'infrastruttura .NET Framework e non è possibile usarlo direttamente dal codice.

System_CAPS_protmethodRaisePropertyChanging(String)

Questo membro supporta l'infrastruttura .NET Framework e non è possibile usarlo direttamente dal codice.

System_CAPS_pubmethodSetOrdinal(Int32)

Modifica il numero ordinale o la posizione del DataColumn l'ordinale specificato o la posizione.

System_CAPS_pubmethodToString()

Ottiene il Expression della colonna, se presente.(Esegue l'override di MarshalByValueComponent.ToString().)

NomeDescrizione
System_CAPS_pubeventDisposed

Aggiunge un gestore eventi per restare in attesa di Disposed eventi del componente.(Ereditato da MarshalByValueComponent.)

Il DataColumn è il blocco predefinito fondamentale per la creazione dello schema di un DataTable. Lo schema viene compilato mediante l'aggiunta di uno o più DataColumn oggetti per il DataColumnCollection. Per altre informazioni, vedere Aggiunta di colonne a un DataTable.

Ogni DataColumn ha un DataType proprietà che determina il tipo di dati di DataColumn contiene. Ad esempio, è possibile limitare il tipo di dati per valori integer, stringhe o numeri decimali. Perché i dati contenuti dal DataTable in genere viene unita all'origine dati originale, è necessario far corrispondere i tipi di dati a quelli nell'origine dati. Per altre informazioni, vedere Mapping dei tipi di dati in ADO.NET.

Proprietà, ad esempio AllowDBNull, Unique, e ReadOnly imporre restrizioni all'immissione e l'aggiornamento dei dati, garantendone per garantire l'integrità dei dati. È inoltre possibile utilizzare il AutoIncrement, AutoIncrementSeed, e AutoIncrementStep proprietà per determinare la generazione automatica dei dati. Per ulteriori informazioni su AutoIncrement colonne, vedere Creazione di colonne AutoIncrement. Per altre informazioni, vedere Definizione di chiavi primarie.

È anche possibile assicurarsi che i valori un DataColumn siano univoci creando un UniqueConstraint e aggiungerlo al ConstraintCollection del DataTable a cui il DataColumn appartiene. Per altre informazioni, vedere Vincoli di DataTable.

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

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

Nell'esempio seguente viene creato un DataTable con molti 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); 
    } 
}

.NET Framework
Disponibile da 1.1

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

Torna all'inizio
Mostra: