Share via

NamedRange.ApplyNames 方法

  • 發行項

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

命名空間：  Microsoft.Office.Tools.Excel
組件：  Microsoft.Office.Tools.Excel (在 Microsoft.Office.Tools.Excel.dll 中)

語法

'宣告
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
)

參數

  • Names
    型別：System.Object
    要套用的名稱陣列。如果省略這個引數，則工作表上所有的名稱會套用至範圍。
  • IgnoreRelativeAbsolute
    型別：System.Object
    true 表示以名稱取代參照，不管名稱或參照的參照類型為何，false 表示只使用絕對名稱取代絕對參照，相對名稱取代相對參照，混合名稱取代混合參照。預設值是 true。
  • UseRowColumnNames
    型別：System.Object
    true 表示如果找不到範圍的名稱則使用包含指定範圍的列和欄範圍名稱，false 表示忽略 OmitColumn 和 OmitRow 引數。預設值是 true。
  • OmitColumn
    型別：System.Object
    true 表示以列導向的名稱取代整個參照。只有在參照的儲存格位於和公式相同的欄，並且在列導向的具名範圍內時，才能省略欄導向名稱。預設值是 true。
  • OmitRow
    型別：System.Object
    true 表示以欄導向的名稱取代整個參照。只有在參照的儲存格位於和公式相同的列，並且在欄導向的具名範圍內時，才能省略列導向名稱。預設值是 true。
  • AppendLast
    型別：System.Object
    true 表示取代 Names 中之名稱的定義，並且也取代最後定義的名稱，false 表示只取代 Names 中的名稱定義。預設值是 false。

傳回值

型別：System.Object

備註

您可以使用 Array 函數，為 Names 引數建立名稱清單。

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

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

選擇性參數

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

範例

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

這是示範文件層級自訂的範例。

    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 安全性

請參閱

參考

NamedRange 介面

Microsoft.Office.Tools.Excel 命名空間