DataGridView.ClipboardCopyMode Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob Zelltextwerte in das Clipboard kopiert werden können und ob Zeilen- und Spaltenheader eingeschlossen werden.Gets or sets a value that indicates whether users can copy cell text values to the Clipboard and whether row and column header text is included.

public:
 property System::Windows::Forms::DataGridViewClipboardCopyMode ClipboardCopyMode { System::Windows::Forms::DataGridViewClipboardCopyMode get(); void set(System::Windows::Forms::DataGridViewClipboardCopyMode value); };
[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.DataGridViewClipboardCopyMode ClipboardCopyMode { get; set; }
member this.ClipboardCopyMode : System.Windows.Forms.DataGridViewClipboardCopyMode with get, set
Public Property ClipboardCopyMode As DataGridViewClipboardCopyMode

Eigenschaftswert

Attribute

Ausnahmen

Der beim Festlegen dieser Eigenschaft angegebene Wert ist kein gültiger DataGridViewClipboardCopyMode-Wert.The specified value when setting this property is not a valid DataGridViewClipboardCopyMode value.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das Kopieren im DataGridView Steuerelement aktiviert wird.The following code example demonstrates how to enable copying in the DataGridView control. Dieses Beispiel ist Teil eines größeren Beispiels in Gewusst wie: Aktivieren von Benutzern zum Kopieren mehrerer Zellen aus dem Windows Forms DataGridView-Steuerelement in die Zwischenablage.This example is part of a larger example available in How to: Enable Users to Copy Multiple Cells to the Clipboard from the Windows Forms DataGridView Control.

private void Form1_Load(object sender, System.EventArgs e)
{
    // Initialize the DataGridView control.
    this.DataGridView1.ColumnCount = 5;
    this.DataGridView1.Rows.Add(new string[] { "A", "B", "C", "D", "E" });
    this.DataGridView1.Rows.Add(new string[] { "F", "G", "H", "I", "J" });
    this.DataGridView1.Rows.Add(new string[] { "K", "L", "M", "N", "O" });
    this.DataGridView1.Rows.Add(new string[] { "P", "Q", "R", "S", "T" });
    this.DataGridView1.Rows.Add(new string[] { "U", "V", "W", "X", "Y" });
    this.DataGridView1.AutoResizeColumns();
    this.DataGridView1.ClipboardCopyMode = 
        DataGridViewClipboardCopyMode.EnableWithoutHeaderText;
}

private void CopyPasteButton_Click(object sender, System.EventArgs e)
{
    if (this.DataGridView1
        .GetCellCount(DataGridViewElementStates.Selected) > 0)
    {
        try
        {
            // Add the selection to the clipboard.
            Clipboard.SetDataObject(
                this.DataGridView1.GetClipboardContent());
            
            // Replace the text box contents with the clipboard text.
            this.TextBox1.Text = Clipboard.GetText();
        }
        catch (System.Runtime.InteropServices.ExternalException)
        {
            this.TextBox1.Text = 
                "The Clipboard could not be accessed. Please try again.";
        }
    }
}
Private Sub Form1_Load(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Me.Load

    ' Initialize the DataGridView control.
    Me.DataGridView1.ColumnCount = 5
    Me.DataGridView1.Rows.Add(New String() {"A", "B", "C", "D", "E"})
    Me.DataGridView1.Rows.Add(New String() {"F", "G", "H", "I", "J"})
    Me.DataGridView1.Rows.Add(New String() {"K", "L", "M", "N", "O"})
    Me.DataGridView1.Rows.Add(New String() {"P", "Q", "R", "S", "T"})
    Me.DataGridView1.Rows.Add(New String() {"U", "V", "W", "X", "Y"})
    Me.DataGridView1.AutoResizeColumns()
    Me.DataGridView1.ClipboardCopyMode = _
        DataGridViewClipboardCopyMode.EnableWithoutHeaderText

End Sub

Private Sub CopyPasteButton_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles CopyPasteButton.Click

    If Me.DataGridView1.GetCellCount( _
        DataGridViewElementStates.Selected) > 0 Then

        Try

            ' Add the selection to the clipboard.
            Clipboard.SetDataObject( _
                Me.DataGridView1.GetClipboardContent())

            ' Replace the text box contents with the clipboard text.
            Me.TextBox1.Text = Clipboard.GetText()

        Catch ex As System.Runtime.InteropServices.ExternalException
            Me.TextBox1.Text = _
                "The Clipboard could not be accessed. Please try again."
        End Try

    End If

End Sub

Hinweise

Das DataGridView-Steuerelement kopiert die Textdarstellung der einzelnen ausgewählten Zellen in die Zwischenablage.The DataGridView control copies the text representation of each selected cell to the Clipboard. Dieser Wert ist der Zellwert, der in eine Zeichenfolge konvertiert wird, oder für Bild Zellen der Wert der Description-Eigenschaft.This value is the cell value converted to a string or, for image cells, the value of the Description property.

Werte werden in Text-, UnicodeText-, Html-und CommaSeparatedValue-Format in die Zwischenablage kopiert.Values are copied to the Clipboard in Text, UnicodeText, Html, and CommaSeparatedValue formats. Diese Formate sind nützlich für das Einfügen von Inhalten in Anwendungen wie z. b. Notepad, Microsoft Excel und Microsoft WordMicrosoft Word.These formats are useful for pasting content into applications such as Notepad, Microsoft Excel, and Microsoft WordMicrosoft Word.

Das DataGridView Steuerelement kopiert die Zellen, die im kleinsten Rechteck enthalten sind, das alle ausgewählten Zellen enthält.The DataGridView control copies the cells contained in the smallest rectangle that includes all selected cells. Zeilen und Spalten, die keine ausgewählten Zellen enthalten, werden nicht in den kopierten Daten dargestellt.Rows and columns that do not contain any selected cells are not represented in the copied data. Alle nicht ausgewählten Zellen in den verbleibenden Zeilen und Spalten werden durch leere Platzhalter dargestellt.Any unselected cells in the remaining rows and columns are represented by blank placeholders. Abhängig vom Kopiermodus und dem Auswahlmodus können auch Header Werte für die kopierten Zeilen und Spalten kopiert werden.Depending on the copy mode and the selection mode, header values for the copied rows and columns may be copied, as well.

Wenn Benutzerinhalte kopieren, fügt das DataGridView Steuerelement der Zwischenablage einen DataObject hinzu.When users copy content, the DataGridView control adds a DataObject to the Clipboard. Dieses Datenobjekt wird aus der GetClipboardContent-Methode abgerufen.This data object is retrieved from the GetClipboardContent method. Diese Methode kann aufgerufen werden, wenn Sie das Datenobjekt Programm gesteuert der Zwischenablage hinzufügen möchten.You can call this method when you want to programmatically add the data object to the Clipboard.

Die GetClipboardContent-Methode ruft Werte für einzelne Zellen ab, indem Sie die DataGridViewCell.GetClipboardContent-Methode aufrufen.The GetClipboardContent method retrieves values for individual cells by calling the DataGridViewCell.GetClipboardContent method. Sie können eine oder beide Methoden in abgeleiteten Klassen überschreiben, um das Layout der kopierten Zellen anzupassen oder zusätzliche Datenformate zu unterstützen.You can override either or both of these methods in derived classes to customize the layout of copied cells or to support additional data formats.

Weitere Informationen zu Zwischenablage Vorgängen und Datenformaten finden Sie in der Clipboard-Klasse.For more information about Clipboard operations and data formats, see the Clipboard class.

Gilt für:

Siehe auch