Freigeben über


NamedRange.ApplyNames-Methode

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

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

Syntax

'Declaration
Function ApplyNames ( _
    Names As Object, _
    IgnoreRelativeAbsolute As Object, _
    UseRowColumnNames As Object, _
    OmitColumn As Object, _
    OmitRow As Object, _
    Order As XlApplyNamesOrder, _
    AppendLast As Object _
) As Object
Object ApplyNames(
    Object Names,
    Object IgnoreRelativeAbsolute,
    Object UseRowColumnNames,
    Object OmitColumn,
    Object OmitRow,
    XlApplyNamesOrder Order,
    Object AppendLast
)

Parameter

  • Names
    Typ: System.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
    Typ: System.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
    Typ: System.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 das OmitColumn-Argument und das OmitRow-Argument zu ignorieren.Der Standardwert ist true.
  • OmitColumn
    Typ: System.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
    Typ: System.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.
  • AppendLast
    Typ: System.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.

Rückgabewert

Typ: System.Object

Hinweise

Mithilfe der Array-Funktion können Sie die Namensliste für das Names-Argument erstellen.

Um Namen für das gesamte Blatt zu übernehmen, verwenden Sie Cells.ApplyNames.

Sie können die Übernahme von Namen nicht rückgängig machen. Verwenden Sie die Delete-Methode, um Namen zu löschen.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Beispiel wird mithilfe der ApplyNames-Methode eine Menge von Namen für ein NamedRange-Steuerelement übernommen.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

    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

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

.NET Framework-Sicherheit

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace