NamedRange.ApplyNames (Método)
Aplica nombres a las celdas del control NamedRange.
Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)
Sintaxis
'Declaración
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
)
Parámetros
- Names
Tipo: System.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
Tipo: System.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
Tipo: System.Object
Es true para utilizar nombres de rangos de filas y columnas que contengan el rango especificado si los nombres del rango no se pueden encontrar; es false para omitir los argumentos OmitColumn y OmitRow.El valor predeterminado es true.
- OmitColumn
Tipo: System.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
Tipo: System.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
Tipo: Microsoft.Office.Interop.Excel.XlApplyNamesOrder
Determina el nombre del rango que se muestra primero cuando la referencia a una celda se reemplaza por un nombre de rango orientado a filas y a columnas.
Puede ser una de estas constantes XlApplyNamesOrder:
xlColumnThenRow
xlRowThenColumn
- AppendLast
Tipo: System.Object
Es true para reemplazar las definiciones de los nombres de Names y también reemplaza las definiciones de los últimos nombres definidos; es false para reemplazar las definiciones de los nombres de Names exclusivamente.El valor predeterminado es false.
Valor devuelto
Tipo: System.Object
Comentarios
Puede utilizar la función Array para crear la lista de nombres del argumento Names.
Si desea aplicar los nombres a la hoja completa, utilice Cells.ApplyNames.
No puede "no aplicar" nombres; para eliminar nombres, utilice el método Delete.
Parámetros opcionales
Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
En el ejemplo de código siguiente se utiliza el método ApplyNames para aplicar un conjunto de nombres a un control NamedRange.
Se trata de un ejemplo para una personalización en el nivel del documento.
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);
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.