Propriedade DataGridView.ClipboardCopyMode

O DataGridView controle copia a representação de texto de cada célula selecionada na área de transferência. Esse valor é o valor da célula convertido para uma seqüência de caracteres ou, para as células de imagem, o valor da Description propriedade.

Valores são copiados para a área de transferência do Text, UnicodeText, Html, e CommaSeparatedValue formatos. Esses formatos são úteis para colar o conteúdo em aplicativos como o bloco de notas, Microsoft Excel, e Microsoft Word.

O DataGridView controle copia células contidas no menor retângulo que inclui todas as selecionadas de células. Linhas e colunas que não contêm as células selecionadas não são representadas nos dados copiados. As células não selecionadas nas linhas e colunas restantes são representadas por espaços reservados em branco. Dependendo do modo de cópia e o modo de seleção, os valores de cabeçalho para as colunas e linhas copiadas podem ser copiados, também.

Quando os usuários copiem o conteúdo, o DataGridView controle adiciona um DataObject na área de transferência. Esse objeto de dados é recuperado das GetClipboardContent método. Você pode chamar esse método quando você deseja adicionar programaticamente o objeto de dados na área de transferência.

O GetClipboardContent método recupera valores para células individuais chamando o DataGridViewCell.GetClipboardContent método. Você pode substituir um ou ambos os métodos em classes derivadas para personalizar o layout das células copiadas ou para oferecer suporte a formatos de dados adicionais.

Para obter mais informações sobre as operações da área de transferência e formatos de dados, consulte a Clipboard classe.

O exemplo de código a seguir demonstra como habilitar copiando o DataGridView controle. Este exemplo é parte de um exemplo maior disponível em Como: permitir que os usuários copiar várias células para a área de transferência do controle Windows Forms DataGridView.

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.";
        }
    }
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

Referência

Outros recursos