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

 

Data di pubblicazione: ottobre 2016

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 prodotto e non può 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 da 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.

The T:System.Windows.Forms.DataGridViewColumn class represents a logical column in a T:System.Windows.Forms.DataGridView control. You can retrieve columns through the P:System.Windows.Forms.DataGridView.Columns collection of the control.

Unlike a T:System.Windows.Forms.DataGridViewRow, which contains the actual collection of cells in a T:System.Windows.Forms.DataGridView, T:System.Windows.Forms.DataGridViewColumn is used mainly to adjust the appearance and behavior of the column user interface (UI), such as column width and cell style. For more information about cell styles, see Cell Styles in the Windows Forms DataGridView Control.

Types that derive from T:System.Windows.Forms.DataGridViewColumn typically initialize the P:System.Windows.Forms.DataGridViewColumn.CellTemplate property to a new instance of a related type derived from the T:System.Windows.Forms.DataGridViewCell class. Any column properties that relate to the appearance or behavior of individual cells are wrappers for the corresponding properties of the template cell. Changing one of these properties on the column automatically changes the value on the cell template and on all cells in the column. To override the specified value for individual cells, set the cell values after you set the column value.

Note per gli eredi:

When you derive from T:System.Windows.Forms.DataGridViewColumn and add new properties to the derived class, be sure to override the M:System.Windows.Forms.DataGridViewColumn.Clone method to copy the new properties during cloning operations. You should also call the base class's M:System.Windows.Forms.DataGridViewColumn.Clone method so that the properties of the base class are copied to the new cell.

The following code example creates a Windows Form with a T:System.Windows.Forms.DataGridView and a set of buttons. Each button label describes an operation related to a T:System.Windows.Forms.DataGridViewColumn property, such as swapping the first and last column (using the P:System.Windows.Forms.DataGridViewColumn.DisplayIndex property) or changing the text of a column header (using the P:System.Windows.Forms.DataGridViewColumn.HeaderText property). Clicking a button changes the associated property of the T:System.Windows.Forms.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

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: