SqlServerDB_dotNET 2.1.0

SqlServerDB — Documentazione NuGet

Una piccola libreria per semplificare la connessione a Microsoft SQL Server e l’esecuzione di query con C#/.NET.

Installazione

CLI

dotnet add package SqlServerDB

Package Manager

Install-Package SqlServerDB

Requisiti: .NET (Framework o .NET 6+), accesso a un’istanza SQL Server raggiungibile.

Avvio rapido (Quick Start)

using System;
using System.Data;
using SqlServerDB;

class Program
{
    static void Main()
    {
        string server   = @"INSTANCE\\SQLEXPRESS";
        string database = "DEMODB";
        string username = "sa";
        string password = "";

        string connectionString =
            $"Data Source={server};Initial Catalog={database};Trusted_Connection=True;User ID={username};Password={password}";

        DBConnection db_conn = new DBConnection(connectionString);

        Console.WriteLine($"IsConnected: {db_conn.IsConnected()}");
        if (db_conn == null || !db_conn.IsConnected())
        {
            Console.WriteLine("Connessione non valida.");
            return;
        }

        Console.WriteLine($"GetVersion: {db_conn.GetVersion()}");
        Console.WriteLine($"ConnectionString: {connectionString}");
        Console.WriteLine($"GetConnectionTimeout: {db_conn.GetConnectionTimeout()}");
        Console.WriteLine($"Host: {db_conn.Server}");
        Console.WriteLine($"Database: {db_conn.Database}");
        Console.WriteLine($"UserID: {db_conn.UserID}");
        Console.WriteLine($"Password: {db_conn.Password}");

        // Lettura dati
        string sql = "SELECT ID, Message FROM Logs ORDER BY IDLic;";
        DataTable dtLogs = db_conn.SelectTable(sql);
        if (dtLogs == null || dtLogs.Rows.Count == 0) return;

        foreach (DataRow dr in dtLogs.Rows)
        {
            Console.WriteLine("Message: " + dr["Message"].ToString().Trim());
        }

        // Scrittura dati con 'using' (dispose automatico)
        using (DBConnection db2 = new DBConnection(connectionString))
        {
            string sNominativo = "Micky";
            string insertSql = "INSERT INTO TabLav (Nominativo) VALUES('" + sNominativo + "');";

            if (!db2.sql_query(insertSql))
            {
                Console.WriteLine("Error during insert: " + db2.sql_error()[0]);
                Console.WriteLine(insertSql);
            }

            int insertedID = db2.GetLastInsertedRowID();
            Console.WriteLine("GetLastInsertedRowID: " + insertedID);

            int recordsAffected = db2.GetNumRecordsAffected();
            Console.WriteLine("GetNumRecordsAffected: " + recordsAffected);
        }
    }
}

Connection string — esempi

• Windows Authentication (Trusted Connection)

  Data Source=SERVER\\INSTANCE;Initial Catalog=DEMODB;Trusted_Connection=True;
  

• SQL Authentication

  Data Source=SERVER\\INSTANCE;Initial Catalog=DEMODB;User ID=sa;Password=yourPwd;
  

• Timeout personalizzato

  Data Source=SERVER\\INSTANCE;Initial Catalog=DEMODB;User ID=sa;Password=yourPwd;Connection Timeout=30;
  

Evita di loggare password/connection string complete in produzione.

API (sintesi)

Costruttore

• DBConnection(string connectionString)

Proprietà

• string Server — Host/istanza
• string Database — Database selezionato
• string UserID
• string Password

Metodi

• bool IsConnected() — stato connessione
• string GetVersion() — versione server SQL
• int GetConnectionTimeout() — timeout (s)
• DataTable SelectTable(string sql) — SELECT → DataTable (o null)
• bool sql_query(string sql) — INSERT/UPDATE/DELETE/DDL
• string[] sql_error() — ultimi dettagli d’errore
• int GetLastInsertedRowID() — ID dell’ultima riga inserita
• int GetNumRecordsAffected() — record interessati dall’ultima non-query

La classe implementa IDisposable. Usa sempre using per il rilascio delle risorse.

Esempi aggiuntivi

Lettura semplice

DataTable dt = db_conn.SelectTable("SELECT TOP 100 * FROM Logs;");
if (dt != null)
{
    foreach (DataRow r in dt.Rows)
        Console.WriteLine($"{r["ID"]}: {r["Message"]}");
}

Inserimento con controllo errori

string name = "Mario Rossi";
string insert = $"INSERT INTO TabClienti (Nome) VALUES('{name}');";

if (!db_conn.sql_query(insert))
{
    var errors = db_conn.sql_error();
    Console.WriteLine("Errore SQL: " + (errors?.Length > 0 ? errors[0] : "sconosciuto"));
}
else
{
    Console.WriteLine($"Nuovo ID: {db_conn.GetLastInsertedRowID()}");
    Console.WriteLine($"Record interessati: {db_conn.GetNumRecordsAffected()}");
}

Sicurezza: gli esempi concatenano stringhe per semplicità. In produzione usa query parametriche o stored procedure per prevenire SQL injection.

Troubleshooting

• IsConnected() è false
  Verifica Data Source, Initial Catalog, credenziali, firewall/porte. Aumenta Connection Timeout temporaneamente.

• SelectTable ritorna null
  Query non valida o eccezione: controlla sql_error(). Verifica permessi.

• GetLastInsertedRowID() è 0
  Assicurati che la tabella abbia una colonna IDENTITY o meccanismo equivalente e che la chiamata avvenga sulla stessa istanza dopo l’INSERT.

Licenza & Changelog

Consulta la pagina NuGet del pacchetto per note di rilascio e licenza.