ControlCollection.AddNamedRange, méthode
Ajoute un nouveau contrôle NamedRange à la feuille de calcul à la plage spécifiée.
Espace de noms : Microsoft.Office.Tools.Excel
Assembly : Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)
Syntaxe
'Déclaration
Function AddNamedRange ( _
range As Range, _
name As String _
) As NamedRange
NamedRange AddNamedRange(
Range range,
string name
)
Paramètres
- range
Type : Microsoft.Office.Interop.Excel.Range
Range qui fournit les limites du contrôle.
- name
Type : System.String
Nom du contrôle qui peut être utilisé pour indexer le contrôle dans l'instance ControlCollection.
Valeur de retour
Type : Microsoft.Office.Tools.Excel.NamedRange
Contrôle NamedRange qui a été ajouté à l'instance de ControlCollection.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | L'argument de nom ou de plage a la valeur nullune référence null (Nothing en Visual Basic) ou l'argument de nom a une longueur nulle. |
| ControlNameAlreadyExistsException | Un contrôle du même nom se trouve déjà dans l'instance de ControlCollection. |
| InvalidRangeException | La plage spécifiée n'est pas valide. Les plages sur plusieurs zones ne peuvent pas être utilisées. La plage doit se trouver dans la même feuille de calcul que l'instance de ControlCollection. |
Notes
La méthode AddNamedRange vous permet d'ajouter des contrôles NamedRange à la fin de ControlCollection. Pour supprimer un contrôle NamedRange précédemment ajouté par programme, utilisez la méthode Remove.
Exemples
L'exemple de code suivant ajoute un contrôle NamedRange à la cellule A1, puis affecte la valeur 100 % à la plage nommée.
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%";
}
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.