Método NamedRange.PasteSpecial
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 do intervalo para ser colado.
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
paratrue 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 a seguir 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 da 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áveis.