NamedRange.ApplyNames Methode

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

abstract member ApplyNames : obj * obj * obj * obj * obj * Microsoft.Office.Interop.Excel.XlApplyNamesOrder * obj -> obj

Public Function ApplyNames (Optional Names As Object, Optional IgnoreRelativeAbsolute As Object, Optional UseRowColumnNames As Object, Optional OmitColumn As Object, Optional OmitRow As Object, Optional Order As XlApplyNamesOrder = Microsoft.Office.Interop.Excel.XlApplyNamesOrder.xlRowThenColumn, Optional AppendLast As Object) As Object

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, wenn namen für den Bereich nicht gefunden werden können; false , um die OmitColumn Argumente 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 aufgeführt wird, wenn ein Zellverweis durch einen zeilen- und spaltenorientierten Bereichsnamen ersetzt wird. Kann eine der folgenden XlApplyNamesOrder Konstanten sein: xlColumnThenRow xlRowThenColumn

AppendLast: Object

true , um die Definitionen der Namen in Names und auch die Definitionen der definierten Nachnamen zu ersetzen, false um die Definitionen der Namen nur in Names zu ersetzen. Standardwert: false.

Gibt zurück

Object

Beispiele

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

Dieses Beispiel gilt für eine Anpassung auf Dokumentebene.

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

Sie können die Array -Funktion verwenden, um die Liste der Namen für das Names Argument zu erstellen.

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

Sie können keine "unapply"-Namen verwenden. Verwenden Sie zum Löschen von Namen die Delete -Methode.

Optionale Parameter

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

Gilt für:

Freigeben über