NamedRange.ApplyNames Método

Definición

Espacio de nombres:

Microsoft.Office.Tools.Excel

Ensamblado:

Microsoft.Office.Tools.Excel.dll

Aplica nombres a las celdas del control 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

Parámetros

Names

Object

Matriz de los nombres que se van a aplicar. Si se omite este argumento, todos los nombres de la hoja se aplican al rango.

IgnoreRelativeAbsolute

Object

Es true para reemplazar las referencias con nombres, independientemente de los tipos de referencias tanto de los nombres como de las referencias; es false para reemplazar referencias absolutas sólo por nombres absolutos, referencias relativas sólo por nombres relativos y referencias mixtas sólo por nombres mixtos. El valor predeterminado es true.

UseRowColumnNames

Object

true para utilizar los nombres de los intervalos de filas y columnas que contienen el intervalo especificado si no se pueden encontrar nombres para el rango; false para pasar por alto los OmitColumn argumentos y OmitRow . El valor predeterminado es true.

OmitColumn

Object

Es true para reemplazar la referencia completa por el nombre orientado a filas. Se puede omitir el nombre orientado a columnas sólo si la celda a la que hace referencia está en la misma columna que la fórmula y en un rango con nombre orientado a filas. El valor predeterminado es true.

OmitRow

Object

Es true para reemplazar la referencia completa por el nombre orientado a columnas. Se puede omitir el nombre orientado a filas sólo si la celda a la que hace referencia está en la misma fila que la fórmula y en un rango con nombre orientado a columnas. El valor predeterminado es true.

Order

XlApplyNamesOrder

Determina qué nombre de rango se muestra en primer lugar cuando se reemplaza una referencia de celda por un nombre de rango orientado a filas y orientado a columnas. Puede ser una de estas XlApplyNamesOrder constantes: xlColumnThenRowxlRowThenColumn

AppendLast

Object

true para reemplazar las definiciones de los nombres de Names y también las definiciones de los apellidos definidos; false para reemplazar las definiciones de los nombres en Names solo . El valor predeterminado es false.

Devoluciones

Object

Ejemplos

En el ejemplo de código siguiente se usa el ApplyNames método para aplicar un conjunto de nombres a un NamedRange control .

Este ejemplo es para una personalización de nivel de documento.

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

Comentarios

Puede usar la Array función para crear la lista de nombres para el Names argumento .

Si desea aplicar nombres a toda la hoja, use Cells.ApplyNames.

No se pueden "no aplicar" nombres; para eliminar nombres, use el Delete método .

Parámetros opcionales

Para obtener información sobre los parámetros opcionales, vea Parámetros opcionales en soluciones de Office.