# GrapeCity.ActiveReports.Data.DbDataSource

## Content

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



  <h1 id="GrapeCity_ActiveReports_Data_DbDataSource" data-uid="GrapeCity.ActiveReports.Data.DbDataSource" class="text-break">DbDataSource Class
</h1>
  <div class="markdown level0 summary"><p>DB data source - allows to connect through custom database providers.</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"><span class="xref">DbDataSource</span></div>
      <div class="level2"><a class="xref" href="GrapeCity.ActiveReports.Data.OdbcDataSource.html">OdbcDataSource</a></div>
      <div class="level2"><a class="xref" href="GrapeCity.ActiveReports.Data.OleDBDataSource.html">OleDBDataSource</a></div>
      <div class="level2"><a class="xref" href="GrapeCity.ActiveReports.Data.SqlDBDataSource.html">SqlDBDataSource</a></div>
  </div>
  <div class="implements">
    <h5>Implements</h5>
    <div><a class="xref" href="GrapeCity.ActiveReports.Data.IDbConnectionProperties.html">IDbConnectionProperties</a></div>
  </div>
  <h6><strong>Namespace</strong>: <a class="xref" href="GrapeCity.ActiveReports.Data.html">GrapeCity.ActiveReports.Data</a></h6>
  <h6><strong>Assembly</strong>: MESCIUS.ActiveReports.dll</h6>
  <h5 id="GrapeCity_ActiveReports_Data_DbDataSource_syntax">Syntax</h5>
  <div class="codewrapper">
    <pre><code class="lang-csharp hljs">[TypeConverter(&quot;GrapeCity.ActiveReports.Design.ArDesigner.TypeEditors.DataSourceTypeConverter, MESCIUS.ActiveReports.Design.Win, Version=20.1.2.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff&quot;)]
public class DbDataSource : IDbConnectionProperties</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="GrapeCity_ActiveReports_Data_DbDataSource__ctor_GrapeCity_ActiveReports_Configuration_DataProviderInfo_" data-uid="GrapeCity.ActiveReports.Data.DbDataSource.#ctor(GrapeCity.ActiveReports.Configuration.DataProviderInfo)">
          <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.-ctor.html#GrapeCity_ActiveReports_Data_DbDataSource__ctor_GrapeCity_ActiveReports_Configuration_DataProviderInfo_">DbDataSource(DataProviderInfo)</a>
        </td>
        <td class="markdown level1 summary"><p>Creates new DbDataSource out of DataProviderInfo</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_ActiveReports_Data_DbDataSource__ctor_System_Data_Common_DbProviderFactory_" data-uid="GrapeCity.ActiveReports.Data.DbDataSource.#ctor(System.Data.Common.DbProviderFactory)">
          <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.-ctor.html#GrapeCity_ActiveReports_Data_DbDataSource__ctor_System_Data_Common_DbProviderFactory_">DbDataSource(DbProviderFactory)</a>
        </td>
        <td class="markdown level1 summary"><p>Creates new DbDataSource out of DbProviderFactory</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_ActiveReports_Data_DbDataSource__ctor_System_String_" data-uid="GrapeCity.ActiveReports.Data.DbDataSource.#ctor(System.String)">
          <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.-ctor.html#GrapeCity_ActiveReports_Data_DbDataSource__ctor_System_String_">DbDataSource(string)</a>
        </td>
        <td class="markdown level1 summary"><p>Initializes a new instance of the <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.html">DbDataSource</a> class based on the specified provider name.</p>
</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="GrapeCity_ActiveReports_Data_DbDataSource_DefaultTimeout" data-uid="GrapeCity.ActiveReports.Data.DbDataSource.DefaultTimeout">
          <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.DefaultTimeout.html">DefaultTimeout</a>
        </td>
        <td class="markdown level1 summary"><p>The number of seconds to wait for a connection to open, before cancelling an attempt and generate an error.</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="GrapeCity_ActiveReports_Data_DbDataSource_CommandText" data-uid="GrapeCity.ActiveReports.Data.DbDataSource.CommandText">
          <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.CommandText.html#GrapeCity_ActiveReports_Data_DbDataSource_CommandText">CommandText</a>
        </td>
        <td class="markdown level1 summary"><p>Specifies a valid SQL statement used to retrieve records from the data source.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_ActiveReports_Data_DbDataSource_CommandTimeout" data-uid="GrapeCity.ActiveReports.Data.DbDataSource.CommandTimeout">
          <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.CommandTimeout.html#GrapeCity_ActiveReports_Data_DbDataSource_CommandTimeout">CommandTimeout</a>
        </td>
        <td class="markdown level1 summary"><p>Sets or returns the amount of time to wait while executing a command before terminating the attempt and generating an error.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_ActiveReports_Data_DbDataSource_ConnectionString" data-uid="GrapeCity.ActiveReports.Data.DbDataSource.ConnectionString">
          <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.ConnectionString.html#GrapeCity_ActiveReports_Data_DbDataSource_ConnectionString">ConnectionString</a>
        </td>
        <td class="markdown level1 summary"><p>Specifies the string used to open a connection to the data source.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_ActiveReports_Data_DbDataSource_CredentialsMode" data-uid="GrapeCity.ActiveReports.Data.DbDataSource.CredentialsMode">
          <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.CredentialsMode.html#GrapeCity_ActiveReports_Data_DbDataSource_CredentialsMode">CredentialsMode</a>
        </td>
        <td class="markdown level1 summary"><p>Get or sets the value indicating whether the credentials dialog should be called or not.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_ActiveReports_Data_DbDataSource_Factory" data-uid="GrapeCity.ActiveReports.Data.DbDataSource.Factory">
          <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.Factory.html#GrapeCity_ActiveReports_Data_DbDataSource_Factory">Factory</a>
        </td>
        <td class="markdown level1 summary"><p>Gets data source's DbProviderFactory.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_ActiveReports_Data_DbDataSource_ParamQuery" data-uid="GrapeCity.ActiveReports.Data.DbDataSource.ParamQuery">
          <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.ParamQuery.html#GrapeCity_ActiveReports_Data_DbDataSource_ParamQuery">ParamQuery</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the parameterized query string, equivalent to <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.CommandText.html#GrapeCity_ActiveReports_Data_DbDataSource_CommandText">CommandText</a>.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_ActiveReports_Data_DbDataSource_ProviderName" data-uid="GrapeCity.ActiveReports.Data.DbDataSource.ProviderName">
          <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.ProviderName.html#GrapeCity_ActiveReports_Data_DbDataSource_ProviderName">ProviderName</a>
        </td>
        <td class="markdown level1 summary"><p>Returns provider's invariant name</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_ActiveReports_Data_DbDataSource_SQL" data-uid="GrapeCity.ActiveReports.Data.DbDataSource.SQL">
          <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.SQL.html#GrapeCity_ActiveReports_Data_DbDataSource_SQL">SQL</a>
        </td>
        <td class="markdown level1 summary"><p>Specifies a valid SQL statement used to retrieve records from the data source.</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="GrapeCity_ActiveReports_Data_DbDataSource_CreateConnection" data-uid="GrapeCity.ActiveReports.Data.DbDataSource.CreateConnection">
          <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.CreateConnection.html#GrapeCity_ActiveReports_Data_DbDataSource_CreateConnection">CreateConnection()</a>
        </td>
        <td class="markdown level1 summary"><p>Creates and opens a new database connection using the current connection string.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_ActiveReports_Data_DbDataSource_NeedsToSetCredentials_System_String_System_String_" data-uid="GrapeCity.ActiveReports.Data.DbDataSource.NeedsToSetCredentials(System.String,System.String)">
          <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.NeedsToSetCredentials.html#GrapeCity_ActiveReports_Data_DbDataSource_NeedsToSetCredentials_System_String_System_String_">NeedsToSetCredentials(string, string)</a>
        </td>
        <td class="markdown level1 summary"><p>Determines whether credentials need to be set based on the provided user name and password.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_ActiveReports_Data_DbDataSource_OnConnectionStringChanging_System_String_" data-uid="GrapeCity.ActiveReports.Data.DbDataSource.OnConnectionStringChanging(System.String)">
          <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.OnConnectionStringChanging.html#GrapeCity_ActiveReports_Data_DbDataSource_OnConnectionStringChanging_System_String_">OnConnectionStringChanging(string)</a>
        </td>
        <td class="markdown level1 summary"><p>Allows to edit the connection string when its current value is about to change.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_ActiveReports_Data_DbDataSource_SetCredentials_System_String_System_String_" data-uid="GrapeCity.ActiveReports.Data.DbDataSource.SetCredentials(System.String,System.String)">
          <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.SetCredentials.html#GrapeCity_ActiveReports_Data_DbDataSource_SetCredentials_System_String_System_String_">SetCredentials(string, string)</a>
        </td>
        <td class="markdown level1 summary"><p>Returns a connection string with the specified credentials applied.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_ActiveReports_Data_DbDataSource_ToString" data-uid="GrapeCity.ActiveReports.Data.DbDataSource.ToString">
          <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.ToString.html#GrapeCity_ActiveReports_Data_DbDataSource_ToString">ToString()</a>
        </td>
        <td class="markdown level1 summary"><p>Returns a string that represents the current object.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_ActiveReports_Data_DbDataSource_XmlRead_System_Xml_XmlNode_" data-uid="GrapeCity.ActiveReports.Data.DbDataSource.XmlRead(System.Xml.XmlNode)">
          <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.XmlRead.html#GrapeCity_ActiveReports_Data_DbDataSource_XmlRead_System_Xml_XmlNode_">XmlRead(XmlNode)</a>
        </td>
        <td class="markdown level1 summary"><p>Deserializes this data source from the specified XML node.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_ActiveReports_Data_DbDataSource_XmlWrite_System_Xml_XmlDocument_System_Xml_XmlElement_" data-uid="GrapeCity.ActiveReports.Data.DbDataSource.XmlWrite(System.Xml.XmlDocument,System.Xml.XmlElement)">
          <a class="xref" href="GrapeCity.ActiveReports.Data.DbDataSource.XmlWrite.html#GrapeCity_ActiveReports_Data_DbDataSource_XmlWrite_System_Xml_XmlDocument_System_Xml_XmlElement_">XmlWrite(XmlDocument, XmlElement)</a>
        </td>
        <td class="markdown level1 summary"><p>Serializes this data source to an XML element and appends it to the specified node.</p>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="extensionmethods">Extension Methods</h3>
  <div>
      <a class="xref" href="GrapeCity.ActiveReports.ReportsCore.Tools.ObjectExtensions.ApplyDefaults.html#GrapeCity_ActiveReports_ReportsCore_Tools_ObjectExtensions_ApplyDefaults__1___0_">ObjectExtensions.ApplyDefaults&lt;TObject&gt;(TObject)</a>
  </div>
  <div>
      <a class="xref" href="GrapeCity.ActiveReports.ReportsCore.Tools.ObjectExtensions.SetValue.html#GrapeCity_ActiveReports_ReportsCore_Tools_ObjectExtensions_SetValue__1___0_System_ComponentModel_PropertyDescriptor_System_String_">ObjectExtensions.SetValue&lt;TObject&gt;(TObject, PropertyDescriptor, string)</a>
  </div>
  <div>
      <a class="xref" href="GrapeCity.ActiveReports.ReportsCore.Tools.ObjectExtensions.ToNameValueCollection.html#GrapeCity_ActiveReports_ReportsCore_Tools_ObjectExtensions_ToNameValueCollection_System_Object_">ObjectExtensions.ToNameValueCollection(object)</a>
  </div>

</div>
