NamedRange.PasteSpecial, méthode
Colle le contenu d'un objet Microsoft.Office.Interop.Excel.Range du Presse-papiers vers le contrôle NamedRange.
Espace de noms : Microsoft.Office.Tools.Excel
Assembly : Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)
Syntaxe
'Déclaration
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
)
Paramètres
- Paste
Type : Microsoft.Office.Interop.Excel.XlPasteType
Partie de la plage à coller.
Il peut s'agir de l'une des valeurs XlPasteType suivantes :
xlPasteAll
xlPasteAllExceptBorders
xlPasteColumnWidths
xlPasteComments
xlPasteFormats
xlPasteFormulas
xlPasteFormulasAndNumberFormats
xlPasteValidation
xlPasteValues
xlPasteValuesAndNumberFormats
- Operation
Type : Microsoft.Office.Interop.Excel.XlPasteSpecialOperation
Opération de collage.
Il peut s'agir de l'une des valeurs XlPasteSpecialOperation suivantes :
xlPasteSpecialOperationAdd
xlPasteSpecialOperationDivide
xlPasteSpecialOperationMultiply
xlPasteSpecialOperationNone
xlPasteSpecialOperationSubtract
- SkipBlanks
Type : System.Object
true pour éviter que des cellules vides de la plage du Presse-papiers soient collées dans la plage de destination.La valeur par défaut est false.
- Transpose
Type : System.Object
true pour transposer des lignes et des colonnes lorsque la plage est collée.La valeur par défaut est false.
Valeur de retour
Type : System.Object
Notes
Paramètres optionnels
Pour plus d'informations sur les paramètres optionnels, consultez Paramètres optionnels dans les solutions Office.
Exemples
L'exemple de code suivant utilise la méthode Copy pour copier le contenu d'un contrôle NamedRange appelé NamedRange1 vers le Presse-papiers, puis utilise la méthode PasteSpecial pour coller ce contenu dans un contrôle NamedRange appelé NamedRange2.La valeur xlPasteSpecialOperationAdd est affectée au paramètre Operation pour que le contenu de chaque cellule de NamedRange1 soit ajouté à la cellule correspondante dans NamedRange2.
Cet exemple illustre une personnalisation au niveau du document.
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);
}
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.