Workbook

Workbook class

Repräsentiert ein Stammobjekt zum Erstellen einer Excel-Tabelle.

public class Workbook : IDisposable

Konstrukteure

NameBeschreibung
Workbook()Initialisiert eine neue Instanz vonWorkbook Klasse.
Workbook(FileFormatType)Initialisiert eine neue Instanz vonWorkbook Klasse.
Workbook(Stream)Initialisiert eine neue Instanz vonWorkbook Klasse und öffne einen Stream.
Workbook(string)Initialisiert eine neue Instanz vonWorkbook Klasse und öffnen Sie eine Datei.
Workbook(Stream, LoadOptions)Initialisiert eine neue Instanz vonWorkbook Klasse und offener Stream.
Workbook(string, LoadOptions)Initialisiert eine neue Instanz vonWorkbook Klasse und öffnen Sie eine Datei.

Eigenschaften

NameBeschreibung
AbsolutePath { get; set; }Holt und setzt den absoluten Pfad der Datei.
BuiltInDocumentProperties { get; }Gibt a zurückDocumentPropertySammlung, die alle integrierten Dokumenteigenschaften der Tabelle darstellt.
CellsDataTableFactory { get; }Ruft die Factory zum Erstellen von ICellsDataTable aus benutzerdefinierten Objekten ab
Colors { get; }Gibt Farben in der Palette für die Tabelle zurück.
ContentTypeProperties { get; }Ruft die Liste von abContentTypeProperty Objekte in der Arbeitsmappe.
CountOfStylesInPool { get; }Ruft die Anzahl der Styles im Style-Pool ab.
CustomDocumentProperties { get; }Gibt a zurückDocumentProperty Sammlung, die alle benutzerdefinierten Dokumenteigenschaften der Tabelle darstellt.
CustomXmlParts { get; }Repräsentiert einen benutzerdefinierten XML-Datenspeicherteil (benutzerdefinierte XML-Daten innerhalb eines Pakets).
DataConnections { get; }Ruft die abExternalConnection Sammlung.
DataMashup { get; }Ruft Mashup-Daten ab.
DataSorter { get; }Ruft ein DataSorter-Objekt ab, um Daten zu sortieren.
DefaultStyle { get; set; }Ruft den Standardwert ab oder legt ihn festStyle Objekt der Arbeitsmappe.
FileFormat { get; set; }Ruft das Dateiformat ab und legt es fest.
FileName { get; set; }Holt und setzt den aktuellen Dateinamen.
HasMacro { get; }Gibt an, ob diese Tabelle Makros/VBA enthält.
HasRevisions { get; }Ruft ab, ob die Arbeitsmappe nachverfolgte Änderungen aufweist
InterruptMonitor { get; set; }Holt und setzt den Interrupt-Monitor.
IsDigitallySigned { get; }Gibt an, ob diese Tabelle digital signiert ist.
IsLicensed { get; }Zeigt an, ob die Lizenz gesetzt ist.
IsWorkbookProtectedWithPassword { get; }Zeigt an, ob die Struktur oder das Fenster mit einem Passwort geschützt ist.
RibbonXml { get; set; }Ruft die XML-Datei ab und legt sie fest, die die Multifunktionsleisten-Benutzeroberfläche definiert.
Settings { get; }Stellt die Arbeitsmappeneinstellungen dar.
Theme { get; }Ruft den Themennamen ab.
VbaProject { get; }Ruft die abVbaProject in einer Tabelle.
Worksheets { get; }Ruft die abWorksheetCollection Sammlung in der Tabelle.

Methoden

NameBeschreibung
AcceptAllRevisions()Akzeptiert alle nachverfolgten Änderungen in der Arbeitsmappe.
AddDigitalSignature(DigitalSignatureCollection)Fügt einer OOXML-Tabellenkalkulationsdatei (Excel2007 und höher) eine digitale Signatur hinzu.
CalculateFormula()Berechnet das Ergebnis von Formeln.
CalculateFormula(bool)Berechnet das Ergebnis von Formeln.
CalculateFormula(CalculationOptions)Formeln in dieser Arbeitsmappe berechnen.
ChangePalette(Color, int)Ändert die Palette für die Tabelle im angegebenen Index.
CloseAccessCache(AccessCacheOptions)Schließt die Sitzung, die Caches verwendet, um auf Daten zuzugreifen.
Combine(Workbook)Kombiniert ein anderes Workbook-Objekt.
Copy(Workbook)Kopiert Daten aus einem Arbeitsmappen-Quellobjekt.
Copy(Workbook, CopyOptions)Kopiert Daten aus einem Arbeitsmappen-Quellobjekt.
CopyTheme(Workbook)Kopiert das Design aus einer anderen Arbeitsmappe.
CreateBuiltinStyle(BuiltinStyleType)Erstellt einen integrierten Stil nach gegebenem Typ.
CreateCellsColor()Erstellt einCellsColor Objekt.
CreateStyle()Erstellt einen neuen Stil.
CustomTheme(string, Color[])Passt das Thema an.
Dispose()Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen nicht verwalteter Ressourcen verbunden sind.
ExportXml(string, Stream)XML-Daten exportieren.
ExportXml(string, string)XML-Daten exportieren, die durch die angegebene XML-Zuordnung verknüpft sind.
GetDigitalSignature()Ruft digitale Signatur aus Datei ab.
GetFonts()Ruft alle Schriftarten im Style-Pool ab.
GetMatchingColor(Color)Finden Sie die am besten passende Farbe in der aktuellen Palette.
GetNamedStyle(string)Ruft den benannten Stil im Stilpool ab.
GetStyleInPool(int)Holt den Stil in den Stilpool. Alle Stile in der Arbeitsmappe werden in einem Pool gesammelt. Es gibt nur einen einfachen Referenzindex in den Zellen.
GetThemeColor(ThemeColorType)Ruft Designfarbe ab.
ImportXml(Stream, string, int, int)Importiert/aktualisiert eine XML-Datendatei in die Arbeitsmappe.
ImportXml(string, string, int, int)Importiert/aktualisiert eine XML-Datendatei in die Arbeitsmappe.
IsColorInPalette(Color)Überprüft, ob eine Farbe in der Palette für die Tabelle enthalten ist.
ParseFormulas(bool)Analysiert alle Formeln, die nicht analysiert wurden, als sie aus der Vorlagendatei geladen oder in eine Zelle gesetzt wurden.
Protect(ProtectionType, string)Schützt eine Arbeitsmappe.
ProtectSharedWorkbook(string)Schützt eine freigegebene Arbeitsmappe.
RefreshDynamicArrayFormulas(bool)Aktualisiert dynamische Array-Formeln (Überlauf in einen neuen Bereich benachbarter Zellen gemäß den aktuellen Daten)
RemoveDigitalSignature()Entfernt die digitale Signatur aus dieser Tabelle.
RemoveMacro()Entfernt VBA/Makro aus dieser Tabelle.
RemovePersonalInformation()Entfernt persönliche Informationen.
RemoveUnusedStyles()Entfernen Sie alle nicht verwendeten Stile.
Replace(bool, object)Ersetzt die Werte der Zellen durch neue Daten.
Replace(int, object)Ersetzt die Werte der Zellen durch neue Daten.
Replace(string, DataTable)Ersetzt die Werte der Zellen durch Daten aus aDataTable .
Replace(string, double)Ersetzt den Wert einer Zelle durch ein neues Double.
Replace(string, int)Ersetzt den Wert einer Zelle durch eine neue Ganzzahl.
Replace(string, string)Ersetzt den Wert einer Zelle durch eine neue Zeichenfolge.
Replace(string, double[], bool)Ersetzt die Werte der Zellen durch ein doppeltes Array.
Replace(string, int[], bool)Ersetzt die Werte der Zellen durch ein Integer-Array.
Replace(string, string, ReplaceOptions)Ersetzt den Wert einer Zelle durch eine neue Zeichenfolge.
Replace(string, string[], bool)Ersetzt den Wert einer Zelle durch ein neues String-Array.
Save(string)Speichern Sie die Arbeitsmappe auf der Festplatte.
Save(Stream, SaveFormat)Speichert die Arbeitsmappe im Stream.
Save(Stream, SaveOptions)Speichert die Arbeitsmappe im Stream.
Save(string, SaveFormat)Speichert die Arbeitsmappe auf der Festplatte.
Save(string, SaveOptions)Speichert die Arbeitsmappe auf der Festplatte.
Save(HttpResponse, string, ContentDisposition, SaveOptions)Erstellt die Ergebnistabelle und überträgt sie an den Client, öffnet sie dann im Browser oder in MS Workbook.
Save(HttpResponse, string, ContentDisposition, SaveOptions, bool)Erstellt die Ergebnistabelle und überträgt sie an den Client, öffnet sie dann im Browser oder in MS Workbook.
SaveToStream()Speichert eine Excel-Datei in einem MemoryStream-Objekt und gibt sie zurück.
SetDigitalSignature(DigitalSignatureCollection)Setzt eine digitale Signatur auf eine Tabellenkalkulationsdatei (Excel2007 und höher).
SetEncryptionOptions(EncryptionType, int)Verschlüsselungsoptionen festlegen.
SetThemeColor(ThemeColorType, Color)Legt die Designfarbe fest
StartAccessCache(AccessCacheOptions)Startet die Sitzung, die Caches verwendet, um auf Daten zuzugreifen.
Unprotect(string)Hebt den Schutz einer Arbeitsmappe auf.
UnprotectSharedWorkbook(string)Hebt den Schutz einer freigegebenen Arbeitsmappe auf.
UpdateLinkedDataSource(Workbook[])Wenn diese Arbeitsmappe externe Links zu anderen Datenquellen enthält, wird Aspose.Cells versuchen, die neuesten Daten abzurufen.

Bemerkungen

Die Workbook-Klasse bezeichnet eine Excel-Tabelle. Jede Tabelle kann mehrere Arbeitsblätter enthalten. Die grundlegende Funktion der Klasse besteht darin, native Excel-Dateien zu öffnen und zu speichern. Die Klasse verfügt über einige erweiterte Funktionen wie das Kopieren von Daten aus anderen Arbeitsmappen, das Kombinieren von zwei Arbeitsmappen und das Schützen der Excel-Tabelle.

Beispiele

Das folgende Beispiel lädt eine Arbeitsmappe aus einer Datei namens designer.xls und macht die horizontalen und vertikalen Bildlaufleisten für die Arbeitsmappe unsichtbar. Es ersetzt dann zwei String-Werte durch einen Integer-Wert bzw. einen String-Wert innerhalb der Tabelle und sendet schließlich die aktualisierte Datei an den Client-Browser.

[C#]

//Öffne eine Designer-Datei
string designerFile = "designer.xls";
Workbook workbook = new Workbook(designerFile);

//Bildlaufleisten setzen
workbook.Settings.IsHScrollBarVisible = false;
workbook.Settings.IsVScrollBarVisible = false;

//Ersetzen Sie die Platzhalterzeichenfolge durch neue Werte
int newInt = 100;
workbook.Replace("OldInt", newInt);

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

[Visual Basic]

ffnen Sie eine Designerdatei
Dim designerFile as String = "\designer.xls"
Dim workbook as Workbook = new Workbook(designerFile)

'Bildlaufleisten einstellen
workbook.IsHScrollBarVisible = False
workbook.IsVScrollBarVisible = False

'Ersetzen Sie die Platzhalterzeichenfolge durch neue Werte
Dim newInt as Integer = 100
workbook.Replace("OldInt", newInt)

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

Siehe auch