NamedRange.Insert (Método)
Inserta una celda o un rango de celdas en el control NamedRange y desplaza el resto de las celdas para que haya espacio.
Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)
Sintaxis
'Declaración
Function Insert ( _
Shift As Object, _
CopyOrigin As Object _
) As Object
Object Insert(
Object Shift,
Object CopyOrigin
)
Parámetros
- Shift
Tipo: System.Object
Especifica hacia dónde se desplazarán las celdas.Puede ser uno de los siguientes valores de XlInsertShiftDirection: xlShiftToRight o xlShiftDown.Si se omite este argumento, Microsoft Office Excel decide basándose en la forma del rango.
- CopyOrigin
Tipo: System.Object
Uno de los valores de XlInsertFormatOrigin que especifica dónde obtener el formato que se aplica a las nuevas celdas.
Valor devuelto
Tipo: System.Object
Comentarios
Parámetros opcionales
Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
En el siguiente ejemplo de código se establecen los valores de las celdas A1 a A3 y, a continuación, se usa el método Insert para insertar una celda en blanco en un control NamedRange denominado NamedRange1 establecido en la celda A1. Esta operación desplaza las celdas del rango hacia abajo, es decir, NamedRange1 ahora está establecido en la celda A2. Para demostrarlo, el ejemplo establece el valor de NamedRange1 en Raven, que aparece en celda A2.
Se trata de un ejemplo para una personalización en el nivel del documento.
Private Sub InsertIntoRange()
Me.Range("A1").Value2 = "Robin"
Me.Range("A2").Value2 = "Sparrow"
Me.Range("A3").Value2 = "Crow"
Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
= Me.Controls.AddNamedRange(Me.Range("A1"), _
"namedRange1")
namedRange1.Insert(Excel.XlInsertShiftDirection.xlShiftDown, )
namedRange1.Value2 = "Raven"
End Sub
private void InsertIntoRange()
{
this.Range["A1", missing].Value2 = "Robin";
this.Range["A2", missing].Value2 = "Sparrow";
this.Range["A3", missing].Value2 = "Crow";
Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
this.Controls.AddNamedRange(this.Range["A1", missing],
"namedRange1");
namedRange1.Insert(Excel.XlInsertShiftDirection.xlShiftDown, missing);
namedRange1.Value2 = "Raven";
}
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.