DataGridViewColumn Classe
TOC
Comprimi il sommario
Espandi il sommario
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 DataGridViewColumn

 

Rappresenta una colonna in un controllo DataGridView.

Spazio dei nomi:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)


public class DataGridViewColumn : DataGridViewBand, IComponent, 
	IDisposable

NomeDescrizione
System_CAPS_pubmethodDataGridViewColumn()

Inizializza una nuova istanza della classe DataGridViewColumn in base allo stato predefinito.

System_CAPS_pubmethodDataGridViewColumn(DataGridViewCell)

Inizializza una nuova istanza della classe DataGridViewColumn usando una classe DataGridViewCell come modello.

NomeDescrizione
System_CAPS_pubpropertyAutoSizeMode

Ottiene o imposta la modalità usata per la regolazione automatica della larghezza della colonna.

System_CAPS_pubpropertyCellTemplate

Ottiene o imposta il modello usato per la creazione di nuove celle.

System_CAPS_pubpropertyCellType

Ottiene il tipo di runtime del modello di cella.

System_CAPS_pubpropertyContextMenuStrip

Ottiene o imposta il menu di scelta rapida per la colonna.(Esegue l’override di DataGridViewBand.ContextMenuStrip).

System_CAPS_pubpropertyDataGridView

Ottiene il DataGridView controllo associato a questo elemento.(Ereditato da DataGridViewElement.)

System_CAPS_pubpropertyDataPropertyName

Ottiene o imposta il nome della proprietà dell'origine dati o della colonna del database a cui è associato l'oggetto DataGridViewColumn.

System_CAPS_pubpropertyDefaultCellStyle

Ottiene o imposta lo stile predefinito per le celle della colonna.(Esegue l’override di DataGridViewBand.DefaultCellStyle).

System_CAPS_pubpropertyDefaultHeaderCellType

Ottiene o imposta il tipo in fase di esecuzione della cella di intestazione predefinito.(Ereditato da DataGridViewBand.)

System_CAPS_pubpropertyDisplayed

Ottiene un valore che indica se la banda è attualmente visualizzata sullo schermo.(Ereditato da DataGridViewBand.)

System_CAPS_pubpropertyDisplayIndex

Ottiene o imposta l'ordine di visualizzazione della colonna relativa alle colonne attualmente visualizzate.

System_CAPS_pubpropertyDividerWidth

Ottiene o imposta la larghezza, in pixel, del divisore di colonne.

System_CAPS_pubpropertyFillWeight

Ottiene o imposta un valore che rappresenta la larghezza della colonna in modalità di riempimento relativamente alle larghezze di altre colonne in modalità di riempimento presenti nel controllo.

System_CAPS_pubpropertyFrozen

Ottiene o imposta un valore che indica se una colonna si sposterà quando l'utente scorre orizzontalmente il controllo DataGridView.(Esegue l’override di DataGridViewBand.Frozen).

System_CAPS_pubpropertyHasDefaultCellStyle

Ottiene un valore che indica se la DefaultCellStyle proprietà è stata impostata.(Ereditato da DataGridViewBand.)

System_CAPS_pubpropertyHeaderCell

Ottiene o imposta l'oggetto DataGridViewColumnHeaderCell che rappresenta l'intestazione della colonna.

System_CAPS_protpropertyHeaderCellCore

Ottiene o imposta la cella dell'intestazione di DataGridViewBand.(Ereditato da DataGridViewBand.)

System_CAPS_pubpropertyHeaderText

Ottiene o imposta il testo del titolo sulla cella di intestazione della colonna.

System_CAPS_pubpropertyIndex

Ottiene la posizione relativa della banda all'interno di DataGridView controllo.(Ereditato da DataGridViewBand.)

System_CAPS_pubpropertyInheritedAutoSizeMode

Ottiene la modalità di dimensionamento attiva per la riga.

System_CAPS_pubpropertyInheritedStyle

Ottiene lo stile della cella attualmente applicato alla colonna.(Esegue l’override di DataGridViewBand.InheritedStyle).

System_CAPS_pubpropertyIsDataBound

Ottiene un valore che indica se la colonna è associata a un'origine dati.

System_CAPS_protpropertyIsRow

Ottiene un valore che indica se la banda rappresenta una riga.(Ereditato da DataGridViewBand.)

System_CAPS_pubpropertyMinimumWidth

Ottiene o imposta la larghezza minima, in pixel, della colonna.

System_CAPS_pubpropertyName

Ottiene o imposta il nome della colonna.

System_CAPS_pubpropertyReadOnly

Ottiene o imposta un valore che indica se l'utente può modificare le celle della colonna.(Esegue l’override di DataGridViewBand.ReadOnly).

System_CAPS_pubpropertyResizable

Ottiene o imposta un valore che indica se la colonna è ridimensionabile.(Esegue l’override di DataGridViewBand.Resizable).

System_CAPS_pubpropertySelected

Ottiene o imposta un valore che indica se la banda è in uno stato dell'interfaccia utente selezionato.(Ereditato da DataGridViewBand.)

System_CAPS_pubpropertySite

Questa API supporta l'infrastruttura di prodotto e non deve essere usata direttamente dal codice. Ottiene o imposta il sito della colonna.

System_CAPS_pubpropertySortMode

Ottiene o imposta la modalità di ordinamento della colonna.

System_CAPS_pubpropertyState

Ottiene lo stato dell'interfaccia utente dell'elemento.(Ereditato da DataGridViewElement.)

System_CAPS_pubpropertyTag

Ottiene o imposta l'oggetto che contiene i dati da associare alla banda.(Ereditato da DataGridViewBand.)

System_CAPS_pubpropertyToolTipText

Ottiene o imposta il testo usato per la descrizione comandi.

System_CAPS_pubpropertyValueType

Ottiene o imposta il tipo di dati dei valori delle celle della colonna.

System_CAPS_pubpropertyVisible

Ottiene o imposta un valore che indica se la colonna è visibile.(Esegue l’override di DataGridViewBand.Visible).

System_CAPS_pubpropertyWidth

Ottiene o imposta la larghezza corrente della colonna.

NomeDescrizione
System_CAPS_pubmethodClone()

Crea una copia esatta della banda.(Esegue l’override di DataGridViewBand.Clone()).

System_CAPS_pubmethodDispose()

Rilascia tutte le risorse usate dall'oggetto DataGridViewBand.(Ereditato da DataGridViewBand.)

System_CAPS_protmethodDispose(Boolean)

Rilascia le risorse non gestite usate da DataGridViewBand e, facoltativamente, le risorse gestite.(Esegue l’override di DataGridViewBand.Dispose(Boolean)).

System_CAPS_pubmethodEquals(Object)

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

System_CAPS_protmethodFinalize()

Rilascia le risorse associate alla banda.(Ereditato da DataGridViewBand.)

System_CAPS_pubmethodGetHashCode()

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

System_CAPS_pubmethodGetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)

Calcola la larghezza ideale della colonna in base ai criteri specificati.

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_protmethodOnDataGridViewChanged()

Chiamato quando la banda è associata a un altro DataGridView.(Ereditato da DataGridViewBand.)

System_CAPS_protmethodRaiseCellClick(DataGridViewCellEventArgs)

Genera l'evento DataGridView.CellClick.(Ereditato da DataGridViewElement.)

System_CAPS_protmethodRaiseCellContentClick(DataGridViewCellEventArgs)

Genera l'evento DataGridView.CellContentClick.(Ereditato da DataGridViewElement.)

System_CAPS_protmethodRaiseCellContentDoubleClick(DataGridViewCellEventArgs)
System_CAPS_protmethodRaiseCellValueChanged(DataGridViewCellEventArgs)

Genera l'evento DataGridView.CellValueChanged.(Ereditato da DataGridViewElement.)

System_CAPS_protmethodRaiseDataError(DataGridViewDataErrorEventArgs)

Genera l'evento DataGridView.DataError.(Ereditato da DataGridViewElement.)

System_CAPS_protmethodRaiseMouseWheel(MouseEventArgs)

Genera l'evento Control.MouseWheel.(Ereditato da DataGridViewElement.)

System_CAPS_pubmethodToString()

Ottiene una stringa che descrive la colonna.(Esegue l’override di DataGridViewBand.ToString()).

NomeDescrizione
System_CAPS_pubeventDisposed

Si verifica quando viene eliminato l'oggetto DataGridViewColumn.

La DataGridViewColumn classe rappresenta una colonna logica in un DataGridView controllo. È possibile recuperare colonne tramite il Columns insieme del controllo.

A differenza di un DataGridViewRow, che contiene l'insieme di celle in un DataGridView, DataGridViewColumn viene utilizzata principalmente per regolare l'aspetto e comportamento dell'interfaccia utente della colonna (UI), ad esempio stile di cella e la larghezza di colonna. Per ulteriori informazioni sugli stili di cella, vedere Stili della cella nel controllo DataGridView Windows Form.

Tipi che derivano da DataGridViewColumn solitamente inizializzano la CellTemplate proprietà in una nuova istanza del tipo correlato derivato dalla DataGridViewCell classe. Le proprietà di colonna che riguardano l'aspetto o il comportamento delle singole celle sono wrapper per le proprietà della cella modello corrispondente. La modifica di una di queste proprietà nella colonna automaticamente cambia il valore nel modello di cella e su tutte le celle nella colonna. Per sostituire il valore specificato per le singole celle, impostare i valori delle celle dopo aver impostato il valore della colonna.

Note per gli eredi:

Quando si deriva da DataGridViewColumn e si aggiungono nuove proprietà alla classe derivata, assicurarsi di eseguire l'override di Clone metodo per copiare le nuove proprietà durante le operazioni di clonazione. È anche necessario chiamare la classe di base Clone metodo in modo che le proprietà della classe base vengano copiate nella nuova cella.

L'esempio di codice seguente viene creato un Windows Form con un DataGridView e un set di pulsanti. Ogni etichetta del pulsante descrive un'operazione correlata a un DataGridViewColumn proprietà, ad esempio la sostituzione della prima e ultima colonna (mediante la DisplayIndex proprietà) o la modifica del testo di un'intestazione di colonna (utilizzando la HeaderText proprietà). Fare clic su un pulsante Modifica la proprietà associata di DataGridViewColumn.

using System.Windows.Forms;
using System;
using System.Drawing;

public class DataGridViewColumnDemo : Form
{
    #region "set up form"
    public DataGridViewColumnDemo()
    {
        InitializeComponent();

        AddButton(Button1, "Reset",
            new EventHandler(ResetToDisorder));
        AddButton(Button2, "Change Column 3 Header",
            new EventHandler(ChangeColumn3Header));
        AddButton(Button3, "Change Meatloaf Recipe",
            new EventHandler(ChangeMeatloafRecipe));
        AddAdditionalButtons();

        InitializeDataGridView();
    }

    DataGridView dataGridView;
    Button Button1 = new Button();
    Button Button2 = new Button();
    Button Button3 = new Button();
    Button Button4 = new Button();
    Button Button5 = new Button();
    Button Button6 = new Button();
    Button Button7 = new Button();
    Button Button8 = new Button();
    Button Button9 = new Button();
    Button Button10 = new Button();
    FlowLayoutPanel FlowLayoutPanel1 = new FlowLayoutPanel();

    private void InitializeComponent()
    {
        FlowLayoutPanel1.Location = new Point(454, 0);
        FlowLayoutPanel1.AutoSize = true;
        FlowLayoutPanel1.FlowDirection = FlowDirection.TopDown;
        FlowLayoutPanel1.Name = "flowlayoutpanel";
        ClientSize = new System.Drawing.Size(614, 360);
        Controls.Add(this.FlowLayoutPanel1);
        Text = this.GetType().Name;
        AutoSize = true;
    }
    #endregion

    #region "set up DataGridView"

    private string thirdColumnHeader = "Main Ingredients";
    private string boringMeatloaf = "ground beef";
    private string boringMeatloafRanking = "*";
    private bool boringRecipe;
    private bool shortMode;

    private void InitializeDataGridView()
    {
        dataGridView = new System.Windows.Forms.DataGridView();
        Controls.Add(dataGridView);
        dataGridView.Size = new Size(300, 200);

        // Create an unbound DataGridView by declaring a
        // column count.
        dataGridView.ColumnCount = 4;
        AdjustDataGridViewSizing();

        // Set the column header style.
        DataGridViewCellStyle columnHeaderStyle =
            new DataGridViewCellStyle();
        columnHeaderStyle.BackColor = Color.Aqua;
        columnHeaderStyle.Font =
            new Font("Verdana", 10, FontStyle.Bold);
        dataGridView.ColumnHeadersDefaultCellStyle =
            columnHeaderStyle;

        // Set the column header names.
        dataGridView.Columns[0].Name = "Recipe";
        dataGridView.Columns[1].Name = "Category";
        dataGridView.Columns[2].Name = thirdColumnHeader;
        dataGridView.Columns[3].Name = "Rating";

        PostColumnCreation();

        // Populate the rows.
        string[] row1 = new string[]{"Meatloaf", 
                                        "Main Dish", boringMeatloaf, boringMeatloafRanking};
        string[] row2 = new string[]{"Key Lime Pie", 
                                        "Dessert", "lime juice, evaporated milk", "****"};
        string[] row3 = new string[]{"Orange-Salsa Pork Chops", 
                                        "Main Dish", "pork chops, salsa, orange juice", "****"};
        string[] row4 = new string[]{"Black Bean and Rice Salad", 
                                        "Salad", "black beans, brown rice", "****"};
        string[] row5 = new string[]{"Chocolate Cheesecake", 
                                        "Dessert", "cream cheese", "***"};
        string[] row6 = new string[]{"Black Bean Dip", "Appetizer",
                                        "black beans, sour cream", "***"};
        object[] rows = new object[] { row1, row2, row3, row4, row5, row6 };

        foreach (string[] rowArray in rows)
        {
            dataGridView.Rows.Add(rowArray);
        }

        shortMode = false;
        boringRecipe = true;
    }

    private void AddButton(Button button, string buttonLabel,
        EventHandler handler)
    {
        FlowLayoutPanel1.Controls.Add(button);
        button.TabIndex = FlowLayoutPanel1.Controls.Count;
        button.Text = buttonLabel;
        button.AutoSize = true;
        button.Click += handler;
    }

    private void ResetToDisorder(object sender, System.EventArgs e)
    {
        Controls.Remove(dataGridView);
        dataGridView.Dispose();
        InitializeDataGridView();
    }

    private void ChangeColumn3Header(object sender,
        System.EventArgs e)
    {
        Toggle(ref shortMode);
        if (shortMode)
        { dataGridView.Columns[2].HeaderText = "S"; }
        else
        { dataGridView.Columns[2].HeaderText = thirdColumnHeader; }
    }

    private static void Toggle(ref bool toggleThis)
    {
        toggleThis = !toggleThis;
    }

    private void ChangeMeatloafRecipe(object sender,
        System.EventArgs e)
    {
        Toggle(ref boringRecipe);
        if (boringRecipe)
        {
            SetMeatloaf(boringMeatloaf, boringMeatloafRanking);
        }
        else
        {
            string greatMeatloafRecipe =
                "1 lb. lean ground beef, " +
                "1/2 cup bread crumbs, 1/4 cup ketchup," +
                "1/3 tsp onion powder, " +
                "1 clove of garlic, 1/2 pack onion soup mix " +
                " dash of your favorite BBQ Sauce";
            SetMeatloaf(greatMeatloafRecipe, "***");
        }
    }

    private void SetMeatloaf(string recipe, string rating)
    {
        dataGridView.Rows[0].Cells[2].Value = recipe;
        dataGridView.Rows[0].Cells[3].Value = rating;
    }
    #endregion

    #region "demonstration code"
    private void PostColumnCreation()
    {
        AddContextLabel();
        AddCriteriaLabel();
        CustomizeCellsInThirdColumn();
        AddContextMenu();
        SetDefaultCellInFirstColumn();
        ToolTips();

        dataGridView.CellMouseEnter +=
            dataGridView_CellMouseEnter;
        dataGridView.AutoSizeColumnModeChanged +=
            dataGridView_AutoSizeColumnModeChanged;
    }

    private string criteriaLabel = "Column 3 sizing criteria: ";
    private void AddCriteriaLabel()
    {
        AddLabelToPanelIfNotAlreadyThere(criteriaLabel,
            criteriaLabel +
            dataGridView.Columns[2].AutoSizeMode.ToString() +
            ".");
    }

    private void AddContextLabel()
    {
        string labelName = "label";
        AddLabelToPanelIfNotAlreadyThere(labelName,
            "Use shortcut menu to change cell color.");
    }

    private void AddLabelToPanelIfNotAlreadyThere(
        string labelName, string labelText)
    {
        Label label;
        if (FlowLayoutPanel1.Controls[labelName] == null)
        {
            label = new Label();
            label.AutoSize = true;
            label.Name = labelName;
            label.BackColor = Color.Bisque;
            FlowLayoutPanel1.Controls.Add(label);
        }
        else
        {
            label = (Label)FlowLayoutPanel1.Controls[labelName];
        }
        label.Text = labelText;
    }

    private void CustomizeCellsInThirdColumn()
    {
        int thirdColumn = 2;
        DataGridViewColumn column =
            dataGridView.Columns[thirdColumn];
        DataGridViewCell cell = new DataGridViewTextBoxCell();

        cell.Style.BackColor = Color.Wheat;
        column.CellTemplate = cell;
    }

    ToolStripMenuItem toolStripItem1 = new ToolStripMenuItem();

    private void AddContextMenu()
    {
        toolStripItem1.Text = "Redden";
        toolStripItem1.Click += new EventHandler(toolStripItem1_Click);
        ContextMenuStrip strip = new ContextMenuStrip();
        foreach (DataGridViewColumn column in dataGridView.Columns)
        {

            column.ContextMenuStrip = strip;
            column.ContextMenuStrip.Items.Add(toolStripItem1);
        }
    }

    private DataGridViewCellEventArgs mouseLocation;

    // Change the cell's color.
    private void toolStripItem1_Click(object sender, EventArgs args)
    {
        dataGridView.Rows[mouseLocation.RowIndex]
            .Cells[mouseLocation.ColumnIndex].Style.BackColor
            = Color.Red;
    }

    // Deal with hovering over a cell.
    private void dataGridView_CellMouseEnter(object sender,
        DataGridViewCellEventArgs location)
    {
        mouseLocation = location;
    }

    private void SetDefaultCellInFirstColumn()
    {
        DataGridViewColumn firstColumn = dataGridView.Columns[0];
        DataGridViewCellStyle cellStyle =
            new DataGridViewCellStyle();
        cellStyle.BackColor = Color.Thistle;

        firstColumn.DefaultCellStyle = cellStyle;
    }


    private void ToolTips()
    {
        DataGridViewColumn firstColumn = dataGridView.Columns[0];
        DataGridViewColumn thirdColumn = dataGridView.Columns[2];
        firstColumn.ToolTipText =
            "This column uses a default cell.";
        thirdColumn.ToolTipText =
            "This column uses a template cell." +
            " Style changes to one cell apply to all cells.";
    }

    private void AddAdditionalButtons()
    {
        AddButton(Button4, "Set Minimum Width of Column Two",
            new EventHandler(Button4_Click));
        AddButton(Button5, "Set Width of Column One",
            new EventHandler(Button5_Click));
        AddButton(Button6, "Autosize Third Column",
            new EventHandler(Button6_Click));
        AddButton(Button7, "Add Thick Vertical Edge",
            new EventHandler(Button7_Click));
        AddButton(Button8, "Style and Number Columns",
            new EventHandler(Button8_Click));
        AddButton(Button9, "Change Column Header Text",
            new EventHandler(Button9_Click));
        AddButton(Button10, "Swap First and Last Columns",
            new EventHandler(Button10_Click));
    }

    private void AdjustDataGridViewSizing()
    {
        dataGridView.ColumnHeadersHeightSizeMode = 
            DataGridViewColumnHeadersHeightSizeMode.AutoSize;
    }

    //Set the minimum width.
    private void Button4_Click(object sender,
        System.EventArgs e)
    {
        DataGridViewColumn column = dataGridView.Columns[1];
        column.MinimumWidth = 40;
    }

    // Set the width.
    private void Button5_Click(object sender, System.EventArgs e)
    {
        DataGridViewColumn column = dataGridView.Columns[0];
        column.Width = 60;
    }


    // AutoSize the third column.
    private void Button6_Click(object sender,
        System.EventArgs e)
    {
        DataGridViewColumn column = dataGridView.Columns[2];
        column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells;
    }

    // Set the vertical edge.
    private void Button7_Click(object sender,
        System.EventArgs e)
    {
        int thirdColumn = 2;
        DataGridViewColumn column =
            dataGridView.Columns[thirdColumn];
        column.DividerWidth = 10;
    }

    // Style and number columns.
    private void Button8_Click(object sender,
        EventArgs args)
    {
        DataGridViewCellStyle style = new DataGridViewCellStyle();
        style.Alignment =
            DataGridViewContentAlignment.MiddleCenter;
        style.ForeColor = Color.IndianRed;
        style.BackColor = Color.Ivory;

        foreach (DataGridViewColumn column in dataGridView.Columns)
        {
            column.HeaderCell.Value = column.Index.ToString();
            column.HeaderCell.Style = style;
        }
    }

    // Change the text in the column header.
    private void Button9_Click(object sender,
        EventArgs args)
    {
        foreach (DataGridViewColumn column in dataGridView.Columns)
        {

            column.HeaderText = String.Concat("Column ",
                column.Index.ToString());
        }
    }

    // Swap the last column with the first.
    private void Button10_Click(object sender, EventArgs args)
    {
        DataGridViewColumnCollection columnCollection = dataGridView.Columns;

        DataGridViewColumn firstVisibleColumn =
            columnCollection.GetFirstColumn(DataGridViewElementStates.Visible);
        DataGridViewColumn lastVisibleColumn =
            columnCollection.GetLastColumn(
                DataGridViewElementStates.Visible, DataGridViewElementStates.None);

        int firstColumn_sIndex = firstVisibleColumn.DisplayIndex;
        firstVisibleColumn.DisplayIndex = lastVisibleColumn.DisplayIndex;
        lastVisibleColumn.DisplayIndex = firstColumn_sIndex;
    }

    // Updated the criteria label.
    private void dataGridView_AutoSizeColumnModeChanged(object sender,
        DataGridViewAutoSizeColumnModeEventArgs args)
    {
        args.Column.DataGridView.Parent.
            Controls["flowlayoutpanel"].Controls[criteriaLabel].
            Text = criteriaLabel
            + args.Column.AutoSizeMode.ToString();
    }
    #endregion

    [STAThreadAttribute()]
    public static void Main()
    {
        Application.Run(new DataGridViewColumnDemo());
    }

}

.NET Framework
Disponibile da 2.0

Eventuali membri pubblici statici (Shared in Visual Basic) di questo tipo sono thread-safe. I membri di istanza non sono garantiti come thread-safe.

Torna all'inizio
Mostra:
© 2016 Microsoft