Método NamedRange.Copy

Artigo
08/01/2011

Copia o conteúdo do NamedRange o controle para o intervalo especificado ou para a área de transferência.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Function Copy ( _
    Destination As Object _
) As Object

Object Copy(
    Object Destination
)

Parâmetros

Destination
Tipo: System.Object
Especifica o novo intervalo ao qual o conteúdo a NamedRange controle será copiado.Se esse argumento for omitido, o Excel de Microsoft Office copiará o intervalo para a área de transferência.

Valor de retorno

Tipo: System.Object

Comentários

Optional Parameters

Para obter informações sobre os parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O seguinte exemplo de código usa a Copy método para copiar o conteúdo de um NamedRange controle chamado NamedRange1 para a área de transferência e usa o PasteSpecial método para colar esse conteúdo em um NamedRange controle chamado NamedRange2. O Operation parâmetro for definido como xlPasteSpecialOperationAdd para que o conteúdo de cada célula na NamedRange1 é adicionado às células correspondentes em NamedRange2.

Este exemplo é para uma personalização em nível de documento.

    Private Sub CopyAndPasteSpecialRange()
        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1", "A3"), _
            "namedRange1")
        namedRange1.Value2 = 22

        Dim namedRange2 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("C1", "C3"), _
            "namedRange2")
        namedRange2.Value2 = 5

        ' Copy the contents of namedRange1 to the clipboard, and then
        ' paste the contents into namedRange2, adding each value to
        ' the value in namedRange2.
        namedRange1.Copy()
        namedRange2.PasteSpecial(Excel.XlPasteType.xlPasteAll, _
        Excel.XlPasteSpecialOperation.xlPasteSpecialOperationAdd, _
        False, False)
    End Sub

private void CopyAndPasteSpecialRange()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A3"],
        "namedRange1");
    namedRange1.Value2 = 22;

    Microsoft.Office.Tools.Excel.NamedRange namedRange2 =
        this.Controls.AddNamedRange(this.Range["C1", "C3"],
        "namedRange2");
    namedRange2.Value2 = 5;

    // Copy the contents of namedRange1 to the clipboard, and then
    // paste the contents into namedRange2, adding each to
    // the value in namedRange2.
    namedRange1.Copy(missing);
    namedRange2.PasteSpecial(Excel.XlPasteType.xlPasteAll,
        Excel.XlPasteSpecialOperation.xlPasteSpecialOperationAdd,
        false,
        false);
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via