Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

How to: Load a Document into SpreadsheetControl

  • 2 minutes to read

To load an existing spreadsheet document (workbook) into SpreadsheetControl, use the SpreadsheetControl.LoadDocument method. Method overrides enable you to load a document from a file, a stream or a byte array.

Events related to document loading are listed in the table below.

Event Description
SpreadsheetControl.BeforeImport Occurs before a document is loaded.
SpreadsheetControl.DocumentLoaded Occurs when the document is loaded.
SpreadsheetControl.InvalidFormatException Occurs if the data you are trying to load has an incorrect format. You can subscribe to this event and perform actions required to resolve this situation (for example, inform an end-user about the incorrect file). This event fires if the WorkbookImportOptions.ThrowExceptionOnInvalidDocument property is true (use SpreadsheetControl.Options.Import.ThrowExceptionOnInvalidDocument notation).

#Load from File

Call the SpreadsheetControl.LoadDocument method with the file path to load a workbook from the existing file. Specify the file format as the second parameter of the method using the DocumentFormat enumerator.

// Load a workbook from a file.
workbook.LoadDocument("Documents\\Document.xlsx", DocumentFormat.Xlsx);

#Load from Stream

Create a FileStream object with the specified file path to open the existing file, and call the SpreadsheetControl.LoadDocument method with this stream object passed as a parameter. Specify the file format as the second parameter of the method using the DocumentFormat enumerator.

using System.IO;
using DevExpress.Spreadsheet;
// ...

// Load a workbook from a stream.
using (FileStream stream = new FileStream("Documents\\Document.xlsx", FileMode.Open)) {
    spreadsheetControl1.LoadDocument(stream, DocumentFormat.Xlsx);
}
See Also