Procedura: aggiungere colonne a un oggetto DataTable

È possibile creare le singole colonne (DataColumn) che compongono le tabelle dati (DataTable) aggiungendole all'oggetto DataColumnCollection di una tabella dati. È possibile aggiungere colonne alle tabelle dati operando a livello visivo mediante Progettazione DataSet oppure utilizzando una delle procedure guidate relative ai dati. Per ulteriori informazioni su come aggiungere colonne di dati alle tabelle dati a livello di codice, vedere Aggiunta di colonne a un DataTable.

Dopo avere aggiunto le colonne, è possibile configurarle per soddisfare le proprie esigenze. Ad esempio, per una colonna è possibile specificare un valore predefinito o un vincolo di univocità. È anche possibile specificare che una colonna debba visualizzare un valore calcolato, anziché un valore letto direttamente dal database.

Attività comuni

Aggiungere colonne a una tabella di dati

Prima di poter configurare un oggetto DataColumn, è necessario aggiungerlo a una DataTable. È possibile procedere attenendosi a una delle procedure riportate di seguito.

Per aggiungere una colonna a una DataTable mediante Progettazione DataSet

1. Aprire il dataset in Progettazione DataSet. Per ulteriori informazioni, vedere Procedura: aprire un dataset in Progettazione DataSet.

2. Fare clic con il pulsante destro del mouse sulla DataTable da aggiungere alla colonna. Scegliere Aggiungi, quindi Colonna.

3. Se lo si desidera, sostituire il nome di colonna predefinito selezionandolo nella tabella dati e modificando il testo.

4. Impostare la proprietà DataType nella finestra Proprietà.

Per aggiungere una colonna a una DataTable mediante la Configurazione guidata origine dati

1. Nella finestra Origini dati fare clic con il pulsante destro del mouse sull'origine dati e scegliere Configura il Dataset con la procedura guidata.

2. Espandere la tabella alla quale si desidera aggiungere una colonna.

3. Selezionare le colonne da aggiungere alla tabella.

4. Fare clic su Fine.

Per aggiungere una colonna a una DataTable mediante la Configurazione guidata TableAdapter

1. Aprire il dataset in Progettazione DataSet. Per ulteriori informazioni, vedere Procedura: aprire un dataset in Progettazione DataSet.

2. Fare clic con il pulsante destro del mouse sulla tabella dati, quindi scegliere Configura.

3. Aggiungere la colonna all'istruzione SELECT.

4. Fare clic su Fine.

Configurazione DataColumn

Dopo avere aggiunto un oggetto DataColumn, specificare il comportamento di tale DataColumn. Ad esempio, è possibile modificare il tipo di dati o limitarlo in modo che contenga solo valori univoci. È possibile utilizzare una delle procedure riportate di seguito per modificare il comportamento di un oggetto DataColumn.

• Impostare il tipo di dati di un oggetto DataColumn

• Specificare la didascalia di un oggetto DataColumn

• Specificare che un oggetto DataColumn contiene numeri generati automaticamente

• Assegnare un valore predefinito a un oggetto DataColumn

• Limitare un oggetto DataColumn a valori univoci

• Impostare un oggetto DataColumn come chiave primaria in un oggetto DataTable

• Specificare il valore di ritorno quando un valore di una DataColumn è null

Impostare il tipo di dati di un oggetto DataColumn

Le colonne dati (DataColumn) vengono create con il tipo di dati predefinito String. Per modificare il tipo di dati di una colonna, impostare la proprietà DataType nella finestra Proprietà.

Per impostare il tipo di dati di un oggetto DataColumn

1. Aprire un dataset in Progettazione DataSet.

2. Selezionare la colonna per la quale impostare il tipo di dati.

3. Nella finestra Proprietà selezionare il tipo di dati desiderato dall'elenco DataType.

Specificare la didascalia di un oggetto DataColumn

Alle colonne di dati vengono spesso assegnati nomi non adatti alla visualizzazione in un'interfaccia utente. È possibile modificare la didascalia e scegliere un nome più consono mediante l'impostazione della proprietà Caption nella finestra Proprietà.

Per modificare la didascalia di una colonna dati

1. Aprire il dataset in Progettazione DataSet. Per ulteriori informazioni, vedere Procedura: aprire un dataset in Progettazione DataSet.

2. Selezionare la colonna di cui si desidera modificare la didascalia.

3. Nella finestra Proprietà impostare la proprietà Caption.

Specificare che un oggetto DataColumn contiene numeri generati automaticamente

Le colonne di dati (DataColumn) spesso contengono numeri sequenziali generati automaticamente, ad esempio chiavi primarie e colonne ID. È possibile caricare numeri generati automaticamente in colonne di dati impostando le proprietà AutoIncrement, AutoIncrementSeed e AutoIncrementStep della colonna di dati.

Le colonne di dati create con gli strumenti di progettazione di Visual Studio vengono contrassegnate automaticamente con la proprietà AutoIncrement. Durante l'aggiornamento di una tabella del database contenente una colonna Identity, i valori creati con la funzione di numerazione automatica non vengono inviati al database.

Per impostare una colonna di dati affinché contenga numeri generati automaticamente

1. Aprire il dataset in Progettazione DataSet.

2. Impostare la colonna in cui si desidera inserire numeri generati automaticamente.

3. Nella finestra Proprietà impostare le seguenti proprietà:

   Proprietà	Impostazione
   AutoIncrement	true
   AutoIncrementSeed	Per partire da un numero diverso dal numero di default pari a 0, impostare il valore sul numero iniziale della colonna.
   AutoIncrementStep	In ogni nuova riga il valore della colonna viene incrementato in base a questo valore.

   Nota

   L'impostazione di una colonna di dati sull'incremento automatico non determina la designazione automatica della colonna come chiave primaria.

Assegnare un valore predefinito a un oggetto DataColumn

Alle colonne dati è possibile assegnare valori predefiniti. L'assegnazione di tali valori avviene durante la creazione di nuove righe, ossia di nuovi record.

Per assegnare un valore predefinito a una colonna dati

1. Aprire un dataset in Progettazione DataSet.

2. Selezionare la colonna a cui assegnare un valore predefinito.

3. Nella finestra Proprietà impostare la proprietà DefaultValue sul valore predefinito desiderato.

Limitare un oggetto DataColumn a valori univoci

Per impostare un DataColumn in modo che contenga valori univoci, aggiungere un vincolo di univocità a una tabella dati. Tali vincoli sono definiti anche chiavi. Contrassegnare una colonna come chiave primaria nella Progettazione DataSet creerà un vincolo di univocità.

Per limitare una colonna a valori univoci

1. Aprire il dataset in Progettazione DataSet.

2. Fare clic con il pulsante destro del mouse sulla colonna da limitare a valori univoci. Scegliere Aggiungi, quindi Chiave.

3. Verificare che nella finestra di dialogo Vincolo UNIQUE sia selezionata la colonna corretta.

4. Se lo si desidera, sostituire il nome predefinito del vincolo con un nome più significativo.

Impostare un oggetto DataColumn come chiave primaria in un oggetto DataTable

L'impostazione di una colonna dati come chiave primaria garantisce che ogni record contenga un valore univoco. È possibile assegnare una sola chiave primaria a una tabella dati. La creazione di tale chiave può essere effettuata tramite Progettazione DataSet.

Per impostare una colonna dati come chiave primaria in una tabella dati

1. Aprire il dataset in Progettazione DataSet.

2. Fare clic con il pulsante destro del mouse sulla colonna da impostare come chiave primaria. Fare clic su Imposta chiave primaria.

   Accanto alle colonne selezionate verrà visualizzata l'icona di una chiave.

Specificare il valore di ritorno quando un valore di una DataColumn è null

In un dataset tipizzato, è possibile controllare la rappresentazione di colonne che contengono valori null. Questa funzione è disponibile soltanto quando i valori delle colonne vengono recuperati tramite i relativi accessori tipizzati. Se il valore viene recuperato mediante l'indice di riga o l'indice di colonna della tabella, non sarà possibile impostare il valore restituito. Ciò è dovuto al fatto che la logica per la restituzione di questo valore è incorporata nel metodo di impostazione delle proprietà della colonna dati specifica della classe DataSet generata.

Per impostare il valore da restituire quando un valore di DataColumn è null

1. Aprire il dataset in Progettazione DataSet.

2. Selezionare una colonna in una tabella dati.

3. Nella finestra Proprietà selezionare la proprietà NullValue.

4. Eseguire una delle operazioni seguenti:

   • Selezionare il valore appropriato dall'elenco a discesa:

     Valore	Descrizione
     (Vuoto)	Restituisce valori null String.Empty.
     (Nothing)	Restituisce valori null come DBNull.
     (Generare eccezione)	I valori null generano una Exception.

     In alternativa

   • Impostare la proprietà su qualsiasi valore personalizzato valido per il tipo di dati della colonna. Se, ad esempio, si specifica la stringa Nessun valore per una colonna il cui tipo di dati è String, per tutti i record contenenti valori null in quella colonna verrà visualizzato "Nessun valore".

Configurare una DataColumn per visualizzare un'espressione

Una tabella dati di un dataset può contenere colonne in cui il valore viene calcolato, anziché letto da un database. In un record di dettagli relativi agli ordini, ad esempio, può rivelarsi utile definire una colonna ExtendedPrice moltiplicando la quantità per il prezzo, anziché archiviando il totale effettivo. Le colonne calcolate consentono, inoltre, di aggiungere o calcolare valori nei record figlio e di filtrare altri record. Le colonne calcolate possono essere definite mediante espressioni.

La sintassi dell'espressione è costituita da operatori standard. È possibile fare riferimento a un valore di dati utilizzando il nome della colonna, come accadrebbe in un'istruzione SQL, e includere funzioni di aggregazione come Count.

L'espressione per una colonna ExtendedPrice basata sulle colonne UnitPrice moltiplicata per Quantity del record corrente può essere la seguente:

UnitPrice * Quantity

Per fare riferimento alle colonne nelle tabelle figlio, è possibile utilizzare la parola riservata Child seguita dal nome della colonna. Con la seguente espressione, ad esempio, viene restituito il valore medio della colonna Price in tutti i record figlio correlati:

Avg(Child.Price)

Per ulteriori informazioni, vedere la proprietà Expression.

È possibile creare colonne espressioni in Progettazione DataSet. Per ulteriori informazioni sulla creazione di colonne, vedere Procedura: aggiungere colonne a un oggetto DataTable.

Per creare espressioni di colonna in Progettazione DataSet

1. Aprire il dataset in Progettazione DataSet. Per ulteriori informazioni, vedere Procedura: aprire un dataset in Progettazione DataSet.

2. Nella tabella di dati desiderata selezionare la colonna a cui si desidera aggiungere l'espressione oppure aggiungere una nuova colonna alla tabella. Per ulteriori informazioni, vedere Procedura: aggiungere colonne a un oggetto DataTable.

3. Nella finestra Proprietà immettere un'espressione nella proprietà Expression.

Argomenti correlati