# C1.Data.DataSource.BaseControlHandler

## Content

<div class="doc-site-dotnet-api-container">



  <h1 id="C1_Data_DataSource_BaseControlHandler" data-uid="C1.Data.DataSource.BaseControlHandler" class="text-break">BaseControlHandler Class
</h1>
  <div class="markdown level0 summary"><p>A base class for control handlers that connect GUI controls of supported types to a C1DataSource so
that those controls can be given additional functionality such as
<a class="xref" href="C1.Data.DataSource.BaseControlHandler.AutoLookup.html#C1_Data_DataSource_BaseControlHandler_AutoLookup">auto-lookup columns</a> and
<a class="xref" href="C1.Data.DataSource.BaseControlHandler.VirtualMode.html#C1_Data_DataSource_BaseControlHandler_VirtualMode">virtual mode</a>.</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.windows.threading.dispatcherobject">DispatcherObject</a></div>
    <div class="level2"><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.windows.dependencyobject">DependencyObject</a></div>
    <div class="level3"><span class="xref">BaseControlHandler</span></div>
  </div>
  <div class="implements">
    <h5>Implements</h5>
    <div><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.idisposable">IDisposable</a></div>
    <div><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.componentmodel.isupportinitialize">ISupportInitialize</a></div>
  </div>
  <h6><strong>Namespace</strong>: <a class="xref" href="C1.Data.DataSource.html">C1.Data.DataSource</a></h6>
  <h6><strong>Assembly</strong>: C1.Data.Entity.4.8.dll</h6>
  <h5 id="C1_Data_DataSource_BaseControlHandler_syntax">Syntax</h5>
  <div class="codewrapper">
    <pre><code class="lang-csharp hljs">public abstract class BaseControlHandler : DependencyObject, IDisposable, ISupportInitialize</code></pre>
  </div>
  <div class="codewrapper">
    <pre><code class="lang-vbnet hljs">Public MustInherit Class BaseControlHandler
    Inherits DependencyObject
    Implements IDisposable, ISupportInitialize</code></pre>
  </div>
  <h5 id="C1_Data_DataSource_BaseControlHandler_remarks"><strong>Remarks</strong></h5>
  <div class="markdown level0 remarks"><p>Use platform-specific control handlers for your controls: C1.Win.Data.ControlHandler, 
C1.WPF.Data.ControlHandler, and C1.Silverlight.Data.ControlHandler.</p>
<p>The list of supported GUI controls for each platform can be found in the reference of that platform's ControlHandler.</p>
</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_Data_DataSource_BaseControlHandler__ctor" data-uid="C1.Data.DataSource.BaseControlHandler.#ctor">
          <a class="xref" href="C1.Data.DataSource.BaseControlHandler.-ctor.html#C1_Data_DataSource_BaseControlHandler__ctor">BaseControlHandler()</a>
        </td>
        <td class="markdown level1 summary"></td>
      </tr>
    </tbody>
  </table>
  <h3 id="fields">Fields
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="C1_Data_DataSource_BaseControlHandler_AutoLookupProperty" data-uid="C1.Data.DataSource.BaseControlHandler.AutoLookupProperty">
          <a class="xref" href="C1.Data.DataSource.BaseControlHandler.AutoLookupProperty.html">AutoLookupProperty</a>
        </td>
        <td class="markdown level1 summary"><p>The DependencyProperty for the <a class="xref" href="C1.Data.DataSource.BaseControlHandler.AutoLookup.html#C1_Data_DataSource_BaseControlHandler_AutoLookup">AutoLookup</a> property.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Data_DataSource_BaseControlHandler_VirtualModeProperty" data-uid="C1.Data.DataSource.BaseControlHandler.VirtualModeProperty">
          <a class="xref" href="C1.Data.DataSource.BaseControlHandler.VirtualModeProperty.html">VirtualModeProperty</a>
        </td>
        <td class="markdown level1 summary"><p>The DependencyProperty for the <a class="xref" href="C1.Data.DataSource.BaseControlHandler.VirtualMode.html#C1_Data_DataSource_BaseControlHandler_VirtualMode">VirtualMode</a> property.</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_Data_DataSource_BaseControlHandler_AutoLookup" data-uid="C1.Data.DataSource.BaseControlHandler.AutoLookup">
          <a class="xref" href="C1.Data.DataSource.BaseControlHandler.AutoLookup.html#C1_Data_DataSource_BaseControlHandler_AutoLookup">AutoLookup</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value indicating whether data grid columns bound to navigation (foreign key, lookup) properties
must be converted to combo box columns,
so the user can see the right value and edit it by choosing a value from a drop-down list. The default value is False.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Data_DataSource_BaseControlHandler_SupportsVirtualMode" data-uid="C1.Data.DataSource.BaseControlHandler.SupportsVirtualMode">
          <a class="xref" href="C1.Data.DataSource.BaseControlHandler.SupportsVirtualMode.html#C1_Data_DataSource_BaseControlHandler_SupportsVirtualMode">SupportsVirtualMode</a>
        </td>
        <td class="markdown level1 summary"><p>Gets a value indicating whether this <a class="xref" href="C1.Data.DataSource.BaseControlHandler.html">control handler</a> supports Virtual Mode.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Data_DataSource_BaseControlHandler_VirtualMode" data-uid="C1.Data.DataSource.BaseControlHandler.VirtualMode">
          <a class="xref" href="C1.Data.DataSource.BaseControlHandler.VirtualMode.html#C1_Data_DataSource_BaseControlHandler_VirtualMode">VirtualMode</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value indicating whether virtual mode specified in a <a class="xref" href="C1.Data.DataSource.ClientViewSource.html">ClientViewSource</a> is managed by this control handler.</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_Data_DataSource_BaseControlHandler_Apply" data-uid="C1.Data.DataSource.BaseControlHandler.Apply">
          <a class="xref" href="C1.Data.DataSource.BaseControlHandler.Apply.html#C1_Data_DataSource_BaseControlHandler_Apply">Apply()</a>
        </td>
        <td class="markdown level1 summary"><p>Forces this <a class="xref" href="C1.Data.DataSource.BaseControlHandler.html">control handler</a> to apply its settings to the current control.</p>
</td>
      </tr>
    </tbody>
  </table>

</div>