# ExcelOpenDocumentConversionExtensions

Explicit conversions between OfficeIMO Excel and native OpenDocument spreadsheet models.

Class 

`OfficeIMO.Excel.OpenDocument`

**Namespace**

`OfficeIMO.Excel.OpenDocument`

**Assembly**

`OfficeIMO.Excel.OpenDocument`

**Source revision**

`ba882f6b0d07` with working tree changes

**Source**

[ExcelOpenDocumentConversionExtensions.Conversion.cs:10](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Excel.OpenDocument/ExcelOpenDocumentConversionExtensions.Conversion.cs#L10)

**Modifiers**

static

Explicit conversions between OfficeIMO Excel and native OpenDocument spreadsheet models.

## Inheritance

- object
- ExcelOpenDocumentConversionExtensions

Filter members 

Show inherited

## Methods

SaveAsExcel 2 overloads

`public static OfficeConversionReport SaveAsExcel(OdsDocument source, string path, ExcelOpenDocumentConversionOptions? options = null, CancellationToken cancellationToken = default)` [#](#method-saveasexcel-officeimo-opendocument-odsdocument-string-officeimo-excel-opendocument-excelopendocumentconversionoptions-threading-cancellationtoken)

[ExcelOpenDocumentConversionExtensions.Conversion.cs:95](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Excel.OpenDocument/ExcelOpenDocumentConversionExtensions.Conversion.cs#L95)

Writes the converted output to a path and returns the conversion report.

Parameters

**source OfficeIMO.OpenDocument.OdsDocument required**

**path string required**

**options OfficeIMO.Excel.OpenDocument.ExcelOpenDocumentConversionOptions? = null optional**

**cancellationToken System.Threading.CancellationToken = default optional**

Returns

`OfficeConversionReport`

`public static OfficeConversionReport SaveAsExcel(OdsDocument source, Stream stream, ExcelOpenDocumentConversionOptions? options = null, CancellationToken cancellationToken = default)` [#](#method-saveasexcel-officeimo-opendocument-odsdocument-io-stream-officeimo-excel-opendocument-excelopendocumentconversionoptions-threading-cancellationtoken)

[ExcelOpenDocumentConversionExtensions.Conversion.cs:102](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Excel.OpenDocument/ExcelOpenDocumentConversionExtensions.Conversion.cs#L102)

Writes the converted output to a caller-owned stream, which stays open and returns the conversion report.

Parameters

**source OfficeIMO.OpenDocument.OdsDocument required**

**stream System.IO.Stream required**

**options OfficeIMO.Excel.OpenDocument.ExcelOpenDocumentConversionOptions? = null optional**

**cancellationToken System.Threading.CancellationToken = default optional**

Returns

`OfficeConversionReport`

SaveAsExcelAsync 2 overloads

`public static async Task<OfficeConversionReport> SaveAsExcelAsync(OdsDocument source, string path, ExcelOpenDocumentConversionOptions? options = null, CancellationToken cancellationToken = default)` [#](#method-saveasexcelasync-officeimo-opendocument-odsdocument-string-officeimo-excel-opendocument-excelopendocumentconversionoptions-threading-cancellationtoken)

Asynchronously writes the converted output to a path and returns the conversion report.

Parameters

**source OfficeIMO.OpenDocument.OdsDocument required**

**path string required**

**options OfficeIMO.Excel.OpenDocument.ExcelOpenDocumentConversionOptions? = null optional**

**cancellationToken System.Threading.CancellationToken = default optional**

Returns

`Task<OfficeConversionReport>`

`public static async Task<OfficeConversionReport> SaveAsExcelAsync(OdsDocument source, Stream stream, ExcelOpenDocumentConversionOptions? options = null, CancellationToken cancellationToken = default)` [#](#method-saveasexcelasync-officeimo-opendocument-odsdocument-io-stream-officeimo-excel-opendocument-excelopendocumentconversionoptions-threading-cancellationtoken)

Asynchronously writes the converted output to a caller-owned stream and returns the conversion report.

Parameters

**source OfficeIMO.OpenDocument.OdsDocument required**

**stream System.IO.Stream required**

**options OfficeIMO.Excel.OpenDocument.ExcelOpenDocumentConversionOptions? = null optional**

**cancellationToken System.Threading.CancellationToken = default optional**

Returns

`Task<OfficeConversionReport>`

SaveAsOpenDocument 2 overloads

`public static OfficeConversionReport SaveAsOpenDocument(ExcelDocument source, string path, ExcelOpenDocumentConversionOptions? options = null, CancellationToken cancellationToken = default)` [#](#method-saveasopendocument-officeimo-excel-exceldocument-string-officeimo-excel-opendocument-excelopendocumentconversionoptions-threading-cancellationtoken)

[ExcelOpenDocumentConversionExtensions.Conversion.cs:34](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Excel.OpenDocument/ExcelOpenDocumentConversionExtensions.Conversion.cs#L34)

Writes the converted output to a path and returns the conversion report.

Parameters

**source OfficeIMO.Excel.ExcelDocument required**

**path string required**

**options OfficeIMO.Excel.OpenDocument.ExcelOpenDocumentConversionOptions? = null optional**

**cancellationToken System.Threading.CancellationToken = default optional**

Returns

`OfficeConversionReport`

`public static OfficeConversionReport SaveAsOpenDocument(ExcelDocument source, Stream stream, ExcelOpenDocumentConversionOptions? options = null, CancellationToken cancellationToken = default)` [#](#method-saveasopendocument-officeimo-excel-exceldocument-io-stream-officeimo-excel-opendocument-excelopendocumentconversionoptions-threading-cancellationtoken)

[ExcelOpenDocumentConversionExtensions.Conversion.cs:41](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Excel.OpenDocument/ExcelOpenDocumentConversionExtensions.Conversion.cs#L41)

Writes the converted output to a caller-owned stream, which stays open and returns the conversion report.

Parameters

**source OfficeIMO.Excel.ExcelDocument required**

**stream System.IO.Stream required**

**options OfficeIMO.Excel.OpenDocument.ExcelOpenDocumentConversionOptions? = null optional**

**cancellationToken System.Threading.CancellationToken = default optional**

Returns

`OfficeConversionReport`

SaveAsOpenDocumentAsync 2 overloads

`public static async Task<OfficeConversionReport> SaveAsOpenDocumentAsync(ExcelDocument source, string path, ExcelOpenDocumentConversionOptions? options = null, CancellationToken cancellationToken = default)` [#](#method-saveasopendocumentasync-officeimo-excel-exceldocument-string-officeimo-excel-opendocument-excelopendocumentconversionoptions-threading-cancellationtoken)

Asynchronously writes the converted output to a path and returns the conversion report.

Parameters

**source OfficeIMO.Excel.ExcelDocument required**

**path string required**

**options OfficeIMO.Excel.OpenDocument.ExcelOpenDocumentConversionOptions? = null optional**

**cancellationToken System.Threading.CancellationToken = default optional**

Returns

`Task<OfficeConversionReport>`

`public static async Task<OfficeConversionReport> SaveAsOpenDocumentAsync(ExcelDocument source, Stream stream, ExcelOpenDocumentConversionOptions? options = null, CancellationToken cancellationToken = default)` [#](#method-saveasopendocumentasync-officeimo-excel-exceldocument-io-stream-officeimo-excel-opendocument-excelopendocumentconversionoptions-threading-cancellationtoken)

Asynchronously writes the converted output to a caller-owned stream and returns the conversion report.

Parameters

**source OfficeIMO.Excel.ExcelDocument required**

**stream System.IO.Stream required**

**options OfficeIMO.Excel.OpenDocument.ExcelOpenDocumentConversionOptions? = null optional**

**cancellationToken System.Threading.CancellationToken = default optional**

Returns

`Task<OfficeConversionReport>`

ToExcel 2 overloads

`public static ExcelDocument ToExcel(OdsDocument source, ExcelOpenDocumentConversionOptions? options = null, CancellationToken cancellationToken = default)` [#](#method-toexcel-officeimo-opendocument-odsdocument-officeimo-excel-opendocument-excelopendocumentconversionoptions-threading-cancellationtoken)

[ExcelOpenDocumentConversionExtensions.Conversion.cs:71](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Excel.OpenDocument/ExcelOpenDocumentConversionExtensions.Conversion.cs#L71)

Converts an ODS spreadsheet to an in-memory workbook; the LossPolicy option rejects loss.

Parameters

**source OfficeIMO.OpenDocument.OdsDocument required**

**options OfficeIMO.Excel.OpenDocument.ExcelOpenDocumentConversionOptions? = null optional**

**cancellationToken System.Threading.CancellationToken = default optional**

Returns

`ExcelDocument`

`public static ExcelDocument ToExcel(OdsDocument source, ExcelOpenDocumentConversionOptions? options, out OfficeConversionReport report, CancellationToken cancellationToken = default)` [#](#method-toexcel-officeimo-opendocument-odsdocument-officeimo-excel-opendocument-excelopendocumentconversionoptions-officeimo-officeconversionreport-threading-cancellationtoken)

[ExcelOpenDocumentConversionExtensions.Conversion.cs:76](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Excel.OpenDocument/ExcelOpenDocumentConversionExtensions.Conversion.cs#L76)

Converts an ODS spreadsheet to an in-memory workbook; the LossPolicy option rejects loss and returns the completed conversion report.

Parameters

**source OfficeIMO.OpenDocument.OdsDocument required**

**options OfficeIMO.Excel.OpenDocument.ExcelOpenDocumentConversionOptions? required**

**report OfficeIMO.OfficeConversionReport required**

**cancellationToken System.Threading.CancellationToken = default optional**

Returns

`ExcelDocument`

`public static Task<OfficeConversionResult<ExcelDocument>> ToExcelAsync(OdsDocument source, ExcelOpenDocumentConversionOptions? options = null, CancellationToken cancellationToken = default)` [#](#method-toexcelasync-officeimo-opendocument-odsdocument-officeimo-excel-opendocument-excelopendocumentconversionoptions-threading-cancellationtoken)

[ExcelOpenDocumentConversionExtensions.Conversion.cs:88](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Excel.OpenDocument/ExcelOpenDocumentConversionExtensions.Conversion.cs#L88)

Converts an ODS spreadsheet to an in-memory workbook; the LossPolicy option rejects loss, returning the value and report together.

Parameters

**source OfficeIMO.OpenDocument.OdsDocument required**

**options OfficeIMO.Excel.OpenDocument.ExcelOpenDocumentConversionOptions? = null optional**

**cancellationToken System.Threading.CancellationToken = default optional**

Returns

`Task<OfficeConversionResult<ExcelDocument>>`

ToOpenDocument 2 overloads

`public static OdsDocument ToOpenDocument(ExcelDocument source, ExcelOpenDocumentConversionOptions? options = null, CancellationToken cancellationToken = default)` [#](#method-toopendocument-officeimo-excel-exceldocument-officeimo-excel-opendocument-excelopendocumentconversionoptions-threading-cancellationtoken)

[ExcelOpenDocumentConversionExtensions.Conversion.cs:10](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Excel.OpenDocument/ExcelOpenDocumentConversionExtensions.Conversion.cs#L10)

Converts a workbook to an in-memory ODS spreadsheet; the LossPolicy option rejects loss.

Parameters

**source OfficeIMO.Excel.ExcelDocument required**

**options OfficeIMO.Excel.OpenDocument.ExcelOpenDocumentConversionOptions? = null optional**

**cancellationToken System.Threading.CancellationToken = default optional**

Returns

`OdsDocument`

`public static OdsDocument ToOpenDocument(ExcelDocument source, ExcelOpenDocumentConversionOptions? options, out OfficeConversionReport report, CancellationToken cancellationToken = default)` [#](#method-toopendocument-officeimo-excel-exceldocument-officeimo-excel-opendocument-excelopendocumentconversionoptions-officeimo-officeconversionreport-threading-cancellationtoken)

[ExcelOpenDocumentConversionExtensions.Conversion.cs:15](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Excel.OpenDocument/ExcelOpenDocumentConversionExtensions.Conversion.cs#L15)

Converts a workbook to an in-memory ODS spreadsheet; the LossPolicy option rejects loss and returns the completed conversion report.

Parameters

**source OfficeIMO.Excel.ExcelDocument required**

**options OfficeIMO.Excel.OpenDocument.ExcelOpenDocumentConversionOptions? required**

**report OfficeIMO.OfficeConversionReport required**

**cancellationToken System.Threading.CancellationToken = default optional**

Returns

`OdsDocument`

`public static Task<OfficeConversionResult<OdsDocument>> ToOpenDocumentAsync(ExcelDocument source, ExcelOpenDocumentConversionOptions? options = null, CancellationToken cancellationToken = default)` [#](#method-toopendocumentasync-officeimo-excel-exceldocument-officeimo-excel-opendocument-excelopendocumentconversionoptions-threading-cancellationtoken)

[ExcelOpenDocumentConversionExtensions.Conversion.cs:27](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Excel.OpenDocument/ExcelOpenDocumentConversionExtensions.Conversion.cs#L27)

Converts a workbook to an in-memory ODS spreadsheet; the LossPolicy option rejects loss, returning the value and report together.

Parameters

**source OfficeIMO.Excel.ExcelDocument required**

**options OfficeIMO.Excel.OpenDocument.ExcelOpenDocumentConversionOptions? = null optional**

**cancellationToken System.Threading.CancellationToken = default optional**

Returns

`Task<OfficeConversionResult<OdsDocument>>`

## Inherited Methods

`public virtual bool Equals(object? obj)` [#](#method-equals-object)

Inherited from object

Parameters

**obj object? required**

Returns

`bool`

`public virtual int GetHashCode()` [#](#method-gethashcode)

Inherited from object

Returns

`int`

`public Type GetType()` [#](#method-gettype)

Inherited from object

Returns

`Type`

`public virtual string? ToString()` [#](#method-tostring)

Inherited from object

Returns

`string?`

<!-- PowerForge markdown artifact sha256:4FFC1988C32C581C9BAD29AFCFA003040F2B178ABCE0DD341B8A45EB122C658D -->
