Workbook

Workbook class

Representa un objeto raíz para crear una hoja de cálculo de Excel.

public class Workbook : IDisposable

Constructores

NombreDescripción
Workbook()Inicializa una nueva instancia delWorkbook clase.
Workbook(FileFormatType)Inicializa una nueva instancia delWorkbook clase.
Workbook(Stream)Inicializa una nueva instancia delWorkbook class y abre un stream.
Workbook(string)Inicializa una nueva instancia delWorkbook clase y abra un archivo.
Workbook(Stream, LoadOptions)Inicializa una nueva instancia delWorkbook clase y flujo abierto.
Workbook(string, LoadOptions)Inicializa una nueva instancia delWorkbook clase y abra un archivo.

Propiedades

NombreDescripción
AbsolutePath { get; set; }Obtiene y establece la ruta absoluta del archivo.
BuiltInDocumentProperties { get; }Devuelve unDocumentPropertycolección que representa todas las propiedades de documento integradas de la hoja de cálculo.
CellsDataTableFactory { get; }Obtiene la fábrica para construir ICellsDataTable a partir de objetos personalizados
Colors { get; }Devuelve los colores de la paleta de la hoja de cálculo.
ContentTypeProperties { get; }Obtiene la lista deContentTypeProperty objetos en el libro de trabajo.
CountOfStylesInPool { get; }Obtiene el número de estilos en el grupo de estilos.
CustomDocumentProperties { get; }Devuelve unDocumentProperty colección que representa todas las propiedades del documento personalizado de la hoja de cálculo.
CustomXmlParts { get; }Representa una parte de almacenamiento de datos XML personalizados (datos XML personalizados dentro de un paquete).
DataConnections { get; }Obtiene elExternalConnection colección.
DataMashup { get; }Obtiene datos de mashup.
DataSorter { get; }Obtiene un objeto DataSorter para ordenar datos.
DefaultStyle { get; set; }Obtiene o establece el valor predeterminadoStyle objeto del libro.
FileFormat { get; set; }Obtiene y establece el formato del archivo.
FileName { get; set; }Obtiene y establece el nombre del archivo actual.
HasMacro { get; }Indica si esta hoja de cálculo contiene macro/VBA.
HasRevisions { get; }Obtiene si el libro de trabajo tiene cambios rastreados
InterruptMonitor { get; set; }Obtiene y establece el monitor de interrupción.
IsDigitallySigned { get; }Indica si esta hoja de cálculo está firmada digitalmente.
IsLicensed { get; }Indica si la licencia está configurada.
IsWorkbookProtectedWithPassword { get; }Indica si la estructura o ventana está protegida con contraseña.
RibbonXml { get; set; }Obtiene y establece el archivo XML que define la interfaz de usuario de Ribbon.
Settings { get; }Representa la configuración del libro.
Theme { get; }Obtiene el nombre del tema.
VbaProject { get; }Obtiene elVbaProject en una hoja de cálculo.
Worksheets { get; }Obtiene elWorksheetCollection colección en la hoja de cálculo.

Métodos

NombreDescripción
AcceptAllRevisions()Acepta todos los cambios registrados en el libro de trabajo.
AddDigitalSignature(DigitalSignatureCollection)Agrega una firma digital a un archivo de hoja de cálculo OOXML (Excel 2007 y posterior).
CalculateFormula()Calcula el resultado de fórmulas.
CalculateFormula(bool)Calcula el resultado de fórmulas.
CalculateFormula(CalculationOptions)Cálculo de fórmulas en este libro.
ChangePalette(Color, int)Cambia la paleta de la hoja de cálculo en el índice especificado.
CloseAccessCache(AccessCacheOptions)Cierra la sesión que usa cachés para acceder a los datos.
Combine(Workbook)Combina otro objeto Workbook.
Copy(Workbook)Copia datos de un objeto de libro de trabajo de origen.
Copy(Workbook, CopyOptions)Copia datos de un objeto de libro de trabajo de origen.
CopyTheme(Workbook)Copia el tema de otro libro.
CreateBuiltinStyle(BuiltinStyleType)Crea un estilo incorporado por tipo dado.
CreateCellsColor()Crea unCellsColor objeto.
CreateStyle()Crea un nuevo estilo.
CustomTheme(string, Color[])Personaliza el tema.
Dispose()Realiza tareas definidas por la aplicación asociadas con la liberación, liberación o restablecimiento de recursos no administrados.
ExportXml(string, Stream)Exportar datos XML.
ExportXml(string, string)Exportar datos XML vinculados por el mapa XML especificado.
GetDigitalSignature()Obtiene la firma digital del archivo.
GetFonts()Obtiene todas las fuentes en el grupo de estilos.
GetMatchingColor(Color)Encuentra el mejor color coincidente en la paleta actual.
GetNamedStyle(string)Obtiene el estilo con nombre en el grupo de estilos.
GetStyleInPool(int)Obtiene el estilo en el grupo de estilos. Todos los estilos del libro de trabajo se reunirán en un grupo. Solo hay un índice de referencia simple en las celdas.
GetThemeColor(ThemeColorType)Obtiene el color del tema.
ImportXml(Stream, string, int, int)Importa/Actualiza un archivo de datos XML en el libro de trabajo.
ImportXml(string, string, int, int)Importa/Actualiza un archivo de datos XML en el libro de trabajo.
IsColorInPalette(Color)Comprueba si un color está en la paleta de la hoja de cálculo.
ParseFormulas(bool)Analiza todas las fórmulas que no se analizaron cuando se cargaron desde un archivo de plantilla o se establecieron en una celda.
Protect(ProtectionType, string)Protege un libro de trabajo.
ProtectSharedWorkbook(string)Protege un libro de trabajo compartido.
RefreshDynamicArrayFormulas(bool)Actualiza las fórmulas de matrices dinámicas (se derrama en un nuevo rango de celdas vecinas según los datos actuales)
RemoveDigitalSignature()Elimina la firma digital de esta hoja de cálculo.
RemoveMacro()Elimina VBA/macro de esta hoja de cálculo.
RemovePersonalInformation()Elimina información personal.
RemoveUnusedStyles()Eliminar todos los estilos no utilizados.
Replace(bool, object)Reemplaza los valores de las celdas con nuevos datos.
Replace(int, object)Reemplaza los valores de las celdas con nuevos datos.
Replace(string, DataTable)Reemplaza los valores de las celdas con datos de unDataTable .
Replace(string, double)Reemplaza el valor de una celda con un nuevo doble.
Replace(string, int)Reemplaza el valor de una celda con un nuevo entero.
Replace(string, string)Reemplaza el valor de una celda con una nueva cadena.
Replace(string, double[], bool)Reemplaza los valores de las celdas con una matriz doble.
Replace(string, int[], bool)Reemplaza los valores de las celdas con una matriz de enteros.
Replace(string, string, ReplaceOptions)Reemplaza el valor de una celda con una nueva cadena.
Replace(string, string[], bool)Reemplaza el valor de una celda con una nueva matriz de cadenas.
Save(string)Guarde el libro de trabajo en el disco.
Save(Stream, SaveFormat)Guarda el libro de trabajo en la secuencia.
Save(Stream, SaveOptions)Guarda el libro de trabajo en la secuencia.
Save(string, SaveFormat)Guarda el libro de trabajo en el disco.
Save(string, SaveOptions)Guarda el libro de trabajo en el disco.
Save(HttpResponse, string, ContentDisposition, SaveOptions)Crea la hoja de cálculo de resultados y la transfiere al cliente y luego la abre en el navegador o en MS Workbook.
Save(HttpResponse, string, ContentDisposition, SaveOptions, bool)Crea la hoja de cálculo de resultados y la transfiere al cliente y luego la abre en el navegador o en MS Workbook.
SaveToStream()Guarda el archivo de Excel en un objeto MemoryStream y lo devuelve.
SetDigitalSignature(DigitalSignatureCollection)Establece la firma digital en un archivo de hoja de cálculo (Excel 2007 y posterior).
SetEncryptionOptions(EncryptionType, int)Establecer opciones de cifrado.
SetThemeColor(ThemeColorType, Color)Establece el color del tema
StartAccessCache(AccessCacheOptions)Inicia la sesión que utiliza cachés para acceder a los datos.
Unprotect(string)Desprotege un libro.
UnprotectSharedWorkbook(string)Desprotege un libro de trabajo compartido.
UpdateLinkedDataSource(Workbook[])Si este libro de trabajo contiene enlaces externos a otra fuente de datos, Aspose.Cells intentará recuperar los datos más recientes.

Observaciones

La clase Workbook denota una hoja de cálculo de Excel. Cada hoja de cálculo puede contener varias hojas de trabajo. La función básica de la clase es abrir y guardar archivos nativos de Excel. La clase tiene algunas funciones avanzadas, como copiar datos de otros libros de trabajo, combinar dos libros de trabajo y proteger la hoja de cálculo de Excel.

Ejemplos

El siguiente ejemplo carga un libro de trabajo desde un archivo llamado designer.xls y hace que las barras de desplazamiento horizontal y vertical sean invisibles para el libro de trabajo. Luego reemplaza dos valores de cadena con un valor entero y un valor de cadena respectivamente dentro de la hoja de cálculo y finalmente envía el archivo actualizado al navegador del cliente.

[C#]

//Abrir un archivo de diseñador
string designerFile = "designer.xls";
Workbook workbook = new Workbook(designerFile);

//Establecer barras de desplazamiento
workbook.Settings.IsHScrollBarVisible = false;
workbook.Settings.IsVScrollBarVisible = false;

//Reemplazar la cadena de marcador de posición con nuevos valores
int newInt = 100;
workbook.Replace("OldInt", newInt);

string newString = "Hello!";
workbook.Replace("OldString", newString);
workbook.Save("result.xls");

[Visual Basic]

'Abrir un archivo de diseñador
Dim designerFile as String = "\designer.xls"
Dim workbook as Workbook = new Workbook(designerFile)

'Establecer barras de desplazamiento
workbook.IsHScrollBarVisible = False
workbook.IsVScrollBarVisible = False

'Reemplace la cadena de marcador de posición con nuevos valores
Dim newInt as Integer = 100
workbook.Replace("OldInt", newInt)

Dim newString as String = "Hello!"
workbook.Replace("OldString", newString)
workbook.Save("result.xls")    

Ver también