DataGridView.MultiSelect DataGridView.MultiSelect DataGridView.MultiSelect DataGridView.MultiSelect Property

Definition

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob mehr als eine Zelle, Zeile oder Spalte der DataGridView zum gleichen Zeitpunkt ausgewählt werden kann.Gets or sets a value indicating whether the user is allowed to select more than one cell, row, or column of the DataGridView at a time.

public:
 property bool MultiSelect { bool get(); void set(bool value); };
public bool MultiSelect { get; set; }
member this.MultiSelect : bool with get, set
Public Property MultiSelect As Boolean

Eigenschaftswert

true , wenn mehrere Zellen, Zeilen oder Spalten zum gleichen Zeitpunkt ausgewählt werden können, andernfalls false.true if the user can select more than one cell, row, or column at a time; otherwise, false. Die Standardeinstellung ist true.The default is true.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der MultiSelect -Eigenschaft veranschaulicht.The following code example demonstrates how to use the MultiSelect property. Um dieses Beispiel auszuführen, fügen Sie den Code in ein Formular ein, DataGridView das dataGridView1einen mit dem Namen enthält SetUpDataGridView , und dann die-Methode aus dem Load Konstruktor oder Ereignishandler des Formulars.To run this example, paste the code into a form that contains a DataGridView named dataGridView1, and then call the SetUpDataGridView method from the form's constructor or Load event handler. Stellen Sie sicher, dass alle Ereignisse ihren Ereignis Handlern zugeordnet sind.Ensure all events are associated with their event handlers.

void SetUpDataGridView()
{
   this->Controls->Add( dataGridView1 );
   dataGridView1->ColumnCount = 5;
   DataGridViewCellStyle^ style = dataGridView1->ColumnHeadersDefaultCellStyle;
   style->BackColor = Color::Navy;
   style->ForeColor = Color::White;
   style->Font = gcnew System::Drawing::Font( dataGridView1->Font,FontStyle::Bold );
   dataGridView1->EditMode = DataGridViewEditMode::EditOnEnter;
   dataGridView1->Name = "dataGridView1";
   dataGridView1->Location = Point(8,8);
   dataGridView1->Size = System::Drawing::Size( 500, 300 );
   dataGridView1->AutoSizeRowsMode = DataGridViewAutoSizeRowsMode::DisplayedCellsExceptHeaders;
   dataGridView1->ColumnHeadersBorderStyle = DataGridViewHeaderBorderStyle::Raised;
   dataGridView1->CellBorderStyle = DataGridViewCellBorderStyle::Single;
   dataGridView1->GridColor = SystemColors::ActiveBorder;
   dataGridView1->RowHeadersVisible = false;
   dataGridView1->Columns[ 0 ]->Name = "Release Date";
   dataGridView1->Columns[ 1 ]->Name = "Track";
   dataGridView1->Columns[ 1 ]->DefaultCellStyle->Alignment = DataGridViewContentAlignment::MiddleCenter;
   dataGridView1->Columns[ 2 ]->Name = "Title";
   dataGridView1->Columns[ 3 ]->Name = "Artist";
   dataGridView1->Columns[ 4 ]->Name = "Album";

   // Make the font italic for row four.
   dataGridView1->Columns[ 4 ]->DefaultCellStyle->Font = gcnew System::Drawing::Font( DataGridView::DefaultFont,FontStyle::Italic );
   dataGridView1->SelectionMode = DataGridViewSelectionMode::FullRowSelect;
   dataGridView1->MultiSelect = false;
   dataGridView1->BackgroundColor = Color::Honeydew;
   dataGridView1->Dock = DockStyle::Fill;
   dataGridView1->CellFormatting += gcnew DataGridViewCellFormattingEventHandler( this, &Form1::dataGridView1_CellFormatting );
   dataGridView1->CellParsing += gcnew DataGridViewCellParsingEventHandler( this, &Form1::dataGridView1_CellParsing );
   addNewRowButton->Click += gcnew EventHandler( this, &Form1::addNewRowButton_Click );
   deleteRowButton->Click += gcnew EventHandler( this, &Form1::deleteRowButton_Click );
   ledgerStyleButton->Click += gcnew EventHandler( this, &Form1::ledgerStyleButton_Click );
   dataGridView1->CellValidating += gcnew DataGridViewCellValidatingEventHandler( this, &Form1::dataGridView1_CellValidating );
}
private void SetUpDataGridView()
{
    this.Controls.Add(dataGridView1);
    dataGridView1.ColumnCount = 5;
    DataGridViewCellStyle style = 
        dataGridView1.ColumnHeadersDefaultCellStyle;
    style.BackColor = Color.Navy;
    style.ForeColor = Color.White;
    style.Font = new Font(dataGridView1.Font, FontStyle.Bold);

    dataGridView1.EditMode = DataGridViewEditMode.EditOnEnter;
    dataGridView1.Name = "dataGridView1";
    dataGridView1.Location = new Point(8, 8);
    dataGridView1.Size = new Size(500, 300);
    dataGridView1.AutoSizeRowsMode = 
        DataGridViewAutoSizeRowsMode.DisplayedCellsExceptHeaders;
    dataGridView1.ColumnHeadersBorderStyle = 
        DataGridViewHeaderBorderStyle.Raised;
    dataGridView1.CellBorderStyle = DataGridViewCellBorderStyle.Single;
    dataGridView1.GridColor = SystemColors.ActiveBorder;
    dataGridView1.RowHeadersVisible = false;

    dataGridView1.Columns[0].Name = "Release Date";
    dataGridView1.Columns[1].Name = "Track";
    dataGridView1.Columns[1].DefaultCellStyle.Alignment = 
        DataGridViewContentAlignment.MiddleCenter;
    dataGridView1.Columns[2].Name = "Title";
    dataGridView1.Columns[3].Name = "Artist";
    dataGridView1.Columns[4].Name = "Album";

    // Make the font italic for row four.
    dataGridView1.Columns[4].DefaultCellStyle.Font = new Font(DataGridView.DefaultFont, FontStyle.Italic);

    dataGridView1.SelectionMode = DataGridViewSelectionMode.FullRowSelect;
    dataGridView1.MultiSelect = false;

    dataGridView1.BackgroundColor = Color.Honeydew;

    dataGridView1.Dock = DockStyle.Fill;

    dataGridView1.CellFormatting += new DataGridViewCellFormattingEventHandler(dataGridView1_CellFormatting);
    dataGridView1.CellParsing += new DataGridViewCellParsingEventHandler(dataGridView1_CellParsing);
    addNewRowButton.Click += new EventHandler(addNewRowButton_Click);
    deleteRowButton.Click += new EventHandler(deleteRowButton_Click);
    ledgerStyleButton.Click += new EventHandler(ledgerStyleButton_Click);
    dataGridView1.CellValidating += new DataGridViewCellValidatingEventHandler(dataGridView1_CellValidating);

}
Private Sub SetUpDataGridView()

    Me.Controls.Add(dataGridView1)
    dataGridView1.ColumnCount = 5

    With dataGridView1.ColumnHeadersDefaultCellStyle
        .BackColor = Color.Navy
        .ForeColor = Color.White
        .Font = New Font(dataGridView1.Font, FontStyle.Bold)
    End With

    With dataGridView1
        .EditMode = DataGridViewEditMode.EditOnEnter
        .Name = "dataGridView1"
        .Location = New Point(8, 8)
        .Size = New Size(500, 300)
        .AutoSizeRowsMode = _
            DataGridViewAutoSizeRowsMode.DisplayedCellsExceptHeaders
        .ColumnHeadersBorderStyle = _
            DataGridViewHeaderBorderStyle.Raised
        .CellBorderStyle = _
            DataGridViewCellBorderStyle.Single
        .GridColor = SystemColors.ActiveBorder
        .RowHeadersVisible = False

        .Columns(0).Name = "Release Date"
        .Columns(1).Name = "Track"
        .Columns(1).DefaultCellStyle.Alignment = DataGridViewContentAlignment.MiddleCenter
        .Columns(2).Name = "Title"
        .Columns(3).Name = "Artist"
        .Columns(4).Name = "Album"

        ' Make the font italic for row four.
        .Columns(4).DefaultCellStyle.Font = _
            New Font(Control.DefaultFont, _
                FontStyle.Italic)

        .SelectionMode = _
            DataGridViewSelectionMode.FullRowSelect
        .MultiSelect = False

        .BackgroundColor = Color.Honeydew

        .Dock = DockStyle.Fill
    End With

End Sub

Hinweise

Wenn die MultiSelect -Eigenschaft auf truefestgelegt ist, DataGridView können im-Steuerelement mehrere Elemente (Zellen, Zeilen oder Spalten) ausgewählt werden.When the MultiSelect property is set to true, multiple elements (cells, rows, or columns) can be selected in the DataGridView control. Wenn Sie mehrere Elemente auswählen möchten, können Sie die STRG-Taste gedrückt halten, während Sie auf die Elemente klicken, die ausgewählt werden sollen.To select multiple elements, the user can hold down the CTRL key while clicking the elements to select. Aufeinander folgende Elemente können ausgewählt werden, indem Sie auf das erste Element klicken, das ausgewählt werden soll. Wenn Sie die UMSCHALTTASTE gedrückt halten, klicken Sie auf das letzte auszuwählende Element.Consecutive elements can be selected by clicking the first element to select and then, while holding down the SHIFT key, clicking the last element to select. Der Auswahlbereich basiert auf der SelectionMode -Eigenschaft.The selection scope is based on the SelectionMode property. Wenn SelectionMode z. b. auf DataGridViewSelectionMode.FullColumnSelectfestgelegt ist, kann der Benutzer mehrere Spalten auswählen.For example, if SelectionMode is set to DataGridViewSelectionMode.FullColumnSelect, the user can select multiple columns.

Mit der MultiSelect -Eigenschaft können Sie es Benutzern ermöglichen, mehrere Elemente DataGridView im Steuerelement auszuwählen und einen Vorgang für alle ausgewählten Elemente auszuführen.You can use the MultiSelect property to allow a user to select multiple elements in the DataGridView control and perform an operation on all the selected elements. Beispielsweise kann der Benutzer mehrere Zellen auswählen und dann mit der rechten Maustaste auf eine ausgewählte Zelle klicken, um ein Kontextmenü anzuzeigen, in dem eine Reihe von Aufgaben angezeigt wird, die für die ausgewählten Zellen ausgeführt werden sollen.For example, the user could select multiple cells and then right-click a selected cell to display a shortcut menu that displays a set of tasks to perform on the selected cells.

Um zu ermitteln, welche Zellen, Zeilen oder Spalten DataGridView im-Steuerelement ausgewählt sind, können Sie auf die SelectedCells- SelectedColumns , SelectedRows-oder-Eigenschaft zugreifen.To determine which cells, rows, or columns are selected in the DataGridView control, you can access the SelectedCells, SelectedRows, or SelectedColumns property. Um die Anzahl der ausgewählten Zellen zu ermitteln, müssen GetCellCount Sie die-Methode mit einem DataGridViewElementStates.SelectedArgument Wert von abrufen.To determine the number of selected cells, call the GetCellCount method with an argument value of DataGridViewElementStates.Selected. Verwenden Sie GetRowCount die-Methode, um die Anzahl der ausgewählten Zeilen GetColumnCount abzurufen, und die-Methode, um die Anzahl der Spalten abzurufen.Use the GetRowCount method to retrieve the number of selected rows and the GetColumnCount method to retrieve the number of columns. Diese Methoden sind effizienter als der direkte Zugriff auf die Sammlungen, wenn Sie mit großen Datenmengen arbeiten.These methods are more efficient than accessing the collections directly when working with large amounts of data. Weitere Informationen finden Sie unter Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms.For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

Gilt für:

Siehe auch