Método NamedRange.Copy

Artigo
01/09/2014

Copia o conteúdo do controle de NamedRange ao 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 para que o conteúdo do controle de NamedRange serão copiados.Se esse argumento é omitido, Microsoft Office Excel copia o intervalo para a área de transferência.

Valor de retorno

Tipo: System.Object

Comentários

Parâmetros Opcionais

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

Exemplos

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

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

    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();
    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ável.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via