Método NamedRange.PasteSpecial

Artigo
01/09/2014

Cola o conteúdo de um objeto de Microsoft.Office.Interop.Excel.Range da área de transferência no controle de NamedRange .

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

Sintaxe

'Declaração
Function PasteSpecial ( _
    Paste As XlPasteType, _
    Operation As XlPasteSpecialOperation, _
    SkipBlanks As Object, _
    Transpose As Object _
) As Object

Object PasteSpecial(
    XlPasteType Paste,
    XlPasteSpecialOperation Operation,
    Object SkipBlanks,
    Object Transpose
)

Parâmetros

Paste
Tipo: Microsoft.Office.Interop.Excel.XlPasteType
A parte de intervalo a ser colar.
Pode ser um dos seguintes valores de XlPasteType :
xlPasteAll
xlPasteAllExceptBorders
xlPasteColumnWidths
xlPasteComments
xlPasteFormats
xlPasteFormulas
xlPasteFormulasAndNumberFormats
xlPasteValidation
xlPasteValues
xlPasteValuesAndNumberFormats

Operation
Tipo: Microsoft.Office.Interop.Excel.XlPasteSpecialOperation
A operação da pasta.
Pode ser um dos seguintes valores de XlPasteSpecialOperation :
xlPasteSpecialOperationAdd
xlPasteSpecialOperationDivide
xlPasteSpecialOperationMultiply
xlPasteSpecialOperationNone
xlPasteSpecialOperationSubtract

SkipBlanks
Tipo: System.Object
true para não ter células em branco no intervalo na área de transferência colada no destino varia.O valor padrão é false.

Transpose
Tipo: System.Object
true para transpor linhas e colunas quando o intervalo é colado.O valor padrão é false.

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