Condividi tramite

Colonne, finestra di dialogo Proprietà DataGrid

  • Articolo

Aggiornamento: novembre 2007

La scheda Colonne della finestra di dialogo Proprietà DataGrid consente di:

  • Specificare quali colonne di dati devono essere visualizzate nella griglia.

  • Definire le colonne con funzioni speciali, quali ad esempio la modifica e la selezione degli elementi.

  • Definire le colonne modello.

  • Specificare le informazioni specifiche delle singole colonne, come ad esempio un'espressione di ordinamento o il nome di un comando.

  • Definire l'intestazione e il piè di pagina, il contenuto e l'associazione dati di ogni colonna della griglia.

Dopo aver definito una colonna, è possibile impostarne le proprietà. Le opzioni della scheda Colonne variano a seconda del tipo di colonna DataGrid in uso.

Nota:

ASP.NET versione 2.0 dispone di un nuovo controllo server, GridView, dotato di un numero maggiore di funzionalità rispetto al controllo DataGrid. Per ulteriori informazioni, vedere Confronto dei controlli server Web GridView e DataGrid.

  1. Aprire o creare una pagina ASPX in Microsoft Visual Web Developer.

  2. Nella visualizzazione Origine aggiungere un controllo DataGrid alla pagina nell'elemento <form>. Il codice potrebbe essere simile al seguente:

    <form id="form1" >
    <div>
    <asp:DataGrid ID="DataGrid1" ></asp:DataGrid>
    </div>
</form>

  3. Passare alla visualizzazione Progettazione.

  4. Fare clic con il pulsante destro del mouse sul controllo DataGrid e scegliere Mostra smart tag.

    Verrà visualizzata la finestra Attività di DataGrid.

  5. Fare clic su Generatore proprietà.

    Verrà visualizzata la finestra di dialogo Proprietà DataGrid.

  6. Fare clic sulla scheda Colonne.

Attività

Elementi di interfaccia

  • Crea le colonne automaticamente in fase di esecuzione
    Consente di specificare se la griglia durante l'esecuzione deve includere tutti i campi dati compresi nell'origine dati a cui è associata. Queste colonne non possono essere rimosse né formattate.

    È possibile aggiungere colonne, incluse le colonne con associazione a dati e le colonne di pulsanti, di collegamenti ipertestuali e di modelli, come descritto di seguito nella sezione "Elenco delle colonne". Ogni colonna aggiunta viene visualizzata a sinistra delle colonne generate automaticamente.

Elenco delle colonne

L'elenco delle colonne consente di specificare quali colonne verranno visualizzate nella griglia. È possibile aggiungere campi dall'origine dati e vari tipi di pulsanti.

Per aggiungere una colonna, selezionarne il tipo in Colonne disponibili e scegliere il pulsante Aggiungi per aggiungerla all'elenco Colonne selezionate. Per specificare la posizione della colonna nella griglia, selezionare la colonna nell'elenco Colonne selezionate e spostarla con i pulsanti di riordinamento. Per rimuovere una colonna dalla griglia, selezionarla nell'elenco Colonne selezionate e scegliere il pulsante Elimina.

  • Colonne disponibili
    Comprende tutte le colonne che possono essere visualizzate nella griglia, suddivise nei seguenti nodi:

    • Colonna associata Consente di aggiungere singole colonne di dati tra quelle disponibili nell'origine dati selezionata nella scheda Generale.

      Quando è selezionato Crea le colonne automaticamente in fase di esecuzione, in questo nodo vengono visualizzate tutte le colonne. Per visualizzare solo alcune delle colonne, deselezionare Crea le colonne automaticamente in fase di esecuzione e aggiungere i campi dati desiderati.

    • Colonna pulsante  Consente di aggiungere colonne contenenti pulsanti, di comando e di collegamento, su cui l'utente può fare clic per eseguire azioni specifiche per un singolo elemento. Espandere il nodo Colonna pulsante per aggiungere pulsanti Select, Delete o Edit alla griglia. Per aggiungere un pulsante personalizzato, come ad esempio un pulsante contenente la stringa "Aggiungere al carrello", selezionare il nodo Colonna pulsante, fare clic sul pulsante Aggiungi e poi formattare il pulsante personalizzato.

    • Colonna collegamento ipertestuale   Consente di aggiungere una colonna che conterrà un collegamento a un'altra pagina. La colonna collegamento ipertestuale può contenere un testo statico oppure può visualizzare una colonna di dati come un collegamento ipertestuale.

    • Colonna modello   Consente di creare una colonna contenente una qualunque combinazione di testo e controlli HTML. Le colonne modello consentono di inserire controlli che non siano pulsanti, come ad esempio caselle di controllo, in un controllo DataGrid.

  • Colonne selezionate
    Consente di visualizzare un elenco di colonne personalizzabili. Quando si seleziona una colonna da questo elenco, le opzioni sottostanti l'elenco nella finestra di dialogo variano a seconda delle impostazioni personalizzabili di quella specifica colonna.

    Se è selezionato Crea le colonne automaticamente in fase di esecuzione, in Colonne selezionate saranno elencate le colonne che verranno visualizzate oltre a quelle generate automaticamente.

Proprietà colonne

  • HeaderText
    Consente di specificare il testo visualizzato nella parte superiore della colonna. Il valore dell'intestazione può essere impostato su qualunque testo HTML, tag inclusi. È possibile specificare il tipo di carattere e il colore del piè di pagina nella Scheda Formato.

    Il testo specificato per l'intestazione diventa l'identificatore della colonna nell'elenco Colonne selezionate.

    Le intestazioni vengono visualizzate solo se è selezionata la casella di controllo Mostra intestazione nella scheda Generale.

  • FooterText
    Consente di specificare il testo visualizzato nella parte inferiore della colonna. Per impostazione predefinita, il testo non è specificato. Il valore del piè di pagina può essere impostato su qualunque testo HTML, tag inclusi. È possibile specificare il tipo di carattere e il colore dell'intestazione nella scheda Formato.

    I piè di pagina vengono visualizzati solo se è selezionata la casella di controllo Mostra piè di pagina nella scheda Generale.

  • HeaderImage
    Consente di selezionare il file di immagine che verrà visualizzato nella parte superiore della colonna. Se si specificano sia il testo che l'immagine dell'intestazione, quest'ultima avrà la precedenza sul primo.

  • SortExpression
    Consente di specificare la stringa che verrà passata come parametro quando verrà generato l'evento SortCommand. Generalmente viene selezionata la casella di controllo Consenti ordinamento della scheda Generale. Questa opzione fa sì che le intestazioni delle colonne vengano rappresentate come controlli LinkButton che generano l'evento SortCommand quando l'utente li seleziona.

    Per le colonne associate l'espressione predefinita di ordinamento è il nome del campo dati a cui è associata la colonna. È possibile tuttavia specificare una stringa qualsiasi.

  • Visible
    Consente di specificare se la colonna sarà visibile per impostazione predefinita quando verrà eseguita la pagina. Deselezionando questa casella di controllo è possibile definire una colonna specificandone le informazioni di associazione e formattazione e visualizzarla o nasconderla dinamicamente in fase d'esecuzione.

Proprietà BoundColumn

Le opzioni disponibili in Proprietà BoundColumn vengono visualizzate se si seleziona Colonna associata da Colonne disponibili e si fa clic sul pulsante freccia per spostarla in Colonne selezionate.

  • DataField
    Consente di visualizzare il nome del campo dati a cui è associata la colonna. Di sola lettura.

  • DataFormattingExpression
    Consente di specificare un'espressione di formattazione di .NET Framework che viene applicata ai dati prima che questi siano visualizzati nella colonna. L'espressione è costituita da testo statico facoltativo e un identificatore di formato che presenta la forma seguente:

    {0:format specifier}

    Il numero che precede i due punti (:) è un indice del parametro che indica gli elementi di dati nella colonna da formattare. In genere è zero per indicare il primo e unico elemento. L'identificatore di formatosegue i due punti ed è composto da una o più lettere che indicano come formattare i dati. I caratteri dell'identificatore di formato che è possibile utilizzare dipendono dal tipo di dati formattati, ad esempio, date, numeri o altri. Nella tabella seguente vengono presentati esempi di espressioni di formattazione per tipi di dati diversi. Per ulteriori informazioni sulle espressioni di formattazione, vedere Formattazione dei tipi di dati.

    Espressione di formato

    Applicata a questo tipo di dati

    Descrizione

    Price: {0:C}

    numeric/decimal

    Viene visualizzata la stringa letterale "Price:" seguita da numeri nel formato della valuta. Il formato della valuta dipende dalle impostazioni cultura specificate nell'attributo culture dell'istruzione @ Page o del file Web.config.

    {0:D4}

    integer (non può essere utilizzato con i numeri decimali)

    I valori integer vengono visualizzati in un campo a spaziatura zero di quattro caratteri.

    {0:N2}%

    numeric

    Viene visualizzato il numero con la precisione di 2 cifre decimali seguito dalla stringa letterale "%".

    {0:000.0}

    numeric/decimal

    Numeri arrotondati ad una cifra decimale. I numeri composti da meno di tre cifre hanno spaziatura zero.

    {0:D}

    date/datetime

    Formato data estesa ("giovedì, 6 agosto, 1996"). Il formato della data dipende dalle impostazioni cultura nell'istruzione Page o nel file Web.config.

    {0:d}

    date/datetime

    Formato data breve ("31/12/99").

    {0:yy-MM-dd}

    date/datetime

    Data nel formato numerico anno-mese-giorno (96-08-06).

  • Proprietà in sola lettura
    Consente di specificare se i dati della colonna devono essere visualizzati in un controllo modificabile quando l'elemento si trova in modalità di modifica.

Proprietà ButtonColumn

Le opzioni disponibili in Proprietà ButtonColumn vengono visualizzate se si seleziona Colonna pulsante da Colonne disponibili e si fa clic sul pulsante freccia per spostarla in Colonne selezionate.

  • Text
    Consente di specificare il testo o didascalia dei pulsanti che visualizzano lo stesso testo per ogni elemento della griglia. Se ad esempio si deve definire un pulsante che visualizza la parola "Seleziona" per ogni elemento della griglia, si imposta la proprietà Text. La proprietà TextField, se impostata, eseguirà l'override di questa proprietà.

  • Nome comando
    Consente di specificare la stringa che viene passata con l'evento ItemCommand quando gli utenti fanno clic sul pulsante.

  • TextField
    Consente di specificare il campo dell'origine dati come origine della didascalia del pulsante. Se si imposta sia questa proprietà che la proprietà Text, la proprietà TextField avrà la precedenza.

  • ButtonType
    Consente di specificare il tipo di pulsante che deve essere rappresentato, ovvero LinkButton o PushButton. L'impostazione predefinita è un controllo LinkButton.

  • TextFormatString
    Consente di specificare un'espressione di formattazione di .NET Framework che viene applicata alla didascalia del pulsante prima che questa venga visualizzata. Questa proprietà risulta utile quando la didascalia di un pulsante è impostata con la proprietà TextField, ma i dati non sono in un formato adatto alla visualizzazione. Per informazioni dettagliate, vedere la sezione precedente "Proprietà BoundColumn".

Proprietà EditCommandColumn

Le opzioni disponibili in Proprietà EditButtonColumn vengono visualizzate se in Colonne selezionate è selezionata una colonna di pulsanti Edit.

  • EditText
    Consente di specificare la stringa da visualizzare sul pulsante Edit.

  • CancelText
    Consente di specificare la stringa da visualizzare sul pulsante Cancel.

  • UpdateText
    Consente di specificare la stringa da visualizzare sul pulsante Update.

  • ButtonType
    Consente di specificare il tipo di pulsante che deve essere rappresentato, ovvero LinkButton o PushButton. L'impostazione predefinita è un controllo LinkButton.

Proprietà HyperLinkColumn

Le opzioni disponibili in Proprietà HyperLinkColumn vengono visualizzate se si seleziona Colonna collegamento ipertestuale da Colonne disponibili e si fa clic sul pulsante freccia per spostarla in Colonne selezionate.

  • Text
    Consente di specificare il testo del collegamento ipertestuale se i collegamenti hanno lo stesso testo per ogni elemento della griglia.

  • URL
    Consente di specificare l'URL della pagina a cui deve portare il collegamento La proprietà URLField, se impostata, esegue l'override di questa proprietà.

  • TextField
    Consente di specificare il campo dell'origine dati come origine del testo del collegamento ipertestuale.

  • URLField
    Consente di specificare il campo o la proprietà dell'oggetto indicato in DataSource che dovrà fornire l'URL della pagina a cui deve portare il collegamento. Questa proprietà esegue l'override dell'impostazione di URL.

  • TextFormatString
    Consente di specificare un identificatore di formattazione di .NET Framework che viene applicato al collegamento ipertestuale prima che questo sia visualizzato. Questa proprietà risulta utile quando il testo del collegamento ipertestuale è impostato con la proprietà TextField, ma i dati non sono in un formato adatto alla visualizzazione. Per informazioni dettagliate, vedere la sezione precedente "Proprietà BoundColumn".

  • URLFormatString
    Consente di specificare l'espressione di formattazione dell'URL. Tale espressione può comprendere un'espressione di formattazione di .NET Framework. È possibile utilizzare ad esempio un formato URL come quello che segue:

    images/Title-{0}.gif

    Questo formato potrebbe restituire un URL come il seguente:

    images/Title-1.gif

    Per informazioni dettagliate, vedere la sezione precedente "Proprietà BoundColumn".

  • Target
    La finestra nella quale questa colonna di pulsanti verrà visualizzata. Immettere il nome di una finestra che sarà disponibile al momento dell'esecuzione oppure effettuare una selezione dall'elenco predefinito di identificatori di finestre standard.

  • Converti questa colonna in una colonna modello
    Consente di creare nuovamente la colonna selezionata perché venga utilizzata come un modello costituito da una combinazione di testo e controlli HTML. Ciò consente di specificare con precisione l'aspetto della colonna.

Vedere anche

Concetti

Confronto dei controlli server Web GridView e DataGrid