NamedRange.ApplyNames Méthode

Définition

Espace de noms:

Microsoft.Office.Tools.Excel

Assembly:

Microsoft.Office.Tools.Excel.dll

Applique des noms aux cellules du contrôle NamedRange.

public object ApplyNames (object Names, object IgnoreRelativeAbsolute, object UseRowColumnNames, object OmitColumn, object OmitRow, Microsoft.Office.Interop.Excel.XlApplyNamesOrder Order = Microsoft.Office.Interop.Excel.XlApplyNamesOrder.xlRowThenColumn, object AppendLast);

abstract member ApplyNames : obj * obj * obj * obj * obj * Microsoft.Office.Interop.Excel.XlApplyNamesOrder * obj -> obj

Public Function ApplyNames (Optional Names As Object, Optional IgnoreRelativeAbsolute As Object, Optional UseRowColumnNames As Object, Optional OmitColumn As Object, Optional OmitRow As Object, Optional Order As XlApplyNamesOrder = Microsoft.Office.Interop.Excel.XlApplyNamesOrder.xlRowThenColumn, Optional AppendLast As Object) As Object

Paramètres

Names

Object

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

IgnoreRelativeAbsolute

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

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 OmitColumn arguments et OmitRow . La valeur par défaut est true.

OmitColumn

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

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

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 orienté colonne. Il peut s’agir de l’une des constantes suivantes XlApplyNamesOrder : xlColumnThenRowxlRowThenColumn

AppendLast

Object

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

Retours

Object

Exemples

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

Cet exemple concerne une personnalisation au niveau du document.

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);
}

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

Remarques

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

Si vous souhaitez appliquer des noms à la feuille entière, utilisez Cells.ApplyNames.

Vous ne pouvez pas « désappliquer » les noms ; pour supprimer des noms, utilisez la Delete méthode .

Paramètres facultatifs

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