ControlCollection.AddNamedRange – metoda

Článek
08/11/2011

Přidá nový NamedRange řízení v rozsahu určeném listu.

Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel (v Microsoft.Office.Tools.Excel.dll)

Syntaxe

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

NamedRange AddNamedRange(
    Range range,
    string name
)

Parametry

range
Typ: Microsoft.Office.Interop.Excel.Range
A Range , který poskytuje hranice ovládacího prvku.

name
Typ: System.String
Název ovládacího prvku, který lze použít k řízení v rejstříku ControlCollection instance.

Vrácená hodnota

Typ: Microsoft.Office.Tools.Excel.NamedRange
NamedRange Ovládací prvek, který byl přidán ControlCollection instance.

Výjimky

Výjimka	Podmínka
ArgumentNullException	Oblast nebo název argument je nullodkaz Null (Nothing v jazyce Visual Basic), nebo argument název má nulovou délku.
ControlNameAlreadyExistsException	Ovládací prvek se stejným názvem je již v ControlCollection instance.
InvalidRangeException	Určený rozsah je platný. Multi -oblast rozsahy nelze použít. Rozsah by měl být na stejném list jako ControlCollection instance.

Poznámky

AddNamedRange Metoda umožňuje přidat NamedRange ovládací prvky na konci ControlCollection. Odebrání NamedRange , které dříve přidali programově, použijte Remove metody.

Příklady

Následující příklad kódu přidá NamedRange řízení buňky A1a poté nastaví hodnotu pojmenovanou oblast na 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%";
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Odkaz

ControlCollection Rozhraní

Microsoft.Office.Tools.Excel – obor názvů

Sdílet prostřednictvím