NamedRange.PasteSpecial Methode

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

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

Parameter

Paste: XlPasteType

Der Teil des bereichs, der eingefügt werden soll. Dies kann einer der folgenden XlPasteType Werte sein: xlPasteAll xlPasteAllExceptBorders xlPasteColumnWidths xlPasteComments xlPasteFormats xlPasteFormulas xlPasteFormulasAndNumberFormats xlPasteValidation xlPasteValues xlPasteValuesAndNumberFormats

Operation: XlPasteSpecialOperation

Der Einfügevorgang. Dies kann einer der folgenden XlPasteSpecialOperation Werte sein: xlPasteSpecialOperationAdd xlPasteSpecialOperationDivide xlPasteSpecialOperationMultiply xlPasteSpecialOperationNone xlPasteSpecialOperationSubtract

SkipBlanks: Object

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

Transpose: Object

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

Gibt zurück

Object

Beispiele

Im folgenden Codebeispiel wird die Copy -Methode verwendet, um den Inhalt eines NamedRange Steuerelements mit dem Namen NamedRange1 in die Zwischenablage zu kopieren. Anschließend wird die PasteSpecial -Methode verwendet, um diese Inhalte in ein NamedRange Steuerelement namens NamedRange2einzufügen. Der Operation Parameter wird auf xlPasteSpecialOperationAdd festgelegt, sodass der Inhalt jeder Zelle in NamedRange1 der entsprechenden Zelle in NamedRange2hinzugefügt wird.

Dieses Beispiel gilt für eine Anpassung auf Dokumentebene.

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

Hinweise

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Projektmappen.

Gilt für:

Freigeben über