Em muitos contextos de negócios diferentes, importar dados do Excel para o SQL Server é uma necessidade típica. Ler dados de um arquivo do Excel e inseri-los em um banco de dados SQL Server são as tarefas envolvidas nesta atividade. Embora o assistente de exportação seja frequentemente utilizado, o IronXL oferece uma abordagem mais programática e flexível para manipulação de dados. O IronXL é uma poderosa biblioteca C# que pode importar dados do Excel a partir de arquivos; portanto, é possível agilizar essa operação. Para esse fim, este post oferecerá um guia completo sobre como configurar, executar e aprimorar a importação do Excel para o SQL Server usando C#.
O IronXL, às vezes referido como IronXL.Excel, é uma biblioteca C# rica em recursos feita para facilitar o trabalho com arquivos Excel em aplicativos .NET. Esta ferramenta robusta é ideal para aplicativos no lado do servidor, pois permite que os desenvolvedores leiam, criem e editem arquivos Excel sem precisar instalar o Microsoft Excel no computador. Os formatos Excel 2007 e posteriores (.xlsx) e Excel 97–2003 (.xls) são suportados pelo IronXL, proporcionando versatilidade no gerenciamento de várias versões de arquivos Excel. Permite uma significativa manipulação de dados, como a manipulação de planilhas, linhas e colunas, além da inserção, atualização e remoção de dados.
O IronXL também suporta formatação de células e fórmulas do Excel, permitindo a geração programada de planilhas complexas e bem formatadas. Com sua otimização de desempenho e compatibilidade com múltiplas plataformas .NET, incluindo. NET Framework, .NET Core e .NET 5/6, o IronXL garante um manuseio eficaz de grandes conjuntos de dados. É uma opção flexível para desenvolvedores que desejam integrar operações de arquivos Excel em seus aplicativos, seja para atividades simples de importação/exportação de dados ou sistemas de relatórios complexos, graças à sua interface suave com outras estruturas .NET.
Os desenvolvedores podem ler e escrever dados de e para arquivos Excel usando IronXL. É simples criar novos arquivos Excel e editar os que já existem.
O IronXL não requer a instalação do Microsoft Excel no computador que hospeda o aplicativo, ao contrário de algumas outras bibliotecas. Isso o torna perfeito para aplicações no lado do servidor.
A biblioteca oferece versatilidade no gerenciamento de vários tipos de arquivos Excel, suportando os formatos .xls (Excel 97-2003) e .xlsx (Excel 2007 e posteriores).
É simples criar um projeto de console no Visual Studio. No Visual Studio, siga as seguintes ações para criar uma Aplicação Console:
File -> New -> Project.
Create a new project, escolha seu idioma de programação preferido—por exemplo, C#.Console App ou Console App (.NET Core) da lista de templates de projeto disponíveis.
Instalar a biblioteca IronXL é necessário por causa da próxima atualização. Finalmente, para finalizar o procedimento, abra o Console do Gerenciador de Pacotes NuGet e digite o seguinte comando:
Usar o Gerenciador de Pacotes NuGet para procurar o pacote IronXL é outro método. Isso nos permite selecionar qual dos pacotes NuGet vinculados ao IronXL baixar.
O processo de leitura de dados de arquivos Excel é facilitado com o IronXL. O exemplo a seguir mostra como usar o IronXL para ler dados de um arquivo Excel. Com essa abordagem, os dados são lidos e salvos em uma lista de dicionários, cada um correspondendo a uma linha na planilha Excel.
using IronXL;
using System;
using System.Collections.Generic;
public class ExcelReader
{
public static List<Dictionary<string, object>> ReadExcelFile(string filePath)
{
// Initialize a list to store data from Excel
var data = new List<Dictionary<string, object>>();
// Load the workbook from the file path provided
WorkBook workbook = WorkBook.Load(filePath);
// Access the first worksheet in the workbook
WorkSheet sheet = workbook.WorkSheets[0];
// Retrieve column headers from the first row
var headers = new List<string>();
foreach (var header in sheet.Rows[0].Columns)
{
headers.Add(header.ToString());
}
// Loop through each row starting from the second row
for (int i = 1; i < sheet.Rows.Count; i++)
{
// Create a dictionary to store the row data associated with column headers
var rowData = new Dictionary<string, object>();
for (int j = 0; j < headers.Count; j++)
{
rowData[headers[j]] = sheet.Rows[i][j].Value;
}
data.Add(rowData);
}
return data;
}
}Imports IronXL
Imports System
Imports System.Collections.Generic
Public Class ExcelReader
Public Shared Function ReadExcelFile(ByVal filePath As String) As List(Of Dictionary(Of String, Object))
' Initialize a list to store data from Excel
Dim data = New List(Of Dictionary(Of String, Object))()
' Load the workbook from the file path provided
Dim workbook As WorkBook = WorkBook.Load(filePath)
' Access the first worksheet in the workbook
Dim sheet As WorkSheet = workbook.WorkSheets(0)
' Retrieve column headers from the first row
Dim headers = New List(Of String)()
For Each header In sheet.Rows(0).Columns
headers.Add(header.ToString())
Next header
' Loop through each row starting from the second row
For i As Integer = 1 To sheet.Rows.Count - 1
' Create a dictionary to store the row data associated with column headers
Dim rowData = New Dictionary(Of String, Object)()
For j As Integer = 0 To headers.Count - 1
rowData(headers(j)) = sheet.Rows(i)(j).Value
Next j
data.Add(rowData)
Next i
Return data
End Function
End ClassUse a classe SqlConnection do namespace System.Data.SqlClient para estabelecer uma conexão com o SQL Server. Certifique-se de ter a string de conexão correta, que normalmente consiste no nome do banco de dados, nome do servidor e informações de autenticação. Como conectar-se a um banco de dados SQL Server e adicionar dados é abordado no exemplo a seguir.
using System;
using System.Collections.Generic;
using System.Data.SqlClient;
using System.Linq;
public class SqlServerConnector
{
private string connectionString;
// Constructor accepts a connection string
public SqlServerConnector(string connectionString)
{
this.connectionString = connectionString;
}
// Inserts data into the specified table
public void InsertData(Dictionary<string, object> data, string tableName)
{
using (SqlConnection connection = new SqlConnection(connectionString))
{
connection.Open();
// Construct an SQL INSERT command with parameterized values to prevent SQL injection
var columns = string.Join(",", data.Keys);
var parameters = string.Join(",", data.Keys.Select(key => "@" + key));
string query = $"INSERT INTO {tableName} ({columns}) VALUES ({parameters})";
using (SqlCommand command = new SqlCommand(query, connection))
{
// Add parameters to the command
foreach (var kvp in data)
{
command.Parameters.AddWithValue("@" + kvp.Key, kvp.Value ?? DBNull.Value);
}
// Execute the command
command.ExecuteNonQuery();
}
}
}
}Imports System
Imports System.Collections.Generic
Imports System.Data.SqlClient
Imports System.Linq
Public Class SqlServerConnector
Private connectionString As String
' Constructor accepts a connection string
Public Sub New(ByVal connectionString As String)
Me.connectionString = connectionString
End Sub
' Inserts data into the specified table
Public Sub InsertData(ByVal data As Dictionary(Of String, Object), ByVal tableName As String)
Using connection As New SqlConnection(connectionString)
connection.Open()
' Construct an SQL INSERT command with parameterized values to prevent SQL injection
Dim columns = String.Join(",", data.Keys)
Dim parameters = String.Join(",", data.Keys.Select(Function(key) "@" & key))
Dim query As String = $"INSERT INTO {tableName} ({columns}) VALUES ({parameters})"
Using command As New SqlCommand(query, connection)
' Add parameters to the command
For Each kvp In data
command.Parameters.AddWithValue("@" & kvp.Key, If(kvp.Value, DBNull.Value))
Next kvp
' Execute the command
command.ExecuteNonQuery()
End Using
End Using
End Sub
End ClassUma vez que a lógica para ler arquivos Excel e inserir dados em um banco de dados SQL foi estabelecida, integre essas funcionalidades para concluir o processo de importação. O aplicativo que segue recebe informações de um arquivo Excel e as adiciona a um banco de dados Microsoft SQL Server.
using System;
using System.Collections.Generic;
class Program
{
static void Main(string[] args)
{
// Define the path to the Excel file, SQL connection string, and target table name
string excelFilePath = "path_to_your_excel_file.xlsx";
string connectionString = "your_sql_server_connection_string";
string tableName = "your_table_name";
// Read data from Excel
List<Dictionary<string, object>> excelData = ExcelReader.ReadExcelFile(excelFilePath);
// Create an instance of the SQL connector and insert data
SqlServerConnector sqlConnector = new SqlServerConnector(connectionString);
foreach (var row in excelData)
{
sqlConnector.InsertData(row, tableName);
}
Console.WriteLine("Data import completed successfully.");
}
}Imports System
Imports System.Collections.Generic
Friend Class Program
Shared Sub Main(ByVal args() As String)
' Define the path to the Excel file, SQL connection string, and target table name
Dim excelFilePath As String = "path_to_your_excel_file.xlsx"
Dim connectionString As String = "your_sql_server_connection_string"
Dim tableName As String = "your_table_name"
' Read data from Excel
Dim excelData As List(Of Dictionary(Of String, Object)) = ExcelReader.ReadExcelFile(excelFilePath)
' Create an instance of the SQL connector and insert data
Dim sqlConnector As New SqlServerConnector(connectionString)
For Each row In excelData
sqlConnector.InsertData(row, tableName)
Next row
Console.WriteLine("Data import completed successfully.")
End Sub
End ClassEsta classe é responsável por usar o IronXL para ler os dados do arquivo Excel fornecido. A função ReadExcelFile carrega a pasta de trabalho do Excel, abre a primeira planilha e coleta dados percorrendo as linhas da planilha de dados. Para facilitar o manuseio das tabelas, as informações são mantidas em uma lista de dicionários.
Os dados são inseridos na tabela designada do banco de dados por esta classe, que também gerencia a conexão com o banco de dados SQL Server. O método InsertData emprega consultas parametrizadas para prevenir injeção de SQL e constrói uma consulta SQL INSERT dinamicamente com base nas chaves do dicionário, que representam os nomes das colunas.
Usando a classe ExcelReader para ler os dados no tabela SQL a partir do arquivo Excel e a classe SqlServerConnector para inserir cada linha na tabela SQL Server, a função Main gerencia todo o processo.
O tratamento de erros e a otimização são cruciais para garantir um processo de importação robusto e eficiente. A implementação de tratamento robusto de erros pode gerenciar problemas potenciais, como arquivos ausentes, formatos de dados inválidos e exceções SQL. Aqui está um exemplo de incorporação de tratamento de erros.
try
{
// Insert the importing logic here
}
catch (Exception ex)
{
Console.WriteLine("An error occurred: " + ex.Message);
}Try
' Insert the importing logic here
Catch ex As Exception
Console.WriteLine("An error occurred: " & ex.Message)
End TryFinalmente, um método eficaz e confiável para gerenciar arquivos Excel em aplicativos .NET é importar dados do Excel para um banco de dados MS SQL usando C# e IronXL. O IronXL é compatível com múltiplos formatos Excel e possui capacidades robustas que facilitam a leitura e escrita de dados Excel sem a necessidade de instalar o Microsoft Excel. Por meio da integração de System.Data.SqlClient com IronXL, os desenvolvedores podem facilmente mover dados entre SQL Servers usando consultas parametrizadas para melhorar a segurança e prevenir injeção de SQL.
Finalmente, adicionar IronXL e Iron Software ao seu conjunto de ferramentas de desenvolvimento .NET permite que você manipule eficientemente Excel, crie PDFs, faça OCR e utilize códigos de barras. Combinando o conjunto flexível da Iron Software com a simplicidade de uso, interoperabilidade e desempenho do IronXL garante um desenvolvimento simplificado e capacidades aprimoradas de aplicativos. Com opções de licença claras que são personalizadas para os requisitos do projeto, os desenvolvedores podem selecionar o modelo correto com confiança. Ao utilizar esses benefícios, os desenvolvedores podem enfrentar efetivamente uma gama de desafios enquanto mantêm conformidade e transparência.
Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.
IronXL faz parte do IRON SUITE.
10 produtos de API .NET para seus documentos de escritório
A API do Excel que você precisa, sem as complicações do Office Interop.
