Freigeben über


NamedRange.Insert-Methode

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

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

Syntax

'Declaration
Function Insert ( _
    Shift As Object, _
    CopyOrigin As Object _
) As Object
Object Insert(
    Object Shift,
    Object CopyOrigin
)

Parameter

  • Shift
    Typ: System.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.

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 werden die Werte der Zellen A1 bis A3 festgelegt. Anschließend wird mithilfe der Insert-Methode eine leere Zelle in ein NamedRange-Steuerelement mit dem Namen NamedRange1 eingefügt, das auf Zelle A1 festgelegt wurde.Bei dieser Operation werden die Zellen im Bereich nach unten verschoben, sodass NamedRange1 anschließend auf die Zelle A2 festgelegt ist.Zur Veranschaulichung wird im Beispiel der Wert von NamedRange1 auf Raven festgelegt, was in der Zelle A2 angezeigt wird.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

    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

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

.NET Framework-Sicherheit

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace