NamedRange.PasteSpecial Метод (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Вставляет содержимое объекта Microsoft.Office.Interop.Excel.Range из буфера обмена в элемент управления NamedRange.

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.dll)

Синтаксис

'Декларация
Public Function PasteSpecial ( _
    Paste As XlPasteType, _
    Operation As XlPasteSpecialOperation, _
    SkipBlanks As Object, _
    Transpose As Object _
) As Object
'Применение
Dim instance As NamedRange
Dim Paste As XlPasteType
Dim Operation As XlPasteSpecialOperation
Dim SkipBlanks As Object
Dim Transpose As Object
Dim returnValue As Object

returnValue = instance.PasteSpecial(Paste, _
    Operation, SkipBlanks, Transpose)

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

Параметры

Paste
Тип: Microsoft.Office.Interop.Excel.XlPasteType
Часть диапазона, подлежащего синтаксическому анализу.
Может иметь одно из следующих значений XlPasteType:

Operation
Тип: Microsoft.Office.Interop.Excel.XlPasteSpecialOperation
Операция вставки
Может иметь одно из следующих значений XlPasteSpecialOperation:

SkipBlanks
Тип: System.Object
Значение true, чтобы в диапазоне в буфере обмена, вставляемого в диапазон назначения, не было пустых ячеек. Значение по умолчанию — false.

Transpose
Тип: System.Object
Значение true, чтобы поменять местами строки и столбцы при вставке диапазона. Значение по умолчанию — false.

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

Тип: System.Object

Заметки

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Общие сведения о необязательных параметрах в решениях Office.

Примеры

В следующем примере кода метод Copy используется для копирования содержимого элемента управления NamedRange с именем NamedRange1 в буфер обмена, а затем с помощью метода PasteSpecial выполняется вставка этого содержимого в элемент управления NamedRange с именем NamedRange2. Параметру Operation присваивается значение xlPasteSpecialOperationAdd, таким образом содержимое каждой ячейки в NamedRange1 добавляется в соответствующую ячейку в NamedRange2.

В этом примере демонстрируется настройка уровня документа.

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(missing);
    namedRange2.PasteSpecial(Excel.XlPasteType.xlPasteAll,
        Excel.XlPasteSpecialOperation.xlPasteSpecialOperationAdd,
        false,
        false);
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.