Worksheet (Interfaz)
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
Ensamblados: Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)
Microsoft.Office.Tools.Excel.v4.0.Utilities (en Microsoft.Office.Tools.Excel.v4.0.Utilities.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 | |
---|---|---|
_CodeName | Infraestructura. | |
_DisplayRightToLeft | Infraestructura. | |
Application | Esta propiedad obtiene un objeto Microsoft.Office.Interop.Excel.Application que representa la aplicación Microsoft Office Excel. | |
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. | |
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). | |
BindingContext | Obtiene o establece la colección de administradores de divisa de IBindableComponent. (Se hereda de IBindableComponent). | |
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). | |
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. | |
CodeName | Infraestructura. | |
Columns | Obtiene un objeto Range que representa una o más columnas en la hoja de cálculo. | |
Comments | Obtiene una colección Microsoft.Office.Interop.Excel.Comments que representa todos los comentarios para la hoja de cálculo. | |
ConsolidationFunction | Obtiene el código de función utilizado para la consolidación actual. | |
ConsolidationOptions | Obtiene una clase Array de tres elementos de opciones de consolidación. | |
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. | |
Controls | Obtiene la colección de controles administrados contenidos en la hoja de cálculo. | |
Creator | Obtiene un valor que indica la aplicación donde fue creada la hoja de cálculo. | |
CustomProperties | Obtiene un objeto Microsoft.Office.Interop.Excel.CustomProperties que representa la información del identificador asociado a una hoja de cálculo. | |
DataBindings | obtiene la colección de objetos de enlace de datos para este IBindableComponent. (Se hereda de IBindableComponent). | |
DataHost | Infraestructura. | |
DefaultExtension | Obtiene la extensión predeterminada de este objeto Worksheet. | |
DisplayAutomaticPageBreaks | Infraestructura. | |
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. | |
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. | |
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. | |
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. | |
EnableFormatConditionsCalculation | Obtiene o establece un valor que determina si los formatos condicionales se producirán automáticamente. | |
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. | |
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. | |
EnableSelection | Obtiene o establece un valor que indica qué celdas se pueden seleccionar en la hoja. | |
Extension | Obtiene una extensión personalizada de este objeto Worksheet. | |
FilterMode | Obtiene un valor que indica si la hoja de cálculo está filtrando activamente los datos. | |
HostContext | Infraestructura. | |
HPageBreaks | Obtiene una colección Microsoft.Office.Interop.Excel.HPageBreaks que representa los saltos de página horizontales de la hoja. | |
Hyperlinks | Obtiene una colección Microsoft.Office.Interop.Excel.Hyperlinks que representa los hipervínculos del rango u hoja de cálculo. | |
Index | Obtiene el número de índice de la hoja de cálculo en la colección de hojas de cálculo. | |
InnerObject | Obtiene un objeto Microsoft.Office.Interop.Excel.Worksheet que representa el objeto nativo subyacente de Worksheet. | |
ItemProvider | Infraestructura. | |
ListObjects | Obtiene una colección de los objetos Microsoft.Office.Interop.Excel.ListObject de la hoja de cálculo. | |
MailEnvelope | Obtiene un encabezado de correo electrónico para la hoja de cálculo. | |
Name | Obtiene o establece el nombre de la hoja de cálculo. | |
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!"). | |
Next | Obtiene un objeto Microsoft.Office.Interop.Excel.Worksheet que representa la hoja siguiente. | |
OnCalculate | Infraestructura. | |
OnData | Infraestructura. | |
OnDoubleClick | Infraestructura. | |
OnEntry | Infraestructura. | |
OnSheetActivate | Infraestructura. | |
OnSheetDeactivate | Infraestructura. | |
Outline | Obtiene un objeto Microsoft.Office.Interop.Excel.Outline que representa el esquema de la hoja de cálculo. | |
PageSetup | Obtiene un objeto Microsoft.Office.Interop.Excel.PageSetup que contiene toda la configuración de página de la hoja de cálculo. | |
Parent | Obtiene el objeto primario de la hoja de cálculo. | |
Previous | Obtiene un objeto Microsoft.Office.Interop.Excel.Worksheet que representa la hoja anterior. | |
PrintedCommentPages | Obtiene el número de páginas de comentarios que se van a imprimir para la hoja de cálculo actual. | |
ProtectContents | Obtiene un valor que indica si el contenido de la hoja de cálculo (las celdas individuales) está protegido. | |
ProtectDrawingObjects | Obtiene un valor que indica si las formas están protegidas. | |
Protection | Obtiene un objeto Microsoft.Office.Interop.Excel.Protection que representa las opciones de protección de la hoja de cálculo. | |
ProtectionMode | Obtiene un valor que indica si está activada la protección de sólo interfaz de usuario. | |
ProtectScenarios | Obtiene un valor que indica si los escenarios de la hoja de cálculo están protegidos. | |
QueryTables | Obtiene la colección Microsoft.Office.Interop.Excel.QueryTables que representa todas las tablas de consulta de la hoja de cálculo. | |
Range | Obtiene un objeto Microsoft.Office.Interop.Excel.Range que representa una celda o un rango de celdas. | |
Rows | Obtiene un objeto Range que representa una o más filas en la hoja de cálculo. | |
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. | |
ScrollArea | Obtiene o establece el rango donde se permite el desplazamiento, en una referencia de rango de estilo A1. | |
Shapes | Obtiene un objeto Microsoft.Office.Interop.Excel.Shapes que representa todas las formas de la hoja de cálculo. | |
Site | Obtiene o establece el ISite asociado a IComponent. (Se hereda de IComponent). | |
SmartTags | Obtiene un objeto Microsoft.Office.Interop.Excel.SmartTags que representa la colección de etiquetas inteligentes de la hoja de cálculo. | |
Sort | Obtiene los valores ordenados en la hoja de cálculo actual. | |
StandardHeight | Obtiene el alto estándar (valor predeterminado) de todas las filas de la hoja de cálculo, en puntos. | |
StandardWidth | Obtiene o establece la ancho estándar (valor predeterminado) de todas las columnas de la hoja de cálculo. | |
Tab | Obtiene un objeto Microsoft.Office.Interop.Excel.Tab para la hoja de cálculo. | |
Tag | Obtiene o establece el objeto que contiene datos sobre la hoja de cálculo. | |
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. | |
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. | |
Type | Obtiene el tipo de hoja de cálculo. | |
UsedRange | Obtiene un objeto Microsoft.Office.Interop.Excel.Range que representa todas las celdas que han contenido un valor en algún momento. | |
Visible | Obtiene o establece un valor Microsoft.Office.Interop.Excel.XlSheetVisibility que determina si el objeto es visible. | |
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 | |
---|---|---|
_CheckSpelling | Infraestructura. | |
_Evaluate | Infraestructura. | |
_PasteSpecial | Infraestructura. | |
_PrintOut | Infraestructura. | |
_Protect | Infraestructura. | |
_SaveAs | Infraestructura. | |
_VtblGap1_1 | ||
_VtblGap2_1 | ||
_VtblGap3_1 | ||
_VtblGap4_1 | ||
_VtblGap5_1 | ||
_VtblGap6_1 | ||
_VtblGap7_1 | ||
Activate | Establece la hoja actual como la hoja activa. | |
Arcs | Infraestructura. | |
BeginInit | Indica al objeto que está comenzando la inicialización. (Se hereda de ISupportInitialize). | |
Buttons | Infraestructura. | |
CalculateMethod | Calcula las fórmulas de la hoja de cálculo. | |
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. | |
CheckBoxes | Infraestructura. | |
CheckSpelling | Comprueba la ortografía en una hoja de cálculo. | |
CircleInvalid | Rodea con un círculo las entradas no válidas en la hoja de cálculo. | |
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. | |
ClearCircles | Borra los círculos de las entradas no válidas en la hoja de cálculo. | |
Copy | Copia la hoja de cálculo a otra ubicación del libro. | |
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. | |
Dispose | Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Se hereda de IDisposable). | |
DrawingObjects | Infraestructura. | |
Drawings | Infraestructura. | |
DropDowns | Infraestructura. | |
EndInit | Indica al objeto que se ha completado la inicialización. (Se hereda de ISupportInitialize). | |
Evaluate | Convierte un nombre de Microsoft Office Excel en un objeto o un valor. | |
ExportAsFixedFormat | Exporta a un archivo del formato especificado. | |
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. | |
GroupBoxes | Infraestructura. | |
GroupObjects | Infraestructura. | |
Labels | Infraestructura. | |
Lines | Infraestructura. | |
ListBoxes | Infraestructura. | |
Move | Mueve la hoja de cálculo a otra ubicación del libro. | |
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. | |
OptionButtons | Infraestructura. | |
Ovals | Infraestructura. | |
Paste | Pega el contenido del Portapapeles en la hoja de cálculo. | |
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. | |
Pictures | Infraestructura. | |
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. | |
PivotTableWizard | Crea un objeto Microsoft.Office.Interop.Excel.PivotTable. | |
PrintOut | Imprime la hoja de cálculo. | |
PrintOutEx | Imprime la hoja de cálculo. | |
PrintPreview | Muestra una vista previa de la hoja de cálculo tal como aparecerá cuando se imprima. | |
Protect | Protege una hoja de cálculo para que no se pueda modificar. | |
Rectangles | Infraestructura. | |
ResetAllPageBreaks | Restablece todos los saltos de página de la hoja de cálculo especificada. | |
SaveAs | Guarda los cambios de la hoja de cálculo en un archivo diferente. | |
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. | |
ScrollBars | Infraestructura. | |
Select | Selecciona la hoja de cálculo. | |
SetBackgroundPicture | Establece el gráfico de fondo de la hoja de cálculo. | |
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". | |
ShowDataForm | Muestra el formulario de datos asociado a la hoja de cálculo. | |
Spinners | Infraestructura. | |
TextBoxes | Infraestructura. | |
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. | |
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. | |
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 | |
---|---|---|
ActivateEvent | Se produce cuando se activa la hoja de cálculo. | |
BeforeDoubleClick | Se produce cuando se hace doble clic en la hoja de cálculo, antes de ejecutarse la acción de doble clic predeterminada. | |
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. | |
BindingContextChanged | Infraestructura. | |
Calculate | Se produce después de volver a calcular la hoja de cálculo. | |
Change | Se produce cuando tiene lugar algún cambio en las celdas de Worksheet. | |
Deactivate | Se produce cuando la hoja de cálculo pierde el foco. | |
Disposed | Representa el método que controla el evento Disposed de un componente. (Se hereda de IComponent). | |
FollowHyperlink | Este evento se produce al hacer clic en un hipervínculo de una hoja de cálculo. | |
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). | |
PivotTableBeforeAllocateChanges | Se produce antes de que se apliquen los cambios a una tabla dinámica. | |
PivotTableBeforeCommitChanges | Se produce antes de confirmar los cambios realizados en una tabla dinámica en el origen de datos OLAP. | |
PivotTableBeforeDiscardChanges | Se produce antes de que se descarten los cambios realizados en una tabla dinámica. | |
PivotTableChangeSync | Se produce después de realizar cambios en una tabla dinámica. | |
PivotTableUpdate | Se produce después de actualizar un informe de tabla dinámica en una hoja de cálculo. | |
SelectionChange | Se produce cuando cambia la selección en una hoja de cálculo. | |
Shutdown | Se produce cuando se cierra el elemento host de la hoja de cálculo. | |
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:
Propiedad Controls.Use esta propiedad para agregar controles administrados a una hoja de cálculo de Excel o para quitar controles, en tiempo de ejecución.
Propiedad InnerObject.Use esta propiedad para obtener el objeto Microsoft.Office.Interop.Excel.Worksheet subyacente de un elemento host Microsoft.Office.Tools.Excel.Worksheet.
Los eventos en el nivel de hoja de cálculo, como ActivateEvent y Change, que solo se proporcionan en el nivel de la aplicación en el modelo de objetos de Excel.Es decir, en el modelo de objetos de Excel, estos eventos se definen en la clase Microsoft.Office.Interop.Excel.Application y no en la interfaz Microsoft.Office.Interop.Excel.Worksheet.
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 Runtime 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 Runtime de Microsoft 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
En esta documentación se describe la versión de este tipo que se usa en los proyectos de Office destinados a .NET Framework 4 y .NET Framework 4.5. En los proyectos destinados a .NET Framework 3.5, este tipo podría tener unos miembros diferentes y los ejemplos de código de este tipo podrían no funcionar. 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)