New to Telerik UI for WinForms? Start a free 30-day trial

PropertyGridSpreadExport is a powerful exporting API, allowing to export RadPropertyGrid to XLSX, PDF, CSV, and TXT format, utilizing the Document Processing Libraries.

Definition

Namespace:Telerik.WinControls.Export

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
public class PropertyGridSpreadExport

Inheritance: objectPropertyGridSpreadExport

Constructors

Initializes a new instance of the PropertyGridSpreadExport class.

C#
public PropertyGridSpreadExport(RadPropertyGrid radPropertyGrid, SpreadExportFormat exportFormat)
Parameters:radPropertyGridRadPropertyGrid

The RadPropertyGrid to export.

exportFormatSpreadExportFormat

The export format.

Initializes a new instance of the PropertyGridSpreadExport class.

C#
public PropertyGridSpreadExport(RadPropertyGrid radPropertyGrid)
Parameters:radPropertyGridRadPropertyGrid

The RadPropertyGrid to export.

Properties

Gets or sets a value indicating how children of collapsed items are exported.

C#
public HiddenOption CollapsedItemOption { get; set; }

Gets or sets a value indicating whether to export child items grouped.

C#
public bool ExportChildItemsGrouped { get; set; }

Gets or sets a value indicating whether to export item descriptions.

C#
public bool ExportDescriptions { get; set; }

Gets or sets the format of the exported file - XLSX, PDF, CSV, TXT or XLS.

C#
public SpreadExportFormat ExportFormat { get; set; }
Property Value:

The file extension.

Gets or sets a value indicating whether the visual settings should be exported.

C#
public bool ExportVisualSettings { get; set; }
Property Value:

true if visual settings are exported; otherwise, false.

Specifies how the file will be exported: as a new file, a new sheet in existing file or will override a sheet with given name.

C#
public FileExportMode FileExportMode { get; set; }
Property Value:

NewSheetInExistingFile - will add a new sheet to the specified file, if it exists CreateOrOverrideFile - will create/override the specified file CreateOrOverrideSheet - will create/override the specified sheet

Gets or sets the indent of child items.

C#
public int ItemIndent { get; set; }

Gets or sets the maximum number of rows per sheet.

C#
[CLSCompliant(false)]
public ExcelMaxRows SheetMaxRows { get; set; }
Property Value:

The sheet max rows.

Gets or sets the name of the sheet.

C#
public string SheetName { get; set; }
Property Value:

The name of the sheet.

Methods

Cancels an asynchronous export operation.

C#
public void CancelExportAsync()

Converts an image to the byte representation returned by ImageConverter.

C#
protected virtual byte[] ConvertImageToByteArray(Image image)
Parameters:imageImage

The image to convert.

Returns:

byte[]

The converted image bytes.

Writes the cell's content and, when enabled, its formatting into the specified worksheet position.

C#
protected virtual void CreateCell(PropertyGridSpreadExportCell cell, int currentRowIndex, int currentColumnIndex)
Parameters:cellPropertyGridSpreadExportCell

The cell whose content and formatting are exported.

currentRowIndexint

The zero-based worksheet row index.

currentColumnIndexint

The zero-based worksheet column index.

Copies the border style and colors from a visual cell into export-cell data.

C#
protected virtual void GetBordersFromVisualCell(PropertyGridSpreadExportCell cell, LightVisualElement visualCell)
Parameters:cellPropertyGridSpreadExportCell

The export cell that receives the border settings.

visualCellLightVisualElement

The visual cell whose border settings are copied.

Copies font, text alignment, wrapping, and colors from a visual cell into export-cell data.

C#
protected virtual void GetStylesFromVisualCell(PropertyGridSpreadExportCell cell, LightVisualElement visualCell)
Parameters:cellPropertyGridSpreadExportCell

The export cell that receives the styles.

visualCellLightVisualElement

The visual cell whose styles are copied.

Raises the event.

C#
protected virtual void OnAsyncExportCompleted(AsyncCompletedEventArgs e)
Parameters:eAsyncCompletedEventArgs

The AsyncCompletedEventArgs instance containing the event data.

Raises the event.

C#
protected virtual void OnAsyncExportProgressChanged(ProgressChangedEventArgs e)
Parameters:eProgressChangedEventArgs

The ProgressChangedEventArgs instance containing the event data.

Raises the event.

C#
protected virtual void OnCellFormatting(PropertyGridSpreadExportCellFormattingEventArgs e)
Parameters:ePropertyGridSpreadExportCellFormattingEventArgs

The PropertyGridSpreadExportCellFormattingEventArgs instance containing the event data.

Raises the event.

C#
protected virtual void OnExportCompleted(EventArgs e)
Parameters:eEventArgs

The EventArgs instance containing the event data.

Starts an export operation, in the specified sheet. If such sheet does not exist, it gets created.

C#
public void RunExport(Stream exportStream, ISpreadExportRenderer exportRenderer, string sheetName)
Parameters:exportStreamStream

The stream where data will be exported.

exportRendererISpreadExportRenderer

Instance of ISpreadExportRenderer class.

sheetNamestring

Name of the sheet.

Starts an export operation.

C#
public void RunExport(Stream exportStream, ISpreadExportRenderer exportRenderer)
Parameters:exportStreamStream

The stream where data will be exported.

exportRendererISpreadExportRenderer

Instance of ISpreadExportRenderer class.

Starts an export operation, in the specified sheet. If such sheet does not exist, it gets created.

C#
public void RunExport(string fileName, ISpreadExportRenderer exportRenderer, string sheetName)
Parameters:fileNamestring

The file name where data will be exported.

exportRendererISpreadExportRenderer

Instance of ISpreadExportRenderer class.

sheetNamestring

Name of the sheet.

Starts an export operation.

C#
public void RunExport(string fileName, ISpreadExportRenderer exportRenderer)
Parameters:fileNamestring

The file name where data will be exported.

exportRendererISpreadExportRenderer

Instance of ISpreadExportRenderer class.

Starts an async export operation, in the specified sheet. If such sheet does not exist, it gets created. Note that if ExportVisualSettings is true, collecting the visual styles from the RadPropertyGrid will still execute on the UI thread.

C#
public void RunExportAsync(Stream exportStream, ISpreadExportRenderer exportRenderer, string sheetName)
Parameters:exportStreamStream

The stream where data will be exported.

exportRendererISpreadExportRenderer

Instance of ISpreadExportRenderer class.

sheetNamestring

Name of the sheet.

Starts an export operation that runs in a background thread. Note that if ExportVisualSettings is true, collecting the visual styles from the RadPropertyGrid will still execute on the UI thread.

C#
public void RunExportAsync(Stream exportStream, ISpreadExportRenderer exportRenderer)
Parameters:exportStreamStream

The stream where data will be exported.

exportRendererISpreadExportRenderer

Instance of ISpreadExportRenderer class.

Starts an async export operation, in the specified sheet. If such sheet does not exist, it gets created. Note that if ExportVisualSettings is true, collecting the visual styles from the RadPropertyGrid will still execute on the UI thread.

C#
public void RunExportAsync(string fileName, ISpreadExportRenderer exportRenderer, string sheetName)
Parameters:fileNamestring

The file name where data will be exported.

exportRendererISpreadExportRenderer

Instance of ISpreadExportRenderer class.

sheetNamestring

Name of the sheet.

Starts an export operation that runs in a background thread. Note that if ExportVisualSettings is true, collecting the visual styles from the RadPropertyGrid will still execute on the UI thread.

C#
public void RunExportAsync(string fileName, ISpreadExportRenderer exportRenderer)
Parameters:fileNamestring

The file name where data will be exported.

exportRendererISpreadExportRenderer

Instance of ISpreadExportRenderer class.

Events

Occurs when an async export operation is completed.

C#
public event AsyncCompletedEventHandler AsyncExportCompleted

Occurs when the progress of an async export operation changes.

C#
public event ProgressChangedEventHandler AsyncExportProgressChanged

Occurs for every cell that is being exported.

C#
public event PropertyGridSpreadExportCellFormattingEventHandler CellFormatting

Occurs when the export process completes.

C#
public event EventHandler ExportCompleted