NamedRange.PasteSpecial-Methode

Artikel
08/10/2011

Fügt den Inhalt eines Microsoft.Office.Interop.Excel.Range-Objekts aus der Zwischenablage in das NamedRange-Steuerelement ein.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
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
)

Parameter

Paste
Typ: Microsoft.Office.Interop.Excel.XlPasteType
Der einzufügende Teilbereich.
Kann einer der folgenden XlPasteType-Werte sein:
xlPasteAll
xlPasteAllExceptBorders
xlPasteColumnWidths
xlPasteComments
xlPasteFormats
xlPasteFormulas
xlPasteFormulasAndNumberFormats
xlPasteValidation
xlPasteValues
xlPasteValuesAndNumberFormats

Operation
Typ: Microsoft.Office.Interop.Excel.XlPasteSpecialOperation
Der Einfügevorgang.
Kann einer der folgenden XlPasteSpecialOperation-Werte sein:
xlPasteSpecialOperationAdd
xlPasteSpecialOperationDivide
xlPasteSpecialOperationMultiply
xlPasteSpecialOperationNone
xlPasteSpecialOperationSubtract

SkipBlanks
Typ: System.Object
true, wenn keine leeren Zellen im Bereich der Zwischenablage in den Zielbereich eingefügt werden sollen.Der Standardwert ist false.

Transpose
Typ: System.Object
true, um Zeilen und Spalten zu vertauschen, wenn der Bereich eingefügt wird.Der Standardwert ist false.

Rückgabewert

Typ: System.Object

Hinweise

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird mithilfe der Copy-Methode der Inhalt eines NamedRange-Steuerelements mit dem Namen NamedRange1 in die Zwischenablage kopiert. Anschließend wird dieser Inhalt mithilfe der PasteSpecial-Methode in ein NamedRange-Steuerelement mit dem Namen NamedRange2 eingefügt. Der Operation-Parameter ist auf xlPasteSpecialOperationAdd festgelegt, sodass der Inhalt jeder Zelle in NamedRange1 in die entsprechende Zelle in NamedRange2 eingefügt wird.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

    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);
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Freigeben über