Workbook

Workbook class

Représente un objet racine pour créer une feuille de calcul Excel.

public class Workbook : IDisposable

Constructeurs

NomLa description
Workbook()Initialise une nouvelle instance duWorkbook classe.
Workbook(FileFormatType)Initialise une nouvelle instance duWorkbook classe.
Workbook(Stream)Initialise une nouvelle instance duWorkbook classe et ouvrez un flux.
Workbook(string)Initialise une nouvelle instance duWorkbook classe et ouvrez un fichier.
Workbook(Stream, LoadOptions)Initialise une nouvelle instance duWorkbook classe et flux ouvert.
Workbook(string, LoadOptions)Initialise une nouvelle instance duWorkbook classe et ouvrez un fichier.

Propriétés

NomLa description
AbsolutePath { get; set; }Obtient et définit le chemin absolu du fichier.
BuiltInDocumentProperties { get; }Renvoie unDocumentPropertycollection qui représente toutes les propriétés de document intégrées de la feuille de calcul.
CellsDataTableFactory { get; }Obtient la fabrique pour construire ICellsDataTable à partir d’objets personnalisés
Colors { get; }Renvoie les couleurs dans la palette de la feuille de calcul.
ContentTypeProperties { get; }Obtient la liste desContentTypeProperty objets dans le classeur.
CountOfStylesInPool { get; }Obtient le nombre de styles dans le pool de styles.
CustomDocumentProperties { get; }Renvoie unDocumentProperty collection qui représente toutes les propriétés de document personnalisées de la feuille de calcul.
CustomXmlParts { get; }Représente une partie de stockage de données XML personnalisée (données XML personnalisées dans un package).
DataConnections { get; }Obtient leExternalConnection collection.
DataMashup { get; }Obtient les données de mashup.
DataSorter { get; }Obtient un objet DataSorter pour trier les données.
DefaultStyle { get; set; }Obtient ou définit la valeur par défautStyle objet du classeur.
FileFormat { get; set; }Obtient et définit le format de fichier.
FileName { get; set; }Obtient et définit le nom du fichier actuel.
HasMacro { get; }Indique si cette feuille de calcul contient macro/VBA.
HasRevisions { get; }Obtient si le classeur contient des modifications suivies
InterruptMonitor { get; set; }Obtient et définit le moniteur d’interruption.
IsDigitallySigned { get; }Indique si cette feuille de calcul est signée numériquement.
IsLicensed { get; }Indique si la licence est définie.
IsWorkbookProtectedWithPassword { get; }Indique si la structure ou la fenêtre est protégée par mot de passe.
RibbonXml { get; set; }Obtient et définit le fichier XML qui définit l’interface utilisateur du ruban.
Settings { get; }Représente les paramètres du classeur.
Theme { get; }Obtient le nom du thème.
VbaProject { get; }Obtient leVbaProject dans une feuille de calcul.
Worksheets { get; }Obtient leWorksheetCollection collection dans la feuille de calcul.

Méthodes

NomLa description
AcceptAllRevisions()Accepte toutes les modifications suivies dans le classeur.
AddDigitalSignature(DigitalSignatureCollection)Ajoute une signature numérique à un fichier de feuille de calcul OOXML (Excel2007 et versions ultérieures).
CalculateFormula()Calcule le résultat des formules.
CalculateFormula(bool)Calcule le résultat des formules.
CalculateFormula(CalculationOptions)Calcul des formules dans ce classeur.
ChangePalette(Color, int)Modifie la palette de la feuille de calcul dans l’index spécifié.
CloseAccessCache(AccessCacheOptions)Ferme la session qui utilise des caches pour accéder aux données.
Combine(Workbook)Combine un autre objet Workbook.
Copy(Workbook)Copie les données d’un objet Workbook source.
Copy(Workbook, CopyOptions)Copie les données d’un objet Workbook source.
CopyTheme(Workbook)Copie le thème d’un autre classeur.
CreateBuiltinStyle(BuiltinStyleType)Crée un style intégré par type donné.
CreateCellsColor()Crée unCellsColor objet.
CreateStyle()Crée un nouveau style.
CustomTheme(string, Color[])Personnalise le thème.
Dispose()Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation des ressources non gérées.
ExportXml(string, Stream)Exporter les données XML.
ExportXml(string, string)Exporter les données XML liées par le mappage XML spécifié.
GetDigitalSignature()Obtient la signature numérique du fichier.
GetFonts()Récupère toutes les polices du pool de styles.
GetMatchingColor(Color)Trouver la meilleure couleur correspondante dans la palette actuelle.
GetNamedStyle(string)Obtient le style nommé dans le pool de styles.
GetStyleInPool(int)Obtient le style dans le pool de styles. Tous les styles du classeur seront rassemblés dans un pool. Il n’y a qu’un simple index de référence dans les cellules.
GetThemeColor(ThemeColorType)Obtient la couleur du thème.
ImportXml(Stream, string, int, int)Importe/Met à jour un fichier de données XML dans le classeur.
ImportXml(string, string, int, int)Importe/Met à jour un fichier de données XML dans le classeur.
IsColorInPalette(Color)Vérifie si une couleur est dans la palette de la feuille de calcul.
ParseFormulas(bool)Analyse toutes les formules qui n’ont pas été analysées lorsqu’elles ont été chargées à partir d’un fichier de modèle ou définies dans une cellule.
Protect(ProtectionType, string)Protège un classeur.
ProtectSharedWorkbook(string)Protège un classeur partagé.
RefreshDynamicArrayFormulas(bool)Actualise les formules de tableau dynamique (se répand dans une nouvelle plage de cellules voisines en fonction des données actuelles)
RemoveDigitalSignature()Supprime la signature numérique de cette feuille de calcul.
RemoveMacro()Supprime VBA/macro de cette feuille de calcul.
RemovePersonalInformation()Supprime les informations personnelles.
RemoveUnusedStyles()Supprimer tous les styles inutilisés.
Replace(bool, object)Remplace les valeurs des cellules par de nouvelles données.
Replace(int, object)Remplace les valeurs des cellules par de nouvelles données.
Replace(string, DataTable)Remplace les valeurs des cellules par les données d’unDataTable .
Replace(string, double)Remplace la valeur d’une cellule par un nouveau double.
Replace(string, int)Remplace la valeur d’une cellule par un nouvel entier.
Replace(string, string)Remplace la valeur d’une cellule par une nouvelle chaîne.
Replace(string, double[], bool)Remplace les valeurs des cellules par un double tableau.
Replace(string, int[], bool)Remplace les valeurs des cellules par un tableau d’entiers.
Replace(string, string, ReplaceOptions)Remplace la valeur d’une cellule par une nouvelle chaîne.
Replace(string, string[], bool)Remplace la valeur d’une cellule par un nouveau tableau de chaînes.
Save(string)Enregistrez le classeur sur le disque.
Save(Stream, SaveFormat)Enregistre le classeur dans le flux.
Save(Stream, SaveOptions)Enregistre le classeur dans le flux.
Save(string, SaveFormat)Enregistre le classeur sur le disque.
Save(string, SaveOptions)Enregistre le classeur sur le disque.
Save(HttpResponse, string, ContentDisposition, SaveOptions)Crée la feuille de calcul des résultats et la transfère au client, puis l’ouvre dans le navigateur ou MS Workbook.
Save(HttpResponse, string, ContentDisposition, SaveOptions, bool)Crée la feuille de calcul des résultats et la transfère au client, puis l’ouvre dans le navigateur ou MS Workbook.
SaveToStream()Enregistre le fichier Excel dans un objet MemoryStream et le renvoie.
SetDigitalSignature(DigitalSignatureCollection)Définit la signature numérique d’un fichier de feuille de calcul (Excel2007 et versions ultérieures).
SetEncryptionOptions(EncryptionType, int)Définir les options de chiffrement.
SetThemeColor(ThemeColorType, Color)Définit la couleur du thème
StartAccessCache(AccessCacheOptions)Démarre la session qui utilise les caches pour accéder aux données.
Unprotect(string)Déprotége un classeur.
UnprotectSharedWorkbook(string)Déprotége un classeur partagé.
UpdateLinkedDataSource(Workbook[])Si ce classeur contient des liens externes vers d’autres sources de données, Aspose.Cells tentera de récupérer les dernières données.

Remarques

La classe Workbook désigne une feuille de calcul Excel. Chaque feuille de calcul peut contenir plusieurs feuilles de calcul. La fonctionnalité de base de la classe est d’ouvrir et d’enregistrer des fichiers Excel natifs. La classe possède des fonctionnalités avancées telles que la copie de données à partir d’autres classeurs, la combinaison de deux classeurs et la protection de la feuille de calcul Excel.

Exemples

L’exemple suivant charge un classeur à partir d’un fichier nommé designer.xls et rend les barres de défilement horizontales et verticales invisibles pour le classeur. Il remplace ensuite deux valeurs de chaîne par une valeur entière et une valeur de chaîne respectivement dans la feuille de calcul et envoie enfin le fichier mis à jour au navigateur client.

[C#]

//Ouvre un fichier de concepteur
string designerFile = "designer.xls";
Workbook workbook = new Workbook(designerFile);

//Définir les barres de défilement
workbook.Settings.IsHScrollBarVisible = false;
workbook.Settings.IsVScrollBarVisible = false;

//Remplacer la chaîne d'espace réservé par de nouvelles valeurs
int newInt = 100;
workbook.Replace("OldInt", newInt);

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

[Visual Basic]

'Ouvrir un fichier de concepteur
Dim designerFile as String = "\designer.xls"
Dim workbook as Workbook = new Workbook(designerFile)

'Définir des barres de défilement
workbook.IsHScrollBarVisible = False
workbook.IsVScrollBarVisible = False

'Remplacer la chaîne d'espace réservé par de nouvelles valeurs
Dim newInt as Integer = 100
workbook.Replace("OldInt", newInt)

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

Voir également