ASql 2.0.1
See the version list below for details.
dotnet add package ASql --version 2.0.1
NuGet\Install-Package ASql -Version 2.0.1
<PackageReference Include="ASql" Version="2.0.1" />
paket add ASql --version 2.0.1
#r "nuget: ASql, 2.0.1"
// Install ASql as a Cake Addin #addin nuget:?package=ASql&version=2.0.1 // Install ASql as a Cake Tool #tool nuget:?package=ASql&version=2.0.1
ASql
C# Library that let use multiple types of databases ASql C# Library that let use multiple types of databases (SqlServer, Oracle, MySql, PostgreSQL, Sqlite) with same code with same code
The supported databases are SqlServer, Oracle, MySql, PostgreSQL and Sqlite
Here you can find last stable from Nuget www.nuget.org/packages/ASql
You only have to declare wich type of database would like you use and use the classe in the same way of sql or oracle client.
Inside our library We use the most famous libraries for connecting to these 5 dabases :
Database | Library | Example of connection string |
---|---|---|
SqlServer | System.Data.SqlClient | const string sqlConnectionString = "Data Source=NBK-437;Persist Security Info=True;Initial Catalog=test;Integrated Security=SSPI;"; |
Oracle | Oracle.ManagedDataAccess | const string oraConnectionString = "Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=XEPDB1)));User Id=DBWUSR;Password=DBWUSR;"; |
MySql | MySql.Data | const string mysConnectionString = "Server=localhost;Database=test;Uid=sa;Pwd=ASqlAdmin01;"; |
PostgreSQL | Npgsql | const string posConnectionString = "Server=127.0.0.1;Port=5432;Database=test;User Id=postgres;Password=ASqlAdmin01;"; |
Sqlite | Microsoft.Data.Sqlite | const string litConnectionString = @"Data Source=c:\temp\test.db;"; |
We have added the event OnGenericQueryEnd to trace all the query and their performances executed in your software.
Here you can find examples :
# Example 1 Basic query
public void ExecuteQuery(ASqlManager.DBType dBType, string ConnectionString, string sql)
{
//You only have to specify which type of database want to use and after you will have to use ASql objects instead the Typized objects like OracleConnection
ASqlManager.DataBaseType = dBType;
using (ASqlConnection conn = new ASqlConnection(ConnectionString))
{
int i = 0;
conn.Open();
ASqlCommand cmd = new ASqlCommand(sql, conn);
i = cmd.ExecuteNonQuery();
}
}
# Example 2.a Query with ExecuteScalar With Parameters
public void ExecuteScalar(ASqlManager.DBType dBType, string ConnectionString)
{
string sql = "select firstname from person where lastname = @lastname";
//if you want to use oracle you have tu put : intestad @ like this
//string sql = "select firstname from person where lastname = :lastname";
ASqlManager.DataBaseType = dBType;
using (ASqlConnection conn = new ASqlConnection(ConnectionString))
{
string name = "";
conn.Open();
ASqlCommand cmd = new ASqlCommand(sql, conn);
ASqlParameter par = new ASqlParameter();
par.ParameterName = "lastname";
par.DbType = DbType.String;
par.Value = "last1";
//Pay attention to popolate the aSqlParameters collection like the row below and not the Parameters collection (the library will think to keep uptodated the Parameters collection)
cmd.aSqlParameters.Add(par);
name = (string)cmd.ExecuteScalar();
}
}
# Example 2.b with ExecuteReader With Parameters
public void ExecuteReaderTester(ASqlManager.DBType dBType)
{
string sql = "select firstname from person where lastname = @lastname";
//if you want to use oracle you have tu put : intestad @ like this
//string sql = "select firstname from person where lastname = :lastname";
ASqlManager.DataBaseType = dBType;
using (ASqlConnection conn = new ASqlConnection(ConnectionString))
{
string i = "";
conn.Open();
ASqlCommand cmd = new ASqlCommand(sql, conn);
ASqlParameter par = new ASqlParameter();
par.ParameterName = "lastname";
par.DbType = DbType.String;
par.Value = "last1";
cmd.aSqlParameters.Add(par);
using (DbDataReader read = cmd.ExecuteReader())
{
while (read.Read())
{
i = read.GetString(read.GetOrdinal("firstname"));
}
}
Assert.AreEqual("first1", i.ToUpper());
}
}
# Example 3 Using DataAdapter
public void SqlDataAdapterTester(ASqlManager.DBType dBType)
{
ASqlManager.DataBaseType = dBType;
string sql = "select * from person"
using (ASqlConnection conn = new ASqlConnection(ConnectionString))
{
int i = 0;
conn.Open();
ASqlCommand cmd = new ASqlCommand(sql, conn);
ASqlDataAdapter aSqlDataAdapter = new ASqlDataAdapter(cmd);
DataSet ds = new DataSet();
i = aSqlDataAdapter.Fill(ds);
}
}
# Example 4 using Transaction
public void DropTableWithRollBack(ASqlManager.DBType dBType, string ConnectionString, string sql)
{
ASqlManager.DataBaseType = dBType;
using (ASqlConnection conn = new ASqlConnection(ConnectionString))
{
int i = 0;
conn.Open();
DbTransaction trans = conn.BeginTransaction();
ASqlCommand cmd = new ASqlCommand(sql, conn);
cmd.Transaction = trans;
i = cmd.ExecuteNonQuery();
trans.Rollback();
}
}
# Example 5 using Event to trace queries
//This method will be called whene ExecuteNonQuery, ExecuteReader and ExcutedScalar will be executed
//If you want you can use your favourite logging library to trace the queries and their performance in millisecs.
internal static void Cmd_OnGenericQueryEnd(object sender, GenericQueryEndEventArgs e)
{
Console.WriteLine(e.Method+" "+e.Query +" "+ e.TotalMilliseconds);
}
ASqlManager.DataBaseType = dBType;
using (ASqlConnection conn = new ASqlConnection(ConnectionString))
{
conn.Open();
ASqlCommand cmd = new ASqlCommand(sql, conn);
cmd.OnGenericQueryEnd += Cmd_OnGenericQueryEnd; //This is the way to link the method to the event inside the command object
string paramChar = "";
List<ASqlParameter> apc = Utils.GetParametersFromkeyValuePairs(d, paramChar);
foreach (ASqlParameter param in apc)
{
cmd.aSqlParameters.Add(param);
}
r = cmd.ExecuteNonQuery();
}
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 is compatible. |
.NET Framework | net461 was computed. net462 is compatible. net463 was computed. net47 was computed. net471 is compatible. net472 was computed. net48 is compatible. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETFramework 4.6.2
- Microsoft.Data.Sqlite (>= 8.0.8)
- MySql.Data (>= 9.0.0)
- Npgsql (>= 8.0.3)
- Oracle.ManagedDataAccess (>= 21.15.0)
- System.Data.SqlClient (>= 4.8.6)
-
.NETFramework 4.7.1
- Microsoft.Data.Sqlite (>= 8.0.8)
- MySql.Data (>= 9.0.0)
- Npgsql (>= 8.0.3)
- Oracle.ManagedDataAccess (>= 21.15.0)
- System.Data.SqlClient (>= 4.8.6)
-
.NETFramework 4.8
- Microsoft.Data.Sqlite (>= 8.0.8)
- MySql.Data (>= 9.0.0)
- Npgsql (>= 8.0.3)
- Oracle.ManagedDataAccess (>= 21.15.0)
- System.Data.SqlClient (>= 4.8.6)
-
.NETStandard 2.0
- Microsoft.Data.Sqlite (>= 8.0.8)
- MySql.Data (>= 9.0.0)
- Npgsql (>= 8.0.3)
- Oracle.ManagedDataAccess (>= 21.15.0)
- System.Data.SqlClient (>= 4.8.6)
-
.NETStandard 2.1
- Microsoft.Data.Sqlite (>= 8.0.8)
- MySql.Data (>= 9.0.0)
- Npgsql (>= 8.0.3)
- Oracle.ManagedDataAccess (>= 21.15.0)
- System.Data.SqlClient (>= 4.8.6)
-
net6.0
- Microsoft.Data.Sqlite (>= 8.0.8)
- MySql.Data (>= 9.0.0)
- Npgsql (>= 8.0.3)
- Oracle.ManagedDataAccess (>= 21.15.0)
- System.Data.SqlClient (>= 4.8.6)
-
net7.0
- Microsoft.Data.Sqlite (>= 8.0.8)
- MySql.Data (>= 9.0.0)
- Npgsql (>= 8.0.3)
- Oracle.ManagedDataAccess (>= 21.15.0)
- System.Data.SqlClient (>= 4.8.6)
-
net8.0
- Microsoft.Data.Sqlite (>= 8.0.8)
- MySql.Data (>= 9.0.0)
- Npgsql (>= 8.0.3)
- Oracle.ManagedDataAccess (>= 21.15.0)
- Oracle.ManagedDataAccess.Core (>= 23.5.1)
- System.Data.SqlClient (>= 4.8.6)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on ASql:
Package | Downloads |
---|---|
Serilog.Sinks.Database
Serilog sink that writes in one of these five databases (SqlServer, Oracle, MySql, PostgreSQL, Sqlite) |
GitHub repositories
This package is not used by any popular GitHub repositories.