ControlCollection.AddNamedRange – metoda
Přidá nový NamedRange ovládací prvek na list na zadaný rozsah.
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 | Argument název nebo rozsah 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ž ControlCollection instance. |
InvalidRangeException | Zadaný rozsah je neplatný.Nelze použít s rozsahy.Rozsah by měl být na stejném listu jako ControlCollection instance. |
Poznámky
AddNamedRange Metoda umožňuje přidat NamedRange ovládacích prvků na konec ControlCollection.Chcete-li odebrat NamedRange ovládací prvek, který byl dříve přidán programově, použijte Remove metody.
Příklady
Následující příklad kódu přidá NamedRange řízení na buňku 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"],
"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.