NamedRange.ApplyNames, méthode

Article
08/10/2011

Applique des noms aux cellules du contrôle NamedRange.

Espace de noms : Microsoft.Office.Tools.Excel
Assembly : Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Déclaration
Function ApplyNames ( _
    Names As Object, _
    IgnoreRelativeAbsolute As Object, _
    UseRowColumnNames As Object, _
    OmitColumn As Object, _
    OmitRow As Object, _
    Order As XlApplyNamesOrder, _
    AppendLast As Object _
) As Object

Object ApplyNames(
    Object Names,
    Object IgnoreRelativeAbsolute,
    Object UseRowColumnNames,
    Object OmitColumn,
    Object OmitRow,
    XlApplyNamesOrder Order,
    Object AppendLast
)

Paramètres

Names
Type : System.Object
Tableau des noms à appliquer.Si cet argument est omis, tous les noms figurant sur la feuille sont appliqués à la plage.

IgnoreRelativeAbsolute
Type : System.Object
true pour remplacer des références par des noms, quels que soient les types référence des noms ou des références ; false pour remplacer les références absolues uniquement par des noms absolus, les références relatives uniquement par des noms relatifs, et les références mixtes uniquement avec des noms mixtes.La valeur par défaut est true.

UseRowColumnNames
Type : System.Object
true pour utiliser les noms des plages de lignes et de colonnes qui contiennent la plage spécifiée si les noms de la plage sont introuvables ; false pour ignorer les arguments OmitColumn et OmitRow.La valeur par défaut est true.

OmitColumn
Type : System.Object
true pour remplacer la totalité de la référence par le nom orienté ligne.Le nom orienté colonne ne peut être omis que si la cellule référencée se trouve dans la même colonne que la formule et se trouve dans une plage nommée orientée ligne.La valeur par défaut est true.

OmitRow
Type : System.Object
true pour remplacer la totalité de la référence par le nom orienté colonne.Le nom orienté ligne ne peut être omis que si la cellule référencée se trouve dans la même ligne que la formule et se trouve dans une plage nommée orientée colonne.La valeur par défaut est true.

Order
Type : Microsoft.Office.Interop.Excel.XlApplyNamesOrder
Détermine quel nom de plage est répertorié en premier lorsqu'une référence de cellule est remplacée par un nom de plage orienté ligne et par un nom de plage orienté colonne.
Il peut s'agir de l'une des constantes XlApplyNamesOrder suivantes :
xlColumnThenRow
xlRowThenColumn

AppendLast
Type : System.Object
true pour remplacer les définitions des noms contenus dans Names et pour remplacer également les définitions des noms de famille qui ont été définis ; false pour remplacer uniquement les définitions des noms contenus dans Names.La valeur par défaut est false.

Valeur de retour

Type : System.Object

Notes

Vous pouvez utiliser la fonction Array pour créer la liste de noms pour l'argument Names.

Si vous souhaitez appliquer des noms à la totalité de la feuille, utilisez Cells.ApplyNames.

Vous ne pouvez pas annuler l'application de noms ; pour supprimer des noms, utilisez la méthode Delete.

Paramètres optionnels

Pour plus d'informations sur les paramètres optionnels, consultez Paramètres optionnels dans les solutions Office.

Exemples

L'exemple de code suivant utilise la méthode ApplyNames pour appliquer un ensemble de noms à un contrôle NamedRange.

Cet exemple illustre une personnalisation au niveau du document.

    Private Sub AddNames()
        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
            "namedRange1")

        Dim s() As String = {"One", "Two", "Three", "Four", "Five"}
        namedRange1.ApplyNames(s, True, True, True, True, _
            Excel.XlApplyNamesOrder.xlColumnThenRow, False)
    End Sub

private void AddNames()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    string[] s = new string[] { "One", "Two", "Three", "Four", "Five" };
    namedRange1.ApplyNames(s, true, true, true, true,
        Excel.XlApplyNamesOrder.xlColumnThenRow, false);
}

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.

Voir aussi

Référence

NamedRange Interface

Microsoft.Office.Tools.Excel, espace de noms

Partager via