Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 nullein Nullverweis (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"],
"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.