NamedRange.ApplyNames(Object, Object, Object, Object, Object, XlApplyNamesOrder, Object) Methode

Definition

Übernimmt Namen für die Zellen im NamedRange-Steuerelement.

public object ApplyNames (object Names, object IgnoreRelativeAbsolute, object UseRowColumnNames, object OmitColumn, object OmitRow, Microsoft.Office.Interop.Excel.XlApplyNamesOrder Order = Microsoft.Office.Interop.Excel.XlApplyNamesOrder.xlRowThenColumn, object AppendLast);

Parameter

Names
Object

Ein Array mit Namen, die übernommen werden sollen. Wenn dieses Argument weggelassen wird, werden alle Namen auf dem Blatt für den Bereich übernommen.

IgnoreRelativeAbsolute
Object

true, um Bezüge durch Namen zu ersetzen, unabhängig davon, ob der Bezugstyp ein Name oder ein Bezug ist, oder false, um absolute Bezüge nur durch absolute Namen, relative Bezüge nur durch relative Namen und gemischte Bezüge nur durch gemischte Namen zu ersetzen. Der Standardwert ist true.

UseRowColumnNames
Object

true, um die Namen von Zeilen- und Spaltenbereichen zu verwenden, die den angegebenen Bereich enthalten, falls die Namen für den Bereich nicht gefunden werden können, oder false, um die Argumente und OmitColumn und OmitRow zu ignorieren. Der Standardwert ist true.

OmitColumn
Object

true, um den gesamten Bezug durch den zeilenorientierten Namen zu ersetzen. Der spaltenorientierte Name kann nur dann weggelassen werden, wenn sich die Zelle, auf die der Bezug verweist, innerhalb derselben Spalte wie die Formel und innerhalb eines zeilenorientierten benannten Bereichs befindet. Der Standardwert ist true.

OmitRow
Object

true, um den gesamten Bezug durch den spaltenorientierten Namen zu ersetzen. Der zeilenorientierte Name kann nur dann weggelassen werden, wenn sich die Zelle, auf die der Bezug verweist, innerhalb derselben Zeile wie die Formel und innerhalb eines spaltenorientierten benannten Bereichs befindet. Der Standardwert ist true.

Order
XlApplyNamesOrder

Bestimmt, welcher Bereichsname zuerst aufgelistet wird, wenn ein Zellbezug durch einen zeilenorientierten und einen spaltenorientierten Bereichsnamen ersetzt wird.

Kann eine der folgenden XlApplyNamesOrder-Konstanten sein: xlColumnThenRowxlRowThenColumn

AppendLast
Object

true, um die Namensdefinitionen in Names sowie die Definitionen der zuletzt festgelegten Namen zu ersetzen, oder false, um nur die Namensdefinitionen in Names zu ersetzen. Der Standardwert ist false.

Gibt zurück

Object

Beispiele

Im folgenden Codebeispiel wird die- ApplyNames Methode verwendet, um einen Satz von Namen auf ein-Steuerelement anzuwenden NamedRange .

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

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

    string[] s = new string[] { "One", "Two", "Three", "Four", "Five" };
    namedRange1.ApplyNames(s, true, true, true, true,
        Excel.XlApplyNamesOrder.xlColumnThenRow, false);
}
Private Sub AddNames()
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
        "namedRange1")

    Dim s() As String = {"One", "Two", "Three", "Four", "Five"}
    namedRange1.ApplyNames(s, True, True, True, True, _
        Excel.XlApplyNamesOrder.xlColumnThenRow, False)
End Sub

Hinweise

Mit der-Funktion können Sie Array die Liste der Namen für das Names Argument erstellen.

Wenn Sie Namen auf das gesamte Blatt anwenden möchten, verwenden Sie Cells.ApplyNames .

Sie können die Namen nicht "nicht anwenden". um Namen zu löschen, verwenden Sie die- Delete Methode.

Optionale Parameter

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

Gilt für