ControlCollection.AddNamedRange-Methode
Fügt dem Arbeitsblatt im angegebenen Bereich ein neues NamedRange-Steuerelement hinzu.
Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)
Syntax
'Declaration
Function AddNamedRange ( _
range As Range, _
name As String _
) As NamedRange
NamedRange AddNamedRange(
Range range,
string name
)
Parameter
- range
Typ: Microsoft.Office.Interop.Excel.Range
Ein Range, der die Begrenzungen des Steuerelements angibt.
- name
Typ: System.String
Der Name des Steuerelements, der zum Indizieren des Steuerelements in der ControlCollection-Instanz verwendet werden kann.
Rückgabewert
Typ: Microsoft.Office.Tools.Excel.NamedRange
Das NamedRange-Steuerelement, das der ControlCollection-Instanz hinzugefügt wurde.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentNullException | Das Argument für den Namen oder den Bereich ist nullNULL-Verweis (Nothing in Visual Basic), oder das Argument für den Namen hat die Länge 0 (null). |
| ControlNameAlreadyExistsException | Ein Steuerelement mit dem gleichen Namen ist bereits in der ControlCollection-Instanz vorhanden. |
| InvalidRangeException | Der angegebene Bereich ist nicht gültig. Bereiche, die mehrere Bereiche enthalten, können nicht verwendet werden. Der Bereich muss sich auf dem gleichen Arbeitsblatt wie die ControlCollection-Instanz befinden. |
Hinweise
Mithilfe der AddNamedRange-Methode können Sie NamedRange-Steuerelemente am Ende der ControlCollection hinzufügen. Um ein NamedRange-Steuerelement zu entfernen, das zuvor programmgesteuert hinzugefügt wurde, verwenden Sie die Remove-Methode.
Beispiele
Im folgenden Codebeispiel wird Zelle A1 ein NamedRange-Steuerelement hinzugefügt, und dann wird der Wert des benannten Bereichs auf 100 % festgelegt.
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-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.