ControlCollection.AddNamedRange(Range, String) Metoda

Definice

Přidá nový NamedRange ovládací prvek do listu v zadaném rozsahu.

public Microsoft.Office.Tools.Excel.NamedRange AddNamedRange (Microsoft.Office.Interop.Excel.Range range, string name);

Parametry

range
Range

Range, Který poskytuje meze pro ovládací prvek.

name
String

Název ovládacího prvku, který lze použít k indexování ovládacího prvku v ControlCollection instanci.

Návraty

NamedRange

NamedRangeOvládací prvek, který byl přidán do ControlCollection instance.

Výjimky

Argument name nebo Range je null , nebo má argument name nulovou délku.

V instanci již je ovládací prvek se stejným názvem ControlCollection .

Zadaný rozsah není platný. Rozsahy s více oblastmi nelze použít. Rozsah by měl být na stejném listu jako ControlCollection instance.

Příklady

Následující příklad kódu přidá NamedRange ovládací prvek do buňky a1a poté nastaví hodnotu pojmenovaného rozsahu na 100%.

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

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

End Sub

Poznámky

AddNamedRangeMetoda umožňuje přidat NamedRange ovládací prvky na konec ControlCollection . Chcete-li odebrat NamedRange ovládací prvek, který byl dříve přidán programově, použijte Remove metodu.

Platí pro