NamedRange.ApplyNames-Methode

Artikel
08/10/2011

Ü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.

Order
Typ: Microsoft.Office.Interop.Excel.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:
xlColumnThenRow
xlRowThenColumn

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

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