NamedRange.ApplyNames, méthode

  • Article

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.
  • 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

Voir aussi

Référence

NamedRange Interface

Microsoft.Office.Tools.Excel, espace de noms