NamedRange.ApplyNames(Object, Object, Object, Object, Object, XlApplyNamesOrder, Object) Methode
Definition
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);
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
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.