NamedRange.Insert(Object, Object) Methode

Definition

Fügt eine Zelle oder einen Zellbereich in das NamedRange-Steuerelement ein und verschiebt andere Zellen, um den benötigten Platz zu schaffen.

public object Insert (object Shift, object CopyOrigin);

Parameter

Shift
Object

Gibt an, auf welche Weise die Zellen verschoben werden. Kann einer der folgenden XlInsertShiftDirection-Werte sein: xlShiftToRight oder xlShiftDown. Wenn dieses Argument weggelassen wird, wählt Microsoft Office Excel auf Grundlage der Form des Bereichs automatisch einen Wert aus.

CopyOrigin
Object

Einer der XlInsertFormatOrigin-Werte, der angibt, von wo das auf die neuen Zellen anzuwendende Format abgerufen werden soll.

Gibt zurück

Object

Beispiele

Im folgenden Codebeispiel werden Werte in den Zellen a1 bis a3 festgelegt, und anschließend wird die-Methode verwendet, Insert um eine leere Zelle in ein Steuerelement mit dem Namen einzufügen, NamedRange NamedRange1 das auf Zelle a1 festgelegt ist. Mit diesem Vorgang werden die Zellen im Bereich nach unten verlagert, was bedeutet, dass NamedRange1 jetzt auf Zelle a2 festgelegt ist. Um dies zu veranschaulichen, wird im Beispiel der Wert von auf festgelegt NamedRange1 Raven , der in Zelle a2 angezeigt wird.

Dieses Beispiel gilt für eine Anpassung auf Dokument Ebene.

private void InsertIntoRange()
{
    this.Range["A1"].Value2 = "Robin";
    this.Range["A2"].Value2 = "Sparrow";
    this.Range["A3"].Value2 = "Crow";

    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1"],
        "namedRange1");

    namedRange1.Insert(Excel.XlInsertShiftDirection.xlShiftDown);
    namedRange1.Value2 = "Raven";
}
Private Sub InsertIntoRange()
    Me.Range("A1").Value2 = "Robin"
    Me.Range("A2").Value2 = "Sparrow"
    Me.Range("A3").Value2 = "Crow"

    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1"), _
        "namedRange1")

    namedRange1.Insert(Excel.XlInsertShiftDirection.xlShiftDown, )
    namedRange1.Value2 = "Raven"
End Sub

Hinweise

Optionale Parameter

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

Gilt für