Worksheet (Interfaz)

  • Artículo

Representa una hoja de cálculo de proyectos de Excel creada mediante las herramientas de desarrollo de Office incluidas en Visual Studio.

Espacio de nombres:  Microsoft.Office.Tools.Excel
Ensamblado:  Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)

Sintaxis

'Declaración
<GuidAttribute("297dc8d9-eabd-45a1-bdef-68ab67e5c3c3")> _
Public Interface Worksheet _
    Inherits IBindableComponent, IComponent, IDisposable, ISupportInitialize

[GuidAttribute("297dc8d9-eabd-45a1-bdef-68ab67e5c3c3")]
public interface Worksheet : IBindableComponent, 
    IComponent, IDisposable, ISupportInitialize

El tipo Worksheet expone los siguientes miembros.

Propiedades

  Nombre Descripción
Propiedad pública _CodeName Infraestructura.
Propiedad pública _DisplayRightToLeft Infraestructura.
Propiedad pública Application Esta propiedad obtiene un objeto Microsoft.Office.Interop.Excel.Application que representa la aplicación Microsoft Office Excel.
Propiedad pública AutoFilter Obtiene una interfaz Microsoft.Office.Interop.Excel.AutoFilter que proporciona información sobre las listas filtradas en la hoja de cálculo si el filtrado está habilitado.Obtiene nullreferencia null (Nothing en Visual Basic) si el filtrado está desactivado.
Propiedad pública AutoFilterMode Obtiene o establece un valor que indica si el filtrado está habilitado actualmente en la hoja de cálculo (es decir, si actualmente se muestran las flechas desplegables del filtro).
Propiedad pública BindingContext Obtiene o establece la colección de administradores de moneda para IBindableComponent. (Se hereda de IBindableComponent).
Propiedad pública Cells Obtiene un objeto Range que representa todas las celdas de la hoja de cálculo (y no solo las celdas que están actualmente en uso).
Propiedad pública CircularReference Obtiene un objeto Range que representa el rango que contiene la primera referencia circular en la hoja u obtiene nullreferencia null (Nothing en Visual Basic) si no hay ninguna referencia circular en la hoja.
Propiedad pública CodeName Infraestructura.
Propiedad pública Columns Obtiene un objeto Range que representa una o más columnas en la hoja de cálculo.
Propiedad pública Comments Obtiene una colección Microsoft.Office.Interop.Excel.Comments que representa todos los comentarios para la hoja de cálculo.
Propiedad pública ConsolidationFunction Obtiene el código de función utilizado para la consolidación actual.
Propiedad pública ConsolidationOptions Obtiene una clase Array de tres elementos de opciones de consolidación.
Propiedad pública ConsolidationSources Obtiene una clase Array de cadenas que dan nombre a las hojas y rangos de origen de la consolidación actual de la hoja de cálculo.
Propiedad pública Controls Obtiene la colección de controles administrados contenidos en la hoja de cálculo.
Propiedad pública Creator Obtiene un valor que indica la aplicación donde fue creada la hoja de cálculo.
Propiedad pública CustomProperties Obtiene un objeto Microsoft.Office.Interop.Excel.CustomProperties que representa la información del identificador asociado a una hoja de cálculo.
Propiedad pública DataBindings Obtiene la colección de objetos de enlace de datos para esta interfaz IBindableComponent. (Se hereda de IBindableComponent).
Propiedad pública DataHost Infraestructura.
Propiedad pública DefaultExtension Obtiene la extensión predeterminada de este objeto Worksheet.
Propiedad pública DisplayAutomaticPageBreaks Infraestructura.
Propiedad pública DisplayPageBreaks Obtiene o establece un valor que indica si se muestran saltos de página (automáticos y manuales) en la hoja de cálculo.
Propiedad pública DisplayRightToLeft Obtiene o establece un valor que indica si la hoja de cálculo se muestra de derecha a izquierda en lugar de de izquierda a derecha.
Propiedad pública EnableAutoFilter Obtiene o establece un valor que indica si se habilitan flechas Autofiltro cuando está activada la protección de sólo interfaz de usuario.
Propiedad pública EnableCalculation Obtiene o establece un valor que indica si Microsoft Office Excel vuelve a calcular automáticamente la hoja de cálculo cuando es necesario.
Propiedad pública EnableFormatConditionsCalculation Obtiene o establece un valor que determina si los formatos condicionales se producirán automáticamente.
Propiedad pública EnableOutlining Obtiene o establece un valor que indica si se habilitan los símbolos de esquema cuando está activada la protección de sólo interfaz de usuario.
Propiedad pública EnablePivotTable Obtiene o establece un valor que indica si los controles y acciones de tabla dinámica se habilitan cuando se activa la protección de sólo interfaz de usuario.
Propiedad pública EnableSelection Obtiene o establece un valor que indica qué celdas se pueden seleccionar en la hoja.
Propiedad pública Extension Obtiene una extensión personalizada de este objeto Worksheet.
Propiedad pública FilterMode Obtiene un valor que indica si la hoja de cálculo está filtrando activamente los datos.
Propiedad pública HostContext Infraestructura.
Propiedad pública HPageBreaks Obtiene una colección Microsoft.Office.Interop.Excel.HPageBreaks que representa los saltos de página horizontales de la hoja.
Propiedad pública Hyperlinks Obtiene una colección Microsoft.Office.Interop.Excel.Hyperlinks que representa los hipervínculos del rango u hoja de cálculo.
Propiedad pública Index Obtiene el número de índice de la hoja de cálculo en la colección de hojas de cálculo.
Propiedad pública InnerObject Obtiene un objeto Microsoft.Office.Interop.Excel.Worksheet que representa el objeto nativo subyacente de Worksheet.
Propiedad pública ItemProvider Infraestructura.
Propiedad pública ListObjects Obtiene una colección de los objetos Microsoft.Office.Interop.Excel.ListObject de la hoja de cálculo.
Propiedad pública MailEnvelope Obtiene un encabezado de correo electrónico para la hoja de cálculo.
Propiedad pública Name Obtiene o establece el nombre de la hoja de cálculo.
Propiedad pública Names Obtiene una colección Microsoft.Office.Interop.Excel.Names que representa todos los nombres específicos de la hoja de cálculo (los nombres definidos con el prefijo "WorksheetName!").
Propiedad pública Next Obtiene un objeto Microsoft.Office.Interop.Excel.Worksheet que representa la hoja siguiente.
Propiedad pública OnCalculate Infraestructura.
Propiedad pública OnData Infraestructura.
Propiedad pública OnDoubleClick Infraestructura.
Propiedad pública OnEntry Infraestructura.
Propiedad pública OnSheetActivate Infraestructura.
Propiedad pública OnSheetDeactivate Infraestructura.
Propiedad pública Outline Obtiene un objeto Microsoft.Office.Interop.Excel.Outline que representa el esquema de la hoja de cálculo.
Propiedad pública PageSetup Obtiene un objeto Microsoft.Office.Interop.Excel.PageSetup que contiene toda la configuración de página de la hoja de cálculo.
Propiedad pública Parent Obtiene el objeto primario de la hoja de cálculo.
Propiedad pública Previous Obtiene un objeto Microsoft.Office.Interop.Excel.Worksheet que representa la hoja anterior.
Propiedad pública PrintedCommentPages Obtiene el número de páginas de comentarios que se van a imprimir para la hoja de cálculo actual.Esta propiedad solo se puede usar en los proyectos de Excel 2010.
Propiedad pública ProtectContents Obtiene un valor que indica si el contenido de la hoja de cálculo (las celdas individuales) está protegido.
Propiedad pública ProtectDrawingObjects Obtiene un valor que indica si las formas están protegidas.
Propiedad pública Protection Obtiene un objeto Microsoft.Office.Interop.Excel.Protection que representa las opciones de protección de la hoja de cálculo.
Propiedad pública ProtectionMode Obtiene un valor que indica si está activada la protección de sólo interfaz de usuario.
Propiedad pública ProtectScenarios Obtiene un valor que indica si los escenarios de la hoja de cálculo están protegidos.
Propiedad pública QueryTables Obtiene la colección Microsoft.Office.Interop.Excel.QueryTables que representa todas las tablas de consulta de la hoja de cálculo.
Propiedad pública Range Obtiene un objeto Microsoft.Office.Interop.Excel.Range que representa una celda o un rango de celdas.
Propiedad pública Rows Obtiene un objeto Range que representa una o más filas en la hoja de cálculo.
Propiedad pública Scripts Obtiene la colección Microsoft.Office.Core.Scripts, que contiene objetos Script que representan bloques de script o de código en la hoja de cálculo cuando se guarda como una página web.
Propiedad pública ScrollArea Obtiene o establece el rango donde se permite el desplazamiento, en una referencia de rango de estilo A1.
Propiedad pública Shapes Obtiene un objeto Microsoft.Office.Interop.Excel.Shapes que representa todas las formas de la hoja de cálculo.
Propiedad pública Site Obtiene o establece la interfaz ISite asociada a la interfaz IComponent. (Se hereda de IComponent).
Propiedad pública SmartTags Obtiene un objeto Microsoft.Office.Interop.Excel.SmartTags que representa la colección de etiquetas inteligentes de la hoja de cálculo.
Propiedad pública Sort Obtiene los valores ordenados en la hoja de cálculo actual.
Propiedad pública StandardHeight Obtiene el alto estándar (valor predeterminado) de todas las filas de la hoja de cálculo, en puntos.
Propiedad pública StandardWidth Obtiene o establece la ancho estándar (valor predeterminado) de todas las columnas de la hoja de cálculo.
Propiedad pública Tab Obtiene un objeto Microsoft.Office.Interop.Excel.Tab para la hoja de cálculo.
Propiedad pública Tag Obtiene o establece el objeto que contiene datos sobre la hoja de cálculo.
Propiedad pública TransitionExpEval Obtiene o establece un valor que indica si Microsoft Office Excel utiliza las reglas de evaluación de expresión de Lotus 1-2-3 en la hoja de cálculo.
Propiedad pública TransitionFormEntry Obtiene o establece un valor que indica si Microsoft Office Excel utiliza las reglas de introducción de fórmulas de Lotus 1-2-3 en la hoja de cálculo.
Propiedad pública Type Obtiene el tipo de hoja de cálculo.
Propiedad pública UsedRange Obtiene un objeto Microsoft.Office.Interop.Excel.Range que representa todas las celdas que han contenido un valor en algún momento.
Propiedad pública Visible Obtiene o establece un valor Microsoft.Office.Interop.Excel.XlSheetVisibility que determina si el objeto es visible.
Propiedad pública VPageBreaks Obtiene una colección Microsoft.Office.Interop.Excel.VPageBreaks que representa los saltos de página verticales de la hoja.

Arriba

Métodos

  Nombre Descripción
Método público _CheckSpelling Infraestructura.
Método público _Evaluate Infraestructura.
Método público _PasteSpecial Infraestructura.
Método público _PrintOut Infraestructura.
Método público _Protect Infraestructura.
Método público _SaveAs Infraestructura.
Método público Activate Establece la hoja actual como la hoja activa.
Método público Arcs Infraestructura.
Método público BeginInit Indica al objeto que está comenzando la inicialización. (Se hereda de ISupportInitialize).
Método público Buttons Infraestructura.
Método público CalculateMethod Calcula las fórmulas de la hoja de cálculo.
Método público ChartObjects Obtiene un objeto que representa un único gráfico incrustado (un objeto Microsoft.Office.Interop.Excel.ChartObject) o una colección de todos los gráficos incrustados (una colección Microsoft.Office.Interop.Excel.ChartObjects) en la hoja de cálculo.
Método público CheckBoxes Infraestructura.
Método público CheckSpelling Comprueba la ortografía en una hoja de cálculo.
Método público CircleInvalid Rodea con un círculo las entradas no válidas en la hoja de cálculo.
Método público ClearArrows Borra las flechas de rastreo de la hoja de cálculo.Las flechas de rastreo se agregan con la característica de auditoría.
Método público ClearCircles Borra los círculos de las entradas no válidas en la hoja de cálculo.
Método público Copy Copia la hoja de cálculo a otra ubicación del libro.
Método público Delete Elimina el objeto Microsoft.Office.Interop.Excel.Worksheet subyacente, pero no elimina el elemento host.Se recomienda encarecidamente que no se utilice este método.
Método público Dispose Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Se hereda de IDisposable).
Método público DrawingObjects Infraestructura.
Método público Drawings Infraestructura.
Método público DropDowns Infraestructura.
Método público EndInit Indica al objeto que se ha completado la inicialización. (Se hereda de ISupportInitialize).
Método público Evaluate Convierte un nombre de Microsoft Office Excel en un objeto o un valor.
Método público ExportAsFixedFormat Exporta a un archivo del formato especificado.
Método público get_Range Obtiene un objeto Microsoft.Office.Interop.Excel.Range que representa una celda o un rango de celdas.Use la propiedad Range en lugar de este método.
Método público GroupBoxes Infraestructura.
Método público GroupObjects Infraestructura.
Método público Labels Infraestructura.
Método público Lines Infraestructura.
Método público ListBoxes Infraestructura.
Método público Move Mueve la hoja de cálculo a otra ubicación del libro.
Método público OLEObjects Obtiene un objeto que representa un objeto OLE único (un objeto Microsoft.Office.Interop.Excel.OLEObject) o una colección de todos los objetos OLE (una colección Microsoft.Office.Interop.Excel.OLEObjects) en la hoja de cálculo.
Método público OptionButtons Infraestructura.
Método público Ovals Infraestructura.
Método público Paste Pega el contenido del Portapapeles en la hoja de cálculo.
Método público PasteSpecial Pega el contenido del Portapapeles en la hoja de cálculo, utilizando un formato especificado.Utilice este método para pegar datos de otras aplicaciones o para pegar los datos con un formato concreto.
Método público Pictures Infraestructura.
Método público PivotTables Obtiene un objeto que representa un informe de tabla dinámica único (un objeto Microsoft.Office.Interop.Excel.PivotTable) o una colección de todos los informes de tabla dinámica (un objeto Microsoft.Office.Interop.Excel.PivotTables) en una hoja de cálculo.
Método público PivotTableWizard Crea un objeto Microsoft.Office.Interop.Excel.PivotTable.
Método público PrintOut Imprime la hoja de cálculo.
Método público PrintOutEx Imprime la hoja de cálculo.
Método público PrintPreview Muestra una vista previa de la hoja de cálculo tal como aparecerá cuando se imprima.
Método público Protect Protege una hoja de cálculo para que no se pueda modificar.
Método público Rectangles Infraestructura.
Método público ResetAllPageBreaks Restablece todos los saltos de página de la hoja de cálculo especificada.
Método público SaveAs Guarda los cambios de la hoja de cálculo en un archivo diferente.
Método público Scenarios Obtiene un objeto que representa un escenario único (un objeto Microsoft.Office.Interop.Excel.Scenario) o una colección de escenarios (un objeto Microsoft.Office.Interop.Excel.Scenarios) en la hoja de cálculo.
Método público ScrollBars Infraestructura.
Método público Select Selecciona la hoja de cálculo.
Método público SetBackgroundPicture Establece el gráfico de fondo de la hoja de cálculo.
Método público ShowAllData Convierte en visibles todas las filas de la lista actualmente filtrada.Si Autofiltro está en uso, este método cambia las flechas a "Todas".
Método público ShowDataForm Muestra el formulario de datos asociado a la hoja de cálculo.
Método público Spinners Infraestructura.
Método público TextBoxes Infraestructura.
Método público Unprotect Quita la protección de la hoja de cálculo.Este método no tiene ningún efecto si la hoja de cálculo no está protegida.
Método público XmlDataQuery Obtiene un objeto Range que representa las celdas asignadas a un elemento XPath determinado.Obtiene nullreferencia null (Nothing en Visual Basic) si el elemento XPath especificado no se ha asignado a la hoja de cálculo o si el rango asignado está vacío.
Método público XmlMapQuery Obtiene un objeto Range que representa las celdas asignadas a un elemento XPath determinado.Obtiene nullreferencia null (Nothing en Visual Basic) si el elemento XPath especificado no se ha asignado a la hoja de cálculo.

Arriba

Eventos

  Nombre Descripción
Evento público ActivateEvent Se produce cuando se activa la hoja de cálculo.
Evento público BeforeDoubleClick Se produce cuando se hace doble clic en la hoja de cálculo, antes de ejecutarse la acción de doble clic predeterminada.
Evento público BeforeRightClick Se produce cuando se hace clic con el botón secundario en la hoja de cálculo, antes de ejecutarse la acción de clic con el botón secundario predeterminada.
Evento público BindingContextChanged Infraestructura.
Evento público Calculate Se produce después de volver a calcular la hoja de cálculo.
Evento público Change Se produce cuando tiene lugar algún cambio en las celdas de Worksheet.
Evento público Deactivate Se produce cuando la hoja de cálculo pierde el foco.
Evento público Disposed Representa el método que controla el evento Disposed de un componente. (Se hereda de IComponent).
Evento público FollowHyperlink Este evento se produce al hacer clic en un hipervínculo de una hoja de cálculo.
Evento público PivotTableAfterValueChange Se produce después de editar o volver a calcular una celda o un rango de celdas dentro de una tabla dinámica (para las celdas que contienen fórmulas).Este evento solo se puede usar en los proyectos de Excel 2010.
Evento público PivotTableBeforeAllocateChanges Se produce antes de que se apliquen los cambios a una tabla dinámica.Este evento solo se puede usar en los proyectos de Excel 2010.
Evento público PivotTableBeforeCommitChanges Se produce antes de confirmar los cambios realizados en una tabla dinámica en el origen de datos OLAP.Este evento solo se puede usar en los proyectos de Excel 2010.
Evento público PivotTableBeforeDiscardChanges Se produce antes de que se descarten los cambios realizados en una tabla dinámica.Este evento solo se puede usar en los proyectos de Excel 2010.
Evento público PivotTableChangeSync Se produce después de realizar cambios en una tabla dinámica.Este evento solo se puede usar en los proyectos de Excel 2010.
Evento público PivotTableUpdate Se produce después de actualizar un informe de tabla dinámica en una hoja de cálculo.
Evento público SelectionChange Se produce cuando cambia la selección en una hoja de cálculo.
Evento público Shutdown Se produce cuando se cierra el elemento host de la hoja de cálculo.
Evento público Startup Se produce tras la ejecución de la hoja de cálculo y después de haberse ejecutado todo el código de inicialización del ensamblado.

Arriba

Comentarios

Un objeto Microsoft.Office.Tools.Excel.Worksheet proporciona los mismos miembros que un objeto Microsoft.Office.Interop.Excel.Worksheet del ensamblado de interoperabilidad primario de Excel, pero agrega las características siguientes:

En los proyectos en el nivel de la aplicación, puede crear objetos Microsoft.Office.Tools.Excel.Worksheet mediante programación usando el método GetVstoObject. Para obtener más información, vea Ampliar documentos de Word y libros de Excel en complementos en el nivel de la aplicación en tiempo de ejecución.

En proyectos de nivel de documento, normalmente no se usan directamente el objeto Microsoft.Office.Tools.Excel.Worksheet. En su lugar, use las clases Sheetn para tener acceso mediante programación a las hojas de cálculo del proyecto. Cada clase Sheetn deriva la mayoría de sus miembros de la clase Microsoft.Office.Tools.Excel.WorksheetBase. Esta clase redirige todas las llamadas a sus miembros a una implementación interna de la interfaz Microsoft.Office.Tools.Excel.Worksheet en Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office. Para obtener más información, vea Programar personalizaciones de nivel de documento.

Nota

Esta interfaz está implementada por el motor en tiempo de ejecución de Visual Studio Tools para Office. No está prevista su implementación en el código. Para obtener más información, vea Información general sobre el Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office.

Uso

Esta documentación describe la versión de este tipo que se utiliza en los proyectos de Office destinados a .NET Framework 4. En los proyectos destinados a .NET Framework 3.5, este tipo puede tener miembros diferentes y es posible que los ejemplos de código proporcionados para dicho tipo no funcionen. Para informarse sobre este tipo en los proyectos destinados a .NET Framework 3.5, vea la siguiente sección de referencia en la documentación de Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Vea también

Referencia

Microsoft.Office.Tools.Excel (Espacio de nombres)

Otros recursos

Información general sobre elementos y controles Host

Elemento host Worksheet