# C1.WPF.Excel.C1XLBook

## Content

<div class="doc-site-dotnet-api-container">



  <h1 id="C1_WPF_Excel_C1XLBook" data-uid="C1.WPF.Excel.C1XLBook" class="text-break">C1XLBook Class
</h1>
  <div class="markdown level0 summary"><pre><code>&lt;p&gt;Represents an Excel workbook containing one or more worksheets.&lt;/p&gt;
&lt;p&gt;Contains methods for loading and saving XLS files, and exposes
</code></pre>
<p>a collection of <a class="xref" href="C1.WPF.Excel.XLSheet.html">XLSheet</a> objects that represent the individual
worksheets.</p>
</div>
  <div class="markdown level0 conceptual"></div>
  <div class="inheritance">
    <h5>Inheritance</h5>
    <div class="level0"><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.object">object</a></div>
    <div class="level1"><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.marshalbyrefobject">MarshalByRefObject</a></div>
    <div class="level2"><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.componentmodel.component">Component</a></div>
    <div class="level3"><span class="xref">C1XLBook</span></div>
  </div>
  <div class="implements">
    <h5>Implements</h5>
    <div><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.componentmodel.icomponent">IComponent</a></div>
    <div><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.idisposable">IDisposable</a></div>
    <div><a class="xref" href="C1.WPF.Excel.ICloneable.html">ICloneable</a></div>
  </div>
  <h6><strong>Namespace</strong>: <a class="xref" href="C1.WPF.Excel.html">C1.WPF.Excel</a></h6>
  <h6><strong>Assembly</strong>: C1.WPF.Excel.4.6.2.dll</h6>
  <h5 id="C1_WPF_Excel_C1XLBook_syntax">Syntax</h5>
  <div class="codewrapper">
    <pre><code class="lang-csharp hljs">[Obsolete(&quot;This library is obsolete. Please use C1.Excel for .NET Standard instead.&quot;)]
public class C1XLBook : Component, IComponent, IDisposable, ICloneable</code></pre>
  </div>
  <div class="codewrapper">
    <pre><code class="lang-vbnet hljs">&lt;Obsolete(&quot;This library is obsolete. Please use C1.Excel for .NET Standard instead.&quot;)&gt;
Public Class C1XLBook
    Inherits Component
    Implements IComponent, IDisposable, ICloneable</code></pre>
  </div>
  <h3 id="constructors">Constructors
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook__ctor" data-uid="C1.WPF.Excel.C1XLBook.#ctor">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.-ctor.html#C1_WPF_Excel_C1XLBook__ctor">C1XLBook()</a>
        </td>
        <td class="markdown level1 summary"><p>Creates a new instance of the <a class="xref" href="C1.WPF.Excel.C1XLBook.html">C1XLBook</a> class. The
new workbook contains a single empty <a class="xref" href="C1.WPF.Excel.XLSheet.html">XLSheet</a> called &quot;Sheet1&quot;.</p>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="properties">Properties
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_Author" data-uid="C1.WPF.Excel.C1XLBook.Author">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.Author.html#C1_WPF_Excel_C1XLBook_Author">Author</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the name of the person, company, or application that created this <a class="xref" href="C1.WPF.Excel.C1XLBook.html">C1XLBook</a>.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_CalculationMode" data-uid="C1.WPF.Excel.C1XLBook.CalculationMode">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.CalculationMode.html#C1_WPF_Excel_C1XLBook_CalculationMode">CalculationMode</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the formula calculation mode.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_CompatibilityMode" data-uid="C1.WPF.Excel.C1XLBook.CompatibilityMode">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.CompatibilityMode.html#C1_WPF_Excel_C1XLBook_CompatibilityMode">CompatibilityMode</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value determining the limits on sheet size and the number of styles allowed per workbook.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_DefaultFont" data-uid="C1.WPF.Excel.C1XLBook.DefaultFont">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.DefaultFont.html#C1_WPF_Excel_C1XLBook_DefaultFont">DefaultFont</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the default font object for the <a class="xref" href="C1.WPF.Excel.C1XLBook.html">C1XLBook</a>.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_IsLoading" data-uid="C1.WPF.Excel.C1XLBook.IsLoading">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.IsLoading.html#C1_WPF_Excel_C1XLBook_IsLoading">IsLoading</a>
        </td>
        <td class="markdown level1 summary"><p>Determines whether the workbook is currently loading.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_KeepFormulas" data-uid="C1.WPF.Excel.C1XLBook.KeepFormulas">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.KeepFormulas.html#C1_WPF_Excel_C1XLBook_KeepFormulas">KeepFormulas</a>
        </td>
        <td class="markdown level1 summary"><p>Specifies whether the component should store formulas read from XLS/XLSX files
and write them back when saving the file.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_ListSeparator" data-uid="C1.WPF.Excel.C1XLBook.ListSeparator">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.ListSeparator.html#C1_WPF_Excel_C1XLBook_ListSeparator">ListSeparator</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a list separator that used for CSV-data, by default used the list separator in the Windows system.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_NamedRanges" data-uid="C1.WPF.Excel.C1XLBook.NamedRanges">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.NamedRanges.html#C1_WPF_Excel_C1XLBook_NamedRanges">NamedRanges</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the collection of <a class="xref" href="C1.WPF.Excel.XLNamedRange.html">XLNamedRange</a> objects for the current workbook.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_OpaqueCopy" data-uid="C1.WPF.Excel.C1XLBook.OpaqueCopy">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.OpaqueCopy.html#C1_WPF_Excel_C1XLBook_OpaqueCopy">OpaqueCopy</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value specifying whether the component should copy non-main BIFF records as opaque when loading and saving XLS files.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_Palette" data-uid="C1.WPF.Excel.C1XLBook.Palette">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.Palette.html#C1_WPF_Excel_C1XLBook_Palette">Palette</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets color palette of this workbook.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_ReferenceMode" data-uid="C1.WPF.Excel.C1XLBook.ReferenceMode">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.ReferenceMode.html#C1_WPF_Excel_C1XLBook_ReferenceMode">ReferenceMode</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets reference mode of this workbook.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_Sheets" data-uid="C1.WPF.Excel.C1XLBook.Sheets">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.Sheets.html#C1_WPF_Excel_C1XLBook_Sheets">Sheets</a>
        </td>
        <td class="markdown level1 summary"><p>Gets a collection of <a class="xref" href="C1.WPF.Excel.XLSheet.html">XLSheet</a> objects that represent
the worksheets in the <a class="xref" href="C1.WPF.Excel.C1XLBook.html">C1XLBook</a>.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_UseDefaultCsvEncoding" data-uid="C1.WPF.Excel.C1XLBook.UseDefaultCsvEncoding">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.UseDefaultCsvEncoding.html#C1_WPF_Excel_C1XLBook_UseDefaultCsvEncoding">UseDefaultCsvEncoding</a>
        </td>
        <td class="markdown level1 summary"><p>Specifies whether the component should use the default encoding for CSV files.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_UseTempStorage" data-uid="C1.WPF.Excel.C1XLBook.UseTempStorage">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.UseTempStorage.html#C1_WPF_Excel_C1XLBook_UseTempStorage">UseTempStorage</a>
        </td>
        <td class="markdown level1 summary"><p>Specifies whether the component should use temporary storage at saving to XLSX/XSLT files for minimization used memory.</p>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="methods">Methods
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_Clear" data-uid="C1.WPF.Excel.C1XLBook.Clear">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.Clear.html#C1_WPF_Excel_C1XLBook_Clear">Clear()</a>
        </td>
        <td class="markdown level1 summary"><p>Clears the <a class="xref" href="C1.WPF.Excel.C1XLBook.html">C1XLBook</a>, restoring the initial state with a single
<a class="xref" href="C1.WPF.Excel.XLSheet.html">XLSheet</a> called &quot;Sheet1&quot;.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_ClearOpaqueData" data-uid="C1.WPF.Excel.C1XLBook.ClearOpaqueData">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.ClearOpaqueData.html#C1_WPF_Excel_C1XLBook_ClearOpaqueData">ClearOpaqueData()</a>
        </td>
        <td class="markdown level1 summary"><p>Clears the <a class="xref" href="C1.WPF.Excel.C1XLBook.html">C1XLBook</a> opaque data.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_Clone" data-uid="C1.WPF.Excel.C1XLBook.Clone">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.Clone.html#C1_WPF_Excel_C1XLBook_Clone">Clone()</a>
        </td>
        <td class="markdown level1 summary"><p>Creates a copy of this C1Excel book.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_GetRtf_System_Collections_Generic_KeyValuePair_System_String_C1_WPF_Excel_XLFont____" data-uid="C1.WPF.Excel.C1XLBook.GetRtf(System.Collections.Generic.KeyValuePair{System.String,C1.WPF.Excel.XLFont}[])">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.GetRtf.html#C1_WPF_Excel_C1XLBook_GetRtf_System_Collections_Generic_KeyValuePair_System_String_C1_WPF_Excel_XLFont____">GetRtf(params KeyValuePair&lt;string, XLFont&gt;[])</a>
        </td>
        <td class="markdown level1 summary"><p>Gets RTF code for pairs text and font.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_Load_System_IO_Stream_" data-uid="C1.WPF.Excel.C1XLBook.Load(System.IO.Stream)">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.Load.html#C1_WPF_Excel_C1XLBook_Load_System_IO_Stream_">Load(Stream)</a>
        </td>
        <td class="markdown level1 summary"><p>Loads the worksheet from a stream.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_Load_System_IO_Stream_C1_WPF_Excel_FileFormat_" data-uid="C1.WPF.Excel.C1XLBook.Load(System.IO.Stream,C1.WPF.Excel.FileFormat)">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.Load.html#C1_WPF_Excel_C1XLBook_Load_System_IO_Stream_C1_WPF_Excel_FileFormat_">Load(Stream, FileFormat)</a>
        </td>
        <td class="markdown level1 summary"><p>Loads the worksheet from a stream.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_Load_System_IO_Stream_C1_WPF_Excel_FileFormat_System_Boolean_" data-uid="C1.WPF.Excel.C1XLBook.Load(System.IO.Stream,C1.WPF.Excel.FileFormat,System.Boolean)">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.Load.html#C1_WPF_Excel_C1XLBook_Load_System_IO_Stream_C1_WPF_Excel_FileFormat_System_Boolean_">Load(Stream, FileFormat, bool)</a>
        </td>
        <td class="markdown level1 summary"><p>Loads the worksheet from a stream.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_Load_System_IO_Stream_System_Boolean_" data-uid="C1.WPF.Excel.C1XLBook.Load(System.IO.Stream,System.Boolean)">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.Load.html#C1_WPF_Excel_C1XLBook_Load_System_IO_Stream_System_Boolean_">Load(Stream, bool)</a>
        </td>
        <td class="markdown level1 summary"><p>Loads the worksheet from a stream.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_Load_System_String_" data-uid="C1.WPF.Excel.C1XLBook.Load(System.String)">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.Load.html#C1_WPF_Excel_C1XLBook_Load_System_String_">Load(string)</a>
        </td>
        <td class="markdown level1 summary"><p>Loads an Excel worksheet from a file.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_Load_System_String_C1_WPF_Excel_FileFormat_" data-uid="C1.WPF.Excel.C1XLBook.Load(System.String,C1.WPF.Excel.FileFormat)">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.Load.html#C1_WPF_Excel_C1XLBook_Load_System_String_C1_WPF_Excel_FileFormat_">Load(string, FileFormat)</a>
        </td>
        <td class="markdown level1 summary"><p>Loads an Excel worksheet from a file.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_Load_System_String_C1_WPF_Excel_FileFormat_System_Boolean_" data-uid="C1.WPF.Excel.C1XLBook.Load(System.String,C1.WPF.Excel.FileFormat,System.Boolean)">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.Load.html#C1_WPF_Excel_C1XLBook_Load_System_String_C1_WPF_Excel_FileFormat_System_Boolean_">Load(string, FileFormat, bool)</a>
        </td>
        <td class="markdown level1 summary"><p>Loads an Excel worksheet from a file.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_Load_System_String_System_Boolean_" data-uid="C1.WPF.Excel.C1XLBook.Load(System.String,System.Boolean)">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.Load.html#C1_WPF_Excel_C1XLBook_Load_System_String_System_Boolean_">Load(string, bool)</a>
        </td>
        <td class="markdown level1 summary"><p>Loads an Excel worksheet from a file.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_PixelsToTwips_System_Double_" data-uid="C1.WPF.Excel.C1XLBook.PixelsToTwips(System.Double)">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.PixelsToTwips.html#C1_WPF_Excel_C1XLBook_PixelsToTwips_System_Double_">PixelsToTwips(double)</a>
        </td>
        <td class="markdown level1 summary"><p>Converts a pixel measurement into twips (1/20th of a point).</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_Save_System_IO_Stream_" data-uid="C1.WPF.Excel.C1XLBook.Save(System.IO.Stream)">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.Save.html#C1_WPF_Excel_C1XLBook_Save_System_IO_Stream_">Save(Stream)</a>
        </td>
        <td class="markdown level1 summary"><p>Saves the worksheet into a stream.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_Save_System_IO_Stream_C1_WPF_Excel_FileFormat_" data-uid="C1.WPF.Excel.C1XLBook.Save(System.IO.Stream,C1.WPF.Excel.FileFormat)">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.Save.html#C1_WPF_Excel_C1XLBook_Save_System_IO_Stream_C1_WPF_Excel_FileFormat_">Save(Stream, FileFormat)</a>
        </td>
        <td class="markdown level1 summary"><p>Saves the worksheet into a stream.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_Save_System_String_" data-uid="C1.WPF.Excel.C1XLBook.Save(System.String)">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.Save.html#C1_WPF_Excel_C1XLBook_Save_System_String_">Save(string)</a>
        </td>
        <td class="markdown level1 summary"><p>Saves the worksheet to a file.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_Save_System_String_C1_WPF_Excel_FileFormat_" data-uid="C1.WPF.Excel.C1XLBook.Save(System.String,C1.WPF.Excel.FileFormat)">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.Save.html#C1_WPF_Excel_C1XLBook_Save_System_String_C1_WPF_Excel_FileFormat_">Save(string, FileFormat)</a>
        </td>
        <td class="markdown level1 summary"><p>Saves the worksheet to a file.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_SetDpi_System_Single_System_Single_" data-uid="C1.WPF.Excel.C1XLBook.SetDpi(System.Single,System.Single)">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.SetDpi.html#C1_WPF_Excel_C1XLBook_SetDpi_System_Single_System_Single_">SetDpi(float, float)</a>
        </td>
        <td class="markdown level1 summary"><p>Sets horizontal and vertical DPI.</p>
</td>
      </tr>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_TwipsToPixels_System_Double_" data-uid="C1.WPF.Excel.C1XLBook.TwipsToPixels(System.Double)">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.TwipsToPixels.html#C1_WPF_Excel_C1XLBook_TwipsToPixels_System_Double_">TwipsToPixels(double)</a>
        </td>
        <td class="markdown level1 summary"><p>Converts a twips measurement into screen pixels.</p>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="events">Events
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="C1_WPF_Excel_C1XLBook_Progress" data-uid="C1.WPF.Excel.C1XLBook.Progress">
          <a class="xref" href="C1.WPF.Excel.C1XLBook.Progress.html">Progress</a>
        </td>
        <td class="markdown level1 summary"><p>Fired while data is being read from or written into a workbook.</p>
</td>
      </tr>
    </tbody>
  </table>

</div>
