共用方式為


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 命名空間