# C1.AdoNet.Salesforce.C1SalesforceConnection

## Content

<div class="doc-site-dotnet-api-container">



  <h1 id="C1_AdoNet_Salesforce_C1SalesforceConnection" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection" class="text-break">C1SalesforceConnection Class
</h1>
  <div class="markdown level0 summary"><pre><code>&lt;xref href=&quot;C1.AdoNet.Salesforce.C1SalesforceConnection&quot; data-throw-if-not-resolved=&quot;false&quot;&gt;&lt;/xref&gt; represents a connection to a Salesforce server. 
</code></pre>
<p>The connection can be used to query the data hosted by the server or request modifications.</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"><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.data.common.dbconnection">DbConnection</a></div>
    <div class="level4"><a class="xref" href="../C1.AdoNet.CSV/C1.DataConnector.AdoNet.C1ConnectionBase.html">C1ConnectionBase</a></div>
    <div class="level5"><a class="xref" href="C1.DataConnector.AdoNet.C1ConnectionBase-1.html">C1ConnectionBase</a>&lt;<a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.html">C1SalesforceConnection</a>&gt;</div>
    <div class="level6"><span class="xref">C1SalesforceConnection</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.data.idbconnection">IDbConnection</a></div>
    <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.iasyncdisposable">IAsyncDisposable</a></div>
  </div>
  <h6><strong>Namespace</strong>: <a class="xref" href="C1.AdoNet.Salesforce.html">C1.AdoNet.Salesforce</a></h6>
  <h6><strong>Assembly</strong>: C1.AdoNet.Salesforce.dll</h6>
  <h5 id="C1_AdoNet_Salesforce_C1SalesforceConnection_syntax">Syntax</h5>
  <div class="codewrapper">
    <pre><code class="lang-csharp hljs">public sealed class C1SalesforceConnection : C1ConnectionBase&lt;C1SalesforceConnection&gt;, IComponent, IDbConnection, IDisposable, IAsyncDisposable</code></pre>
  </div>
  <div class="codewrapper">
    <pre><code class="lang-vbnet hljs">Public NotInheritable Class C1SalesforceConnection
    Inherits C1ConnectionBase(Of C1SalesforceConnection)
    Implements IComponent, IDbConnection, IDisposable, IAsyncDisposable</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_AdoNet_Salesforce_C1SalesforceConnection__ctor" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.#ctor">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.-ctor.html#C1_AdoNet_Salesforce_C1SalesforceConnection__ctor">C1SalesforceConnection()</a>
        </td>
        <td class="markdown level1 summary"><p>Creates a new <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.html">C1SalesforceConnection</a> instance.</p>
</td>
      </tr>
      <tr>
        <td id="C1_AdoNet_Salesforce_C1SalesforceConnection__ctor_C1_AdoNet_Salesforce_C1SalesforceConnectionStringBuilder_" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.#ctor(C1.AdoNet.Salesforce.C1SalesforceConnectionStringBuilder)">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.-ctor.html#C1_AdoNet_Salesforce_C1SalesforceConnection__ctor_C1_AdoNet_Salesforce_C1SalesforceConnectionStringBuilder_">C1SalesforceConnection(C1SalesforceConnectionStringBuilder)</a>
        </td>
        <td class="markdown level1 summary"><p>Initialize a new <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.html">C1SalesforceConnection</a> instance using the specified connection string
expressed in a <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnectionStringBuilder.html">C1SalesforceConnectionStringBuilder</a>.</p>
</td>
      </tr>
      <tr>
        <td id="C1_AdoNet_Salesforce_C1SalesforceConnection__ctor_System_String_" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.#ctor(System.String)">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.-ctor.html#C1_AdoNet_Salesforce_C1SalesforceConnection__ctor_System_String_">C1SalesforceConnection(string)</a>
        </td>
        <td class="markdown level1 summary"><p>Initialize a new <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.html">C1SalesforceConnection</a> instance using the specified connection string.</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_AdoNet_Salesforce_C1SalesforceConnection_ApiVersion" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.ApiVersion">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.ApiVersion.html#C1_AdoNet_Salesforce_C1SalesforceConnection_ApiVersion">ApiVersion</a>
        </td>
        <td class="markdown level1 summary"><p>The API version of the Salesforce server</p>
</td>
      </tr>
      <tr>
        <td id="C1_AdoNet_Salesforce_C1SalesforceConnection_BaseUrl" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.BaseUrl">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.BaseUrl.html#C1_AdoNet_Salesforce_C1SalesforceConnection_BaseUrl">BaseUrl</a>
        </td>
        <td class="markdown level1 summary"><p>The base url of the Salesforce server.</p>
</td>
      </tr>
      <tr>
        <td id="C1_AdoNet_Salesforce_C1SalesforceConnection_DataSource" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.DataSource">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.DataSource.html#C1_AdoNet_Salesforce_C1SalesforceConnection_DataSource">DataSource</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the name of the database server to which to connect.</p>
</td>
      </tr>
      <tr>
        <td id="C1_AdoNet_Salesforce_C1SalesforceConnection_Database" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.Database">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.Database.html#C1_AdoNet_Salesforce_C1SalesforceConnection_Database">Database</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the name of the current database after a connection is opened,
or the database name specified in the connection string before the connection is opened.</p>
</td>
      </tr>
      <tr>
        <td id="C1_AdoNet_Salesforce_C1SalesforceConnection_DbProviderFactory" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.DbProviderFactory">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.DbProviderFactory.html#C1_AdoNet_Salesforce_C1SalesforceConnection_DbProviderFactory">DbProviderFactory</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.DbProviderFactory.html#C1_AdoNet_Salesforce_C1SalesforceConnection_DbProviderFactory">DbProviderFactory</a> for this connection.</p>
</td>
      </tr>
      <tr>
        <td id="C1_AdoNet_Salesforce_C1SalesforceConnection_ServerVersion" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.ServerVersion">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.ServerVersion.html#C1_AdoNet_Salesforce_C1SalesforceConnection_ServerVersion">ServerVersion</a>
        </td>
        <td class="markdown level1 summary"><p>Gets a string that represents the version of the server to which the object is connected.</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_AdoNet_Salesforce_C1SalesforceConnection_BeginDbTransaction_System_Data_IsolationLevel_" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.BeginDbTransaction(System.Data.IsolationLevel)">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.BeginDbTransaction.html#C1_AdoNet_Salesforce_C1SalesforceConnection_BeginDbTransaction_System_Data_IsolationLevel_">BeginDbTransaction(IsolationLevel)</a>
        </td>
        <td class="markdown level1 summary"><p>Begins a transaction on the connection.</p>
</td>
      </tr>
      <tr>
        <td id="C1_AdoNet_Salesforce_C1SalesforceConnection_ChangeDatabase_System_String_" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.ChangeDatabase(System.String)">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.ChangeDatabase.html#C1_AdoNet_Salesforce_C1SalesforceConnection_ChangeDatabase_System_String_">ChangeDatabase(string)</a>
        </td>
        <td class="markdown level1 summary"><p>Changes the current database for an open connection.</p>
</td>
      </tr>
      <tr>
        <td id="C1_AdoNet_Salesforce_C1SalesforceConnection_Close" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.Close">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.Close.html#C1_AdoNet_Salesforce_C1SalesforceConnection_Close">Close()</a>
        </td>
        <td class="markdown level1 summary"><p>Closes the connection to the database. This is the preferred method of closing any open connection.</p>
</td>
      </tr>
      <tr>
        <td id="C1_AdoNet_Salesforce_C1SalesforceConnection_CreateDbCommand" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.CreateDbCommand">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.CreateDbCommand.html#C1_AdoNet_Salesforce_C1SalesforceConnection_CreateDbCommand">CreateDbCommand()</a>
        </td>
        <td class="markdown level1 summary"><p>Creates and returns a <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.data.common.dbcommand">DbCommand</a> object associated with the current connection.</p>
</td>
      </tr>
      <tr>
        <td id="C1_AdoNet_Salesforce_C1SalesforceConnection_GetColumnsSchema_System_String___" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.GetColumnsSchema(System.String[])">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.GetColumnsSchema.html#C1_AdoNet_Salesforce_C1SalesforceConnection_GetColumnsSchema_System_String___">GetColumnsSchema(string[])</a>
        </td>
        <td class="markdown level1 summary"><p>Retrieve the metadata relatively to the columns.</p>
</td>
      </tr>
      <tr>
        <td id="C1_AdoNet_Salesforce_C1SalesforceConnection_GetForeignKeySchema_System_String___" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.GetForeignKeySchema(System.String[])">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.GetForeignKeySchema.html#C1_AdoNet_Salesforce_C1SalesforceConnection_GetForeignKeySchema_System_String___">GetForeignKeySchema(string[])</a>
        </td>
        <td class="markdown level1 summary"><p>Retrieve the metadata relatively to the foreign keys.</p>
</td>
      </tr>
      <tr>
        <td id="C1_AdoNet_Salesforce_C1SalesforceConnection_GetIndexColumns_System_String___" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.GetIndexColumns(System.String[])">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.GetIndexColumns.html#C1_AdoNet_Salesforce_C1SalesforceConnection_GetIndexColumns_System_String___">GetIndexColumns(string[])</a>
        </td>
        <td class="markdown level1 summary"><p>Retrieve the metadata relatively to the index columns.</p>
</td>
      </tr>
      <tr>
        <td id="C1_AdoNet_Salesforce_C1SalesforceConnection_GetIndexesSchema_System_String___" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.GetIndexesSchema(System.String[])">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.GetIndexesSchema.html#C1_AdoNet_Salesforce_C1SalesforceConnection_GetIndexesSchema_System_String___">GetIndexesSchema(string[])</a>
        </td>
        <td class="markdown level1 summary"><p>Retrieve the metadata relatively to the indexes.</p>
</td>
      </tr>
      <tr>
        <td id="C1_AdoNet_Salesforce_C1SalesforceConnection_GetPrimaryKeySchema_System_String___" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.GetPrimaryKeySchema(System.String[])">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.GetPrimaryKeySchema.html#C1_AdoNet_Salesforce_C1SalesforceConnection_GetPrimaryKeySchema_System_String___">GetPrimaryKeySchema(string[])</a>
        </td>
        <td class="markdown level1 summary"><p>Retrieve the metadata relatively to the primary keys.</p>
</td>
      </tr>
      <tr>
        <td id="C1_AdoNet_Salesforce_C1SalesforceConnection_GetTablesSchema_System_String___" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.GetTablesSchema(System.String[])">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.GetTablesSchema.html#C1_AdoNet_Salesforce_C1SalesforceConnection_GetTablesSchema_System_String___">GetTablesSchema(string[])</a>
        </td>
        <td class="markdown level1 summary"><p>Retrieve the metadata relatively to the tables.</p>
</td>
      </tr>
      <tr>
        <td id="C1_AdoNet_Salesforce_C1SalesforceConnection_OnConnectionStringChanged" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.OnConnectionStringChanged">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.OnConnectionStringChanged.html#C1_AdoNet_Salesforce_C1SalesforceConnection_OnConnectionStringChanged">OnConnectionStringChanged()</a>
        </td>
        <td class="markdown level1 summary"><p>A method that is executed everytime that the connection string used by this <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnectionStringBuilder.html">C1SalesforceConnectionStringBuilder</a> has changed.</p>
</td>
      </tr>
      <tr>
        <td id="C1_AdoNet_Salesforce_C1SalesforceConnection_Open" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.Open">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.Open.html#C1_AdoNet_Salesforce_C1SalesforceConnection_Open">Open()</a>
        </td>
        <td class="markdown level1 summary"><p>Opens a database connection with the settings specified by the connection string.</p>
</td>
      </tr>
      <tr>
        <td id="C1_AdoNet_Salesforce_C1SalesforceConnection_OpenAsync_System_Threading_CancellationToken_" data-uid="C1.AdoNet.Salesforce.C1SalesforceConnection.OpenAsync(System.Threading.CancellationToken)">
          <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.OpenAsync.html#C1_AdoNet_Salesforce_C1SalesforceConnection_OpenAsync_System_Threading_CancellationToken_">OpenAsync(CancellationToken)</a>
        </td>
        <td class="markdown level1 summary"><p>An asynchronous version of <a class="xref" href="C1.AdoNet.Salesforce.C1SalesforceConnection.Open.html#C1_AdoNet_Salesforce_C1SalesforceConnection_Open">Open()</a> open.</p>
</td>
      </tr>
    </tbody>
  </table>

</div>
