DataGridView.GetClipboardContent DataGridView.GetClipboardContent DataGridView.GetClipboardContent DataGridView.GetClipboardContent Method

Definition

Ruft die formatierten Werte ab, die den Inhalt der ausgewählten Zellen für das Kopieren in das Clipboard darstellen.Retrieves the formatted values that represent the contents of the selected cells for copying to the Clipboard.

public:
 virtual System::Windows::Forms::DataObject ^ GetClipboardContent();
public virtual System.Windows.Forms.DataObject GetClipboardContent ();
abstract member GetClipboardContent : unit -> System.Windows.Forms.DataObject
override this.GetClipboardContent : unit -> System.Windows.Forms.DataObject
Public Overridable Function GetClipboardContent () As DataObject

Gibt zurück

Ein DataObject, das den Inhalt der ausgewählten Zellen darstellt.A DataObject that represents the contents of the selected cells.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ausgewählter DataGridView Inhalt Programm gesteuert der Zwischenablage hinzugefügt wird.The following code example demonstrates how to programmatically add selected DataGridView content to the Clipboard. Dieses Beispiel ist Teil eines größeren Beispiels, das unter Vorgehensweise: Ermöglicht es Benutzern, mehrere Zellen aus dem Windows Forms DataGridView-SteuerElement in die Zwischenablage zu kopieren.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

Diese Methode ruft Daten ab, die den durch die ausgewählten Zellen definierten Bereich darstellen.This method retrieves data that represents the region defined by the selected cells. Diese Region ist das kleinste Rechteck, das alle ausgewählten Zellen enthält.This region is the smallest rectangle that includes all of the selected cells. Der Wert für jede ausgewählte Zelle in diesem Bereich wird durch Aufrufen der DataGridViewCell.GetClipboardContent -Methode abgerufen.The value for each selected cell in this region is retrieved by calling the DataGridViewCell.GetClipboardContent method. Leere Platzhalter Werte werden für nicht ausgewählte Zellen in diesem Bereich verwendet.Blank placeholder values are used for unselected cells in this region. Diese Methode kombiniert diese Werte in einer DataObject , die mehrere Formate zum Kopieren in die Zwischenablage enthält.This method combines these values into a DataObject containing several formats for copying to the clipboard. Zu den unterstützten zwischen DataFormats.TextAblage DataFormats.UnicodeTextFormaten DataFormats.Htmlzählen, DataFormats.CommaSeparatedValue, und.The supported clipboard formats include DataFormats.Text, DataFormats.UnicodeText, DataFormats.Html, and DataFormats.CommaSeparatedValue.

Weitere Informationen finden Sie in den Ausführungen zur Clipboard-Klasse.For more information, see the Clipboard class.

Hinweise für Vererber

Überschreiben Sie diese Methode, um angepasste Zwischenablage Werte bereitzustellen.Override this method to provide customized clipboard values. Dies ist beispielsweise hilfreich, um das Kopieren von Werten aus benutzerdefinierten Zelltypen zu unterstützen.This is useful, for example, to support copying values from custom cell types.

Gilt für:

Siehe auch