NamedRange.Insert-Methode

Artikel
08/10/2011

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.

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

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", missing].Value2 = "Robin";
    this.Range["A2", missing].Value2 = "Sparrow";
    this.Range["A3", missing].Value2 = "Crow";

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

    namedRange1.Insert(Excel.XlInsertShiftDirection.xlShiftDown, missing);
    namedRange1.Value2 = "Raven";
}

.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

Share via