NamedRange.PasteSpecial Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вставляет содержимое объекта Range из буфера обмена в элемент управления NamedRange.
public object PasteSpecial (Microsoft.Office.Interop.Excel.XlPasteType Paste = Microsoft.Office.Interop.Excel.XlPasteType.xlPasteAll, Microsoft.Office.Interop.Excel.XlPasteSpecialOperation Operation = Microsoft.Office.Interop.Excel.XlPasteSpecialOperation.xlPasteSpecialOperationNone, object SkipBlanks, object Transpose);
abstract member PasteSpecial : Microsoft.Office.Interop.Excel.XlPasteType * Microsoft.Office.Interop.Excel.XlPasteSpecialOperation * obj * obj -> obj
Public Function PasteSpecial (Optional Paste As XlPasteType = Microsoft.Office.Interop.Excel.XlPasteType.xlPasteAll, Optional Operation As XlPasteSpecialOperation = Microsoft.Office.Interop.Excel.XlPasteSpecialOperation.xlPasteSpecialOperationNone, Optional SkipBlanks As Object, Optional Transpose As Object) As Object
Параметры
- Paste
- XlPasteType
Часть диапазона для вставки. Может иметь одно из следующих XlPasteType значений: xlPasteAllxlPasteAllExceptBordersxlPasteColumnWidthsxlPasteCommentsxlPasteFormatsxlPasteFormulasxlPasteFormulasAndNumberFormatsxlPasteValidationxlPasteValuesxlPasteValuesAndNumberFormats
- Operation
- XlPasteSpecialOperation
Операция вставки. Может иметь одно из следующих XlPasteSpecialOperation значений: xlPasteSpecialOperationAddxlPasteSpecialOperationDividexlPasteSpecialOperationMultiplyxlPasteSpecialOperationNonexlPasteSpecialOperationSubtract
- SkipBlanks
- Object
Значение true
, чтобы в диапазоне в буфере обмена, вставляемого в диапазон назначения, не было пустых ячеек. Значение по умолчанию — false
.
- Transpose
- Object
Значение true
, чтобы поменять местами строки и столбцы при вставке диапазона. Значение по умолчанию — false
.
Возвращаемое значение
Примеры
В следующем примере кода используется Copy метод для копирования содержимого NamedRange элемента управления с именем NamedRange1
в буфер обмена, а затем используется PasteSpecial метод для вставки этого содержимого в NamedRange элемент управления с именем NamedRange2
. Параметр Operation
имеет значение , xlPasteSpecialOperationAdd чтобы содержимое каждой ячейки в добавлялось в NamedRange1
соответствующую ячейку в NamedRange2
.
Этот пример предназначен для настройки на уровне документа.
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);
}
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
Комментарии
Необязательные параметры
Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.