ControlCollection.AddNamedRange 方法

將新的 NamedRange 控制項加入至工作表中指定的範圍。

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

語法

'宣告
Function AddNamedRange ( _
    range As Range, _
    name As String _
) As NamedRange

NamedRange AddNamedRange(
    Range range,
    string name
)

參數

• range
  型別：Microsoft.Office.Interop.Excel.Range
  提供控制項繫結的 Range。

• name
  型別：System.String
  可於 ControlCollection 執行個體中用於索引控制項的控制項名稱。

傳回值

型別：Microsoft.Office.Tools.Excel.NamedRange
已加入至 ControlCollection 執行個體的 NamedRange 控制項。

例外狀況

備註

AddNamedRange 方法可以用來將 NamedRange 控制項加入至 ControlCollection 的結尾。 若要移除先前以程式設計方式加入的 NamedRange 控制項，請使用 Remove 方法。

範例

下列程式碼範例會將 NamedRange 控制項加入至儲存格 A1，然後將已命名範圍的值設定為 100%。

    Private Sub ExcelAddNamedRange()

        Dim NamedRange1 As Microsoft.Office.Tools. _
          Excel.NamedRange = Me.Controls.AddNamedRange( _
          Me.Range("A1"), "NamedRange1")
        NamedRange1.Value2 = "100%"

    End Sub

private void ExcelAddNamedRange()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", missing],
        "namedRange1");
    namedRange1.Value2 = "100%";
}

.NET Framework 安全性

• 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。

請參閱

參考

ControlCollection 介面

Microsoft.Office.Tools.Excel 命名空間