NamedRange.PasteSpecial Метод

Определение

Пространство имен:

Microsoft.Office.Tools.Excel

Сборка:

Microsoft.Office.Tools.Excel.dll

Вставляет содержимое объекта 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.

Возвращаемое значение

Object

Примеры

В следующем примере кода используется 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.