IronXL 사용하여 C#에서 CSV 파일을 읽는 방법

.NET에서 CSV 파일을 읽는 가장 쉬운 방법은 무엇입니까?

WorkBook.LoadCSV를 사용하여 CSV 데이터를 직접 워크북 구조로 가져오는 것이 가장 간단한 방법입니다. 이 단일 메서드는 구문 분석, 구분자 감지 및 데이터 조직을 자동으로 처리하여 StreamReader를 만들 필요가 없으며 각 문자열 라인을 수동으로 처리할 필요가 없습니다.

NuGet 패키지 관리자 콘솔을 통해 Visual Studio에 IronXL을 설치하십시오. .NET 프로젝트를 열고 실행하십시오:

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

using IronXL;

// Load CSV file into a workbook with one method call
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: ",");
// Access the default worksheet containing CSV data
WorkSheet sheet = workbook.DefaultWorkSheet;
// Display all rows and CSV columns
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
    {
        Console.Write(cell.Value + "\t");
    }
    Console.WriteLine();
}

using IronXL;

// Load CSV file into a workbook with one method call
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: ",");
// Access the default worksheet containing CSV data
WorkSheet sheet = workbook.DefaultWorkSheet;
// Display all rows and CSV columns
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
    {
        Console.Write(cell.Value + "\t");
    }
    Console.WriteLine();
}

수동 CSV 구문 분석은 라이브러리 사용과 어떻게 비교됩니까?

IronXL이 제거하는 복잡성을 이해하면 그 가치를 명확히 할 수 있습니다. 수동 CSV 구문 분석은 간단해 보이지만 어느 프로젝트에서든지 문제를 일으킬 수 있는 여러 예외 케이스를 처리해야 합니다.

using System.IO;

// Manual approach -- requires extensive code for basic functionality
string path = "data.csv";
string[] lines = File.ReadAllLines(path);
foreach (string line in lines)
{
    // This breaks when CSV fields contain commas inside quotes
    string[] fields = line.Split(',');
    foreach (string field in fields)
    {
        Console.Write(field.Trim() + "\t");
    }
    Console.WriteLine();
}

using System.IO;

// Manual approach -- requires extensive code for basic functionality
string path = "data.csv";
string[] lines = File.ReadAllLines(path);
foreach (string line in lines)
{
    // This breaks when CSV fields contain commas inside quotes
    string[] fields = line.Split(',');
    foreach (string field in fields)
    {
        Console.Write(field.Trim() + "\t");
    }
    Console.WriteLine();
}

using IronXL;

// IronXL approach -- handles all edge cases automatically
WorkBook workbook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: ",");
var records = workbook.DefaultWorkSheet.Rows;
foreach (var row in records)
{
    foreach (var cell in row)
    {
        Console.Write(cell.Value + "\t");
    }
    Console.WriteLine();
}

using IronXL;

// IronXL approach -- handles all edge cases automatically
WorkBook workbook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: ",");
var records = workbook.DefaultWorkSheet.Rows;
foreach (var row in records)
{
    foreach (var cell in row)
    {
        Console.Write(cell.Value + "\t");
    }
    Console.WriteLine();
}

다양한 CSV 구분 기호를 어떻게 처리하나요?

CSV 파일은 항상 쉼표를 구분 기호로 사용하지 않습니다. 유럽 시스템은 쉼표가 소수점에 나타나기 때문에 종종 세미콜론을 사용하여 내보냅니다. 탭으로 구분된 값(TSV) 및 파이프로 구분된 파일은 다양한 애플리케이션 및 레거시 시스템의 데이터 내보내기에서 정기적으로 나타납니다.

using IronXL;

// Reading a semicolon-delimited file (common in European exports)
WorkBook euroData = WorkBook.LoadCSV("german_report.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: ";");
// Reading a tab-separated file
WorkBook tsvData = WorkBook.LoadCSV("exported_data.tsv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: "\t");
// Reading a pipe-delimited file
WorkBook pipeData = WorkBook.LoadCSV("legacy_system.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: "|");
// Access data identically regardless of original delimiter
WorkSheet sheet = euroData.DefaultWorkSheet;
int rowsCount = sheet.RowCount;
Console.WriteLine($"Loaded {rowsCount} rows with {sheet.ColumnCount} CSV columns");

using IronXL;

// Reading a semicolon-delimited file (common in European exports)
WorkBook euroData = WorkBook.LoadCSV("german_report.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: ";");
// Reading a tab-separated file
WorkBook tsvData = WorkBook.LoadCSV("exported_data.tsv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: "\t");
// Reading a pipe-delimited file
WorkBook pipeData = WorkBook.LoadCSV("legacy_system.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: "|");
// Access data identically regardless of original delimiter
WorkSheet sheet = euroData.DefaultWorkSheet;
int rowsCount = sheet.RowCount;
Console.WriteLine($"Loaded {rowsCount} rows with {sheet.ColumnCount} CSV columns");

listDelimiter 파라미터는 LoadCSV 안에서 필드 구분자로 어떤 단일 문자나 이스케이프 시퀀스를 허용합니다. 탭 문자는 \t 이스케이프 시퀀스를 사용합니다. 로드 후 데이터 구조는 원본 형식과 관계없이 일관성을 유지하므로 다양한 구분 기호를 사용하는 여러 소스의 CSV 파일을 쉽게 처리할 수 있습니다. 대부분의 CSV 파일에 대한 기본값은 쉼표이지만 이 유연성은 프로젝트가 마주치는 모든 변화를 처리합니다.

CSV를 DataTable로 변환하는 가장 좋은 방법은 무엇입니까?

CSV 데이터를 DataTable로 변환하면 데이터베이스 작업 통합, UI 애플리케이션의 데이터 바인딩 및 LINQ 쿼리가 가능합니다. ToDataTable 메소드는 단일 호출로 이 변환을 수행합니다.

using IronXL;
using System.Data;

// Load CSV and convert to DataTable
WorkBook workbook = WorkBook.LoadCSV("customers.csv", ExcelFileFormat.XLSX, ",");
WorkSheet sheet = workbook.DefaultWorkSheet;
// Convert worksheet to DataTable -- true parameter uses CSV header as column names
DataTable dataTable = sheet.ToDataTable(true);
// DataTable is now ready for database operations, binding, or LINQ queries
Console.WriteLine($"DataTable created with {dataTable.Columns.Count} columns:");
foreach (DataColumn column in dataTable.Columns)
{
    // Property names from CSV header become column names
    Console.WriteLine($"  - {column.ColumnName}");
}
Console.WriteLine($"\nTotal records: {dataTable.Rows.Count}");
// Access data using standard DataTable syntax
foreach (DataRow row in dataTable.Rows)
{
    // Access by column index or name attribute
    string name = row["Name"].ToString();
    string email = row["Email"].ToString();
    Console.WriteLine($"Customer: {name}, Email: {email}");
}

using IronXL;
using System.Data;

// Load CSV and convert to DataTable
WorkBook workbook = WorkBook.LoadCSV("customers.csv", ExcelFileFormat.XLSX, ",");
WorkSheet sheet = workbook.DefaultWorkSheet;
// Convert worksheet to DataTable -- true parameter uses CSV header as column names
DataTable dataTable = sheet.ToDataTable(true);
// DataTable is now ready for database operations, binding, or LINQ queries
Console.WriteLine($"DataTable created with {dataTable.Columns.Count} columns:");
foreach (DataColumn column in dataTable.Columns)
{
    // Property names from CSV header become column names
    Console.WriteLine($"  - {column.ColumnName}");
}
Console.WriteLine($"\nTotal records: {dataTable.Rows.Count}");
// Access data using standard DataTable syntax
foreach (DataRow row in dataTable.Rows)
{
    // Access by column index or name attribute
    string name = row["Name"].ToString();
    string email = row["Email"].ToString();
    Console.WriteLine($"Customer: {name}, Email: {email}");
}

ToDataTable의 부울 파라미터는 첫 행을 컬럼 헤더(true)로 할지 데이터(false)로 할지를 결정합니다. true로 설정하면, 결과 DataTable의 열에는 CSV 파일의 헤더 이름이 들어가며, row["Name"] 같은 열 이름을 사용하여 직관적으로 데이터에 접근할 수 있게 해줍니다.

CSV 파일을 Excel 형식으로 변환하려면 어떻게 해야 합니까?

IronXL의 뛰어난 기능 중 하나는 CSV 데이터를 올바른 Excel 형식으로 변환하는 것입니다. 이것은 원래 평면 CSV 데이터에 수식, 서식, 차트 및 여러 워크시트를 추가할 수 있게 하며, 이는 CSV 출력만으로는 달성할 수 없는 것입니다.

using IronXL;

// Load CSV data from file path
string path = "quarterly_sales.csv";
WorkBook workbook = WorkBook.LoadCSV(path, ExcelFileFormat.XLSX, ",");
// Save as Excel XLSX format -- creates a new Excel file
workbook.SaveAs("quarterly_sales.xlsx");
// Alternative: Save as legacy XLS format for older Excel versions
workbook.SaveAs("quarterly_sales.xls");
Console.WriteLine("CSV successfully converted to Excel format");

using IronXL;

// Load CSV data from file path
string path = "quarterly_sales.csv";
WorkBook workbook = WorkBook.LoadCSV(path, ExcelFileFormat.XLSX, ",");
// Save as Excel XLSX format -- creates a new Excel file
workbook.SaveAs("quarterly_sales.xlsx");
// Alternative: Save as legacy XLS format for older Excel versions
workbook.SaveAs("quarterly_sales.xls");
Console.WriteLine("CSV successfully converted to Excel format");

SaveAs 메서드는 파일 확장자를 기반으로 출력 형식을 자동으로 결정합니다. XLSX는 Excel 2007 및 이후 버전과 호환되는 최신 Office Open XML 파일을 생성하며, 반면 XLS는 오래된 애플리케이션용 레거시 바이너리 교환 파일 형식 문서를 생성합니다.

CSV 데이터에서 특정 셀 값을 어떻게 액세스합니까?

모든 레코드를 반복적으로 넘기는 것 외에도 IronXL은 친숙한 Excel 스타일 주소를 사용하여 직접 셀에 액세스할 수 있습니다. 이는 다양한 데이터 유형에 걸쳐 대상 데이터 추출 및 안전한 값 검색을 가능하게 합니다.

using IronXL;

WorkBook workbook = WorkBook.LoadCSV("inventory.csv", ExcelFileFormat.XLSX, ",");
WorkSheet sheet = workbook.DefaultWorkSheet;
// Access specific cells using Excel-style addresses by index
string productName = sheet["A2"].StringValue;
int quantity = sheet["B2"].IntValue;
decimal price = sheet["C2"].DecimalValue;
Console.WriteLine($"Product: {productName}");
Console.WriteLine($"Quantity: {quantity}");
Console.WriteLine($"Price: ${price:F2}");
// Access a range of cells -- return records from column A
var productRange = sheet["A2:A10"];
Console.WriteLine("\nAll products:");
foreach (var cell in productRange)
{
    Console.WriteLine($"  - {cell.StringValue}");
}

using IronXL;

WorkBook workbook = WorkBook.LoadCSV("inventory.csv", ExcelFileFormat.XLSX, ",");
WorkSheet sheet = workbook.DefaultWorkSheet;
// Access specific cells using Excel-style addresses by index
string productName = sheet["A2"].StringValue;
int quantity = sheet["B2"].IntValue;
decimal price = sheet["C2"].DecimalValue;
Console.WriteLine($"Product: {productName}");
Console.WriteLine($"Quantity: {quantity}");
Console.WriteLine($"Price: ${price:F2}");
// Access a range of cells -- return records from column A
var productRange = sheet["A2:A10"];
Console.WriteLine("\nAll products:");
foreach (var cell in productRange)
{
    Console.WriteLine($"  - {cell.StringValue}");
}

셀 주소 지정은 CSV 열을 나타내는 문자(A, B, C) 및 행 인덱스 위치를 나타내는 숫자(1, 2, 3)를 따르는 Excel 관행을 따릅니다. 셀 클래스는 StringValue, IntValue, DecimalValue, BoolValue, 및 DateTimeValue을 포함한 유형별 접근자를 제공합니다. 이러한 접근기는 구문 분석 및 변환을 자동으로 처리하여 모든 것을 문자열 값으로 저장하는 것과 비교하여 수동 타입 캐스팅을 제거합니다.

A2:A10과 같은 표기법을 사용한 범위 선택은 반복, 집계 함수 및 대량 작업을 지원하는 Range 객체를 반환합니다. 이것은 특정 열이나 대형 CSV 파일에서 직사각형 데이터 영역을 추출할 때 유용합니다. 예를 들어 특정 열에서 값 목록을 작성하거나 필터링된 데이터를 다른 파일에 쓸 수 있습니다. 다양한 패턴은 IronXL 범위 가이드를 참조하십시오.

CSV 파일을 읽을 때 오류를 어떻게 처리합니까?

운영 애플리케이션은 파일 작업에 대한 방어적 코드를 요구합니다. CSV 읽기가 실패하는 데는 여러 가지 이유가 있습니다: 파일이 존재하지 않거나, 액세스가 거부되거나, 데이터가 잘못되어 있거나, 매우 큰 파일의 경우 메모리가 부족합니다. IronXL 호출을 try/catch 블록으로 감싸고 로딩 전에 경로를 검증하면 다양한 환경에서 안정적인 동작을 보장합니다.

using IronXL;
using System.IO;

string filePath = "customers.csv";
if (!File.Exists(filePath))
{
    Console.WriteLine($"File not found: {filePath}");
    return;
}
try
{
    WorkBook workbook = WorkBook.LoadCSV(filePath, ExcelFileFormat.XLSX, ",");
    WorkSheet sheet = workbook.DefaultWorkSheet;
    DataTable dataTable = sheet.ToDataTable(true);
    Console.WriteLine($"Loaded {dataTable.Rows.Count} records successfully.");
}
catch (IronXl.Exceptions.IronXLException ex)
{
    Console.WriteLine($"IronXL parsing error: {ex.Message}");
}
catch (IOException ex)
{
    Console.WriteLine($"File access error: {ex.Message}");
}
catch (Exception ex)
{
    Console.WriteLine($"Unexpected error: {ex.Message}");
}

using IronXL;
using System.IO;

string filePath = "customers.csv";
if (!File.Exists(filePath))
{
    Console.WriteLine($"File not found: {filePath}");
    return;
}
try
{
    WorkBook workbook = WorkBook.LoadCSV(filePath, ExcelFileFormat.XLSX, ",");
    WorkSheet sheet = workbook.DefaultWorkSheet;
    DataTable dataTable = sheet.ToDataTable(true);
    Console.WriteLine($"Loaded {dataTable.Rows.Count} records successfully.");
}
catch (IronXl.Exceptions.IronXLException ex)
{
    Console.WriteLine($"IronXL parsing error: {ex.Message}");
}
catch (IOException ex)
{
    Console.WriteLine($"File access error: {ex.Message}");
}
catch (Exception ex)
{
    Console.WriteLine($"Unexpected error: {ex.Message}");
}

메모리 문제 없이 큰 CSV 파일을 읽는 방법은 무엇입니까?

수십만 개의 행이 있는 파일의 경우 전체 데이터를 메모리에 한 번에 로드하는 것은 비실용적일 수 있습니다. IronXL은 전체 파일을 WorkBook 객체에 읽어들이며, 이는 모든 데이터를 메모리에 유지합니다. 대규모 ETL(추출, 변환, 적재) 시나리오의 경우, 실용적인 전략은 소스 파일을 로딩 전에 분할하여 CSV를 배치 처리하거나 StreamReader에서 행을 스트리밍하여 별도의 워크북에 청크를 기록하는 것입니다.

IronXL의 엑셀 파일 읽기에 대한 문서는 대규모 작업의 성능 고려 사항을 다룹니다. CSV의 경우, CSV 형식의 라인별 구조로 인해 데이터셋이 단일 메모리 로드에 대해 너무 클 때 수동 배치와 간단한 File.ReadAllLines이 예측 가능한 메모리 사용량을 제공합니다.

다음 단계는 무엇입니까?

.NET에서 CSV 파일을 읽는 것은 올바른 접근 방식을 사용할 때 최소한의 노력이 필요합니다. IronXL의 LoadCSV 메서드는 자동으로 구문 분석의 복잡성을 처리하며, 다양한 구분자를 지원하고, 구조화된 데이터에 즉시 접근 가능하며, 단일 메서드 호출로 엑셀이나 DataTable로 변환합니다. ASP.NET Core 애플리케이션, .NET Core 웹 API, 또는 콘솔 프로젝트를 구축하든, 라이브러리는 CSV 처리를 시작부터 끝까지 단순화합니다.

여기서 배운 것을 확장하기 위해 더 많은 IronXL 기능을 탐색해보세요:

• IronXL 제품 페이지 -- 전체 기능 목록 및 라이선스
• C#에서 엑셀 파일을 읽는 방법 -- CSV 기술을 XLSX/XLS로 확장하기
• C#에서 엑셀 파일을 작성하는 방법 -- 스프레드시트를 프로그래밍 방식으로 생성하고 내보내기
• DataTable 및 DataSet 내보내기 -- ADO.NET 워크플로우에 연결하기
• IronXL 라이선스 -- 배포를 위한 라이선스 옵션

무료 체험판 시작하여 IronXL이 .NET 프로젝트에서 CSV 파일을 읽는 방법을 어떻게 단순화하는지 경험해보세요. 프로덕션 배포를 위해 라이선스 옵션은 영구 사용 권리와 1년간의 지원을 포함합니다.