NamedRange.ApplyNames 方法

定義

命名空間:

Microsoft.Office.Tools.Excel

組件:

Microsoft.Office.Tools.Excel.dll

將名稱套用至 NamedRange 控制項中的儲存格。

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

參數

Names

Object

要套用的名稱陣列。 如果省略這個引數，則工作表上所有的名稱會套用至範圍。

IgnoreRelativeAbsolute

Object

true 表示以名稱取代參照，不管名稱或參照的參照類型為何，false 表示只使用絕對名稱取代絕對參照，相對名稱取代相對參照，混合名稱取代混合參照。 預設值是 true。

UseRowColumnNames

Object

true 表示如果找不到範圍的名稱，則使用包含指定範圍的數據列和數據行範圍名稱; false 表示忽略 OmitColumn 和 OmitRow 自變數。 預設值是 true。

OmitColumn

Object

true 表示以列導向的名稱取代整個參照。 只有在參照的儲存格位於和公式相同的欄，並且在列導向的具名範圍內時，才能省略欄導向名稱。 預設值是 true。

OmitRow

Object

true 表示以欄導向的名稱取代整個參照。 只有在參照的儲存格位於和公式相同的列，並且在欄導向的具名範圍內時，才能省略列導向名稱。 預設值是 true。

Order

XlApplyNamesOrder

決定當儲存格參考由數據列導向和數據行導向範圍名稱取代時，會先列出哪一個範圍名稱。可以是下列 XlApplyNamesOrder 其中一個常數： xlColumnThenRowxlRowThenColumn

AppendLast

Object

true 取代 中 Names 名稱的定義，並取代已定義的姓氏定義; false 只取代 中 Names 名稱的定義。 預設值是 false。

傳回

Object

範例

下列程式代碼範例會使用 方法， ApplyNames 將一組名稱套用至 NamedRange 控件。

此範例適用於檔層級自定義。

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

備註

您可以使用 函 Array 式來建立自變數的名稱 Names 清單。

如果您要將名稱套用至整個工作表， 請使用 Cells.ApplyNames。

您無法「取消套用」名稱;若要刪除名稱，請使用 Delete 方法。

選擇性參數

如需選擇性參數的資訊，請參閱 Office 方案中的選擇性參數。