ทำงานกับค่าที่คั่นด้วยตัวคั่น (DSV) – สร้างเอกสารที่แก้ไขได้

หากคุณเป็นนักพัฒนา .NET ที่ต้องการ create editable document จากค่าที่คั่นด้วยตัวคั่น (DSV) เช่น CSV หรือ TSV คุณมาถูกที่แล้ว ใน 100 คำแรกเราจะอธิบายว่าทำไม GroupDocs.Editor for .NET จึงเป็นวิธีที่เชื่อถือได้ที่สุดในการ read delimited text C#, แก้ไขมัน, แล้วบันทึกกลับโดยไม่สูญเสียรูปแบบ คุณจะได้เวิร์กโฟลว์ที่พร้อมคัดลอก‑และ‑วางซึ่งเข้ากันได้อย่างธรรมชาติในโซลูชัน Visual Studio ใด ๆ

คำตอบสั้น

  • ไลบรารีใดจัดการการแก้ไข CSV ได้ดีที่สุดใน .NET? GroupDocs.Editor for .NET.
  • ฉันสามารถแก้ไขไฟล์ CSV ขนาดใหญ่ใน Visual Studio ได้หรือไม่? ใช่ – API สตรีมข้อมูลและหลีกเลี่ยงการโหลดไฟล์ทั้งหมดเข้าสู่หน่วยความจำ.
  • ฉันต้องการใบอนุญาตสำหรับการใช้งานในผลิตภัณฑ์หรือไม่? จำเป็นต้องมีใบอนุญาตเชิงพาณิชย์; มีรุ่นทดลองฟรีให้ใช้.
  • ฉันสามารถส่งออกเป็นรูปแบบใดได้หลังจากแก้ไข? CSV, TSV, และรูปแบบสเปรดชีตที่เข้ากันกับ Excel.
  • API รองรับ .NET 6+ หรือไม่? แน่นอน – รองรับ .NET Framework 4.5+, .NET Core 3.1+, .NET 5, และ .NET 6.

อะไรคือ “create editable document” ในบริบทของ GroupDocs.Editor?

Create editable document หมายถึงการสร้างอินสแตนซ์ EditableDocument ที่เป็นตัวแทนของเวอร์ชันที่สามารถแก้ไขได้ของไฟล์ต้นฉบับ (CSV, TSV ฯลฯ) ในหน่วยความจำ วัตถุนี้ทำให้คุณสามารถอ่าน, แก้ไข, และบันทึกเนื้อหาใหม่โดยใช้ API เดียวกัน มันมีเมธอดสำหรับดึงข้อความของเอกสาร, ประยุกต์การเปลี่ยนแปลง, และบันทึกกลับในรูปแบบต่าง ๆ เพื่อให้การจัดแนวคอลัมน์และการใส่เครื่องหมายคำพูดถูกเก็บรักษาไว้

ทำไมต้องใช้ GroupDocs.Editor สำหรับการจัดการ DSV?

GroupDocs.Editor ประมวลผล more than 50 input and output formats รวมถึง CSV, TSV, และสเปรดชีตที่เข้ากันกับ Excel โดยใช้หน่วยความจำน้อยกว่า 10 MB สำหรับไฟล์ขนาดสูงสุด 500 MB นอกจากนี้ยังรักษาการจัดแนวคอลัมน์, กฎการใส่เครื่องหมายคำพูด, และการเข้ารหัสแบบกำหนดเองโดยอัตโนมัติ ซึ่งช่วยขจัดความจำเป็นในการเขียนตรรกะการแยกข้อมูลด้วยตนเอง

ข้อกำหนดเบื้องต้น

  • Visual Studio (รุ่นล่าสุดใดก็ได้) – คุณจะพัฒนาและดีบักโดยตรงใน IDE
  • GroupDocs.Editor for .NET – ดาวน์โหลดแพ็กเกจล่าสุด ที่นี่
  • Basic C# knowledge – บทแนะนำนี้สมมติว่าคุณสามารถสร้างโปรเจกต์คอนโซลหรือ ASP.NET และเพิ่มแพ็กเกจ NuGet

นำเข้า Namespaces

คลาส Editor, EditableDocument และคลาสตัวเลือกอยู่ใน namespace GroupDocs.Editor
คลาส DelimitedTextEditOptions เป็นจุดเริ่มต้นสำหรับกำหนดตัวคั่น (คอมม่า, แท็บ ฯลฯ) และกฎการแยกข้อมูลอื่น ๆ

using System.Collections.Generic;
using System.IO;
using GroupDocs.Editor.Formats;
using GroupDocs.Editor.HtmlCss.Resources;
using GroupDocs.Editor.Options;

วิธีสร้างเอกสารที่แก้ไขได้จากไฟล์ CSV?

โหลดไฟล์ CSV ต้นฉบับด้วย Editor แล้วเรียกเมธอด Edit โดยส่งอินสแตนซ์ DelimitedTextEditOptions ที่ระบุตัวคั่นเป็นคอมม่า เมธอดจะคืนค่า EditableDocument ที่คุณสามารถจัดการในหน่วยความจำ รูปแบบสองขั้นตอนนี้—load → edit—ครอบคลุมสถานการณ์ read delimited text C# และรับประกันว่ารูปแบบไฟล์ต้นฉบับจะถูกเก็บไว้

ขั้นตอนที่ 1: รับเส้นทางไปยังไฟล์ DSV อินพุต

แรกสุด คุณต้องระบุเส้นทางแบบ absolute หรือ relative ไปยังไฟล์ DSV ต้นฉบับ สำหรับการสาธิตเราจะใช้ CSV อย่างง่ายที่อยู่ในโฟลเดอร์ Data ของโปรเจกต์

string inputFilePath = "Your Sample Document";

ขั้นตอนที่ 2: สร้างอินสแตนซ์ Editor

Editor คือคลาสหลักที่จัดการการโหลด, การแก้ไข, และการบันทึก การสร้างอินสแตนซ์โดยใช้อ็อบเจ็กต์ FileInfo จะให้คุณควบคุมวงจรชีวิตของไฟล์ได้อย่างเต็มที่

using (Editor editor = new Editor(inputFilePath))
{

ขั้นตอนที่ 3: สร้าง DSV Edit Options

DelimitedTextEditOptions บอกให้ editor ทราบวิธีการตีความไฟล์ คุณสามารถตั้งค่าตัวคั่น, ว่าแถวแรกเป็นหัวตารางหรือไม่, และการเข้ารหัสอักขระ

    Options.DelimitedTextEditOptions editOptions = new DelimitedTextEditOptions(",");
    editOptions.ConvertDateTimeData = false;
    editOptions.ConvertNumericData = true;
    editOptions.TreatConsecutiveDelimitersAsOne = true;

ขั้นตอนที่ 4: สร้างอินสแตนซ์ EditableDocument

EditableDocument แสดงเวอร์ชันที่สามารถแก้ไขได้ในหน่วยความจำของไฟล์ต้นฉบับ การเรียก Editor.Edit พร้อมตัวเลือกจะคืนค่า EditableDocument วัตถุนี้เก็บข้อความของไฟล์ในสตริงที่แก้ไขได้ พร้อมสำหรับการทำงาน parse delimited values C# ใด ๆ ที่คุณต้องการ

    EditableDocument beforeEdit = editor.Edit(editOptions);

ขั้นตอนที่ 5: แก้ไขเนื้อหาเอกสาร

GetDocumentText() คืนข้อความปัจจุบันของเอกสารที่แก้ไขได้เป็นสตริง ดึงข้อความต้นฉบับโดยใช้ EditableDocument.GetDocumentText(), ทำการแก้ไขของคุณ (เช่น แทนค่าคอลัมน์) และเก็บผลลัพธ์ในสตริงใหม่ นี่คือจุดที่คุณ edit CSV .NET โดยไม่ต้องสัมผัสสตรีมไฟล์ระดับต่ำ

    string originalTextContent = beforeEdit.GetContent();
    string updatedTextContent = originalTextContent.Replace("SsangYong", "Chevrolet").Replace("Kyron", "Camaro");
    List<IHtmlResource> allResources = beforeEdit.AllResources;

ขั้นตอนที่ 6: สร้าง EditableDocument ด้วยเนื้อหาที่อัปเดต

ห่อสตริงที่แก้ไขแล้วกลับเป็น EditableDocument ขั้นตอนนี้สรุปการเปลี่ยนแปลงและเตรียมวัตถุสำหรับการบันทึกในรูปแบบที่รองรับใด ๆ

    EditableDocument afterEdit = EditableDocument.FromMarkup(updatedTextContent, allResources);

ขั้นตอนที่ 7: สร้าง CSV Save Options

DelimitedTextSaveOptions ระบุวิธีการเขียนเนื้อหาที่แก้ไขกลับเป็นไฟล์ CSV เมื่อคุณพร้อมบันทึกการเปลี่ยนแปลง ให้กำหนดค่า DelimitedTextSaveOptions คุณสามารถระบุตัวคั่นเดียวกัน, ตัวคั่นอื่น, หรือแม้แต่เปลี่ยนรูปแบบการจบบรรทัด

    Options.DelimitedTextSaveOptions csvSaveOptions = new DelimitedTextSaveOptions(",");
    csvSaveOptions.Encoding = System.Text.Encoding.UTF8;

ขั้นตอนที่ 8: สร้าง TSV Save Options

หากคุณต้องการเวอร์ชันที่คั่นด้วยแท็บ เพียงเปลี่ยนตัวคั่นเป็น \t EditableDocument เดียวกันสามารถบันทึกหลายครั้งด้วยตัวเลือกที่แตกต่างกัน

    Options.DelimitedTextSaveOptions tsvSaveOptions = new DelimitedTextSaveOptions("\t");
    tsvSaveOptions.Encoding = System.Text.Encoding.UTF8;

ขั้นตอนที่ 9: สร้าง Spreadsheet Save Options

SpreadsheetSaveOptions กำหนดการส่งออกเอกสารเป็นรูปแบบที่เข้ากันกับ Excel เช่น .xlsx GroupDocs.Editor ยังให้คุณส่งออกข้อมูลที่แก้ไขเป็นรูปแบบที่เข้ากันกับ Excel (.xlsx) คลาส SpreadsheetSaveOptions จัดการประเภทคอลัมน์, สูตร, และการจัดรูปแบบเซลล์โดยอัตโนมัติ

    Options.SpreadsheetSaveOptions cellsSaveOptions = new SpreadsheetSaveOptions(SpreadsheetFormats.Xlsm);

ขั้นตอนที่ 10: เตรียมเส้นทางการบันทึก

กำหนดเส้นทางการออกผลที่แตกต่างกันสำหรับแต่ละรูปแบบ การใช้แนวทางการตั้งชื่อที่ชัดเจน (เช่น output.csv, output.tsv, output.xlsx) ช่วยให้โครงการของคุณเป็นระเบียบ

    string outputCsvPath = Path.Combine(Constants.GetOutputDirectoryPath(inputFilePath), Path.GetFileNameWithoutExtension(inputFilePath) + ".csv");
    string outputTsvPath = Path.Combine(Constants.GetOutputDirectoryPath(inputFilePath), Path.GetFileNameWithoutExtension(inputFilePath) + ".tsv");
    string outputCellsPath = Path.Combine(Constants.GetOutputDirectoryPath(inputFilePath), Path.GetFileNameWithoutExtension(inputFilePath) + ".xlsm");

ขั้นตอนที่ 11: บันทึกเอกสารที่แก้ไขแล้ว

Save() เขียนเอกสารลงดิสก์โดยใช้ตัวเลือกการบันทึกที่ให้ไว้ เรียก EditableDocument.Save พร้อมตัวเลือกที่เหมาะสมสำหรับแต่ละรูปแบบเป้าหมาย API จะเขียนไฟล์โดยตรงลงดิสก์ โดยคงการเข้ารหัสต้นฉบับไว้ เว้นแต่คุณจะกำหนดทับ

    editor.Save(afterEdit, outputCsvPath, csvSaveOptions);
    editor.Save(afterEdit, outputTsvPath, tsvSaveOptions);
    editor.Save(afterEdit, outputCellsPath, cellsSaveOptions);

ขั้นตอนที่ 12: ปล่อย (Dispose) อินสแตนซ์ EditableDocument

Editor และ EditableDocument ทั้งสอง implements IDisposable การปล่อย (Dispose) พวกมันจะปล่อยตัวจัดการไฟล์และทรัพยากรที่ไม่ได้จัดการ ซึ่งสำคัญเมื่อประมวลผลไฟล์จำนวนมากในงานแบบแบตช์

    beforeEdit.Dispose();
    afterEdit.Dispose();
}
System.Console.WriteLine("WorkingWithDsv routine has successfully finished");

ปัญหาทั่วไปและวิธีแก้

ปัญหาสาเหตุวิธีแก้
เครื่องหมายคำพูดพิเศษที่ไม่คาดคิดตัวแยก CSV เริ่มต้นอาจถือคอมม่าในข้อความเป็นตัวคั่น.ตั้งค่า EscapeMode = EscapeMode.DoubleQuote ใน DelimitedTextEditOptions.
การใช้หน่วยความจำสูงเมื่อไฟล์ใหญ่โหลดไฟล์ขนาด 500 MB โดยไม่ใช้การสตรีม.ใช้ Editor.Load พร้อม LoadOptions ที่เปิดใช้งานการโหลดแบบ lazy.
การไม่ตรงกันของการเข้ารหัสไฟล์ต้นฉบับใช้ UTF‑16 แต่ตัวเลือกตั้งค่าเริ่มต้นเป็น UTF‑8.ตั้งค่า Encoding = Encoding.Unicode อย่างชัดเจนในตัวเลือกการบันทึก.

คำถามที่พบบ่อย

ถาม: ฉันสามารถใช้ GroupDocs.Editor for .NET เพื่อแก้ไขไฟล์ CSV ขนาดใหญ่ได้หรือไม่?
ตอบ: ใช่, API สตรีมข้อมูลและสามารถจัดการไฟล์ที่ใหญ่กว่า 1 GB ได้โดยไม่โหลดเอกสารทั้งหมดเข้าสู่หน่วยความจำ.

ถาม: GroupDocs.Editor for .NET รองรับรูปแบบ DSV อื่น ๆ นอกจาก CSV และ TSV หรือไม่?
ตอบ: แน่นอน – ตัวคั่นที่เป็นอักขระเดียวใดก็ได้ (เช่น pipe |, semicolon ;) จะได้รับการสนับสนุนตราบใดที่คุณระบุใน DelimitedTextEditOptions.

ถาม: สามารถปรับแต่งการเข้ารหัสเมื่อบันทึกไฟล์ DSV ได้หรือไม่?
ตอบ: ได้, คุณสามารถตั้งค่า property Encoding ใน DelimitedTextSaveOptions ให้เป็น UTF‑8, UTF‑16, ISO‑8859‑1 หรือ Encoding ของ .NET ใด ๆ ที่คุณต้องการ.

ถาม: ฉันสามารถแปลงไฟล์ CSV เป็นสเปรดชีต Excel ด้วย GroupDocs.Editor for .NET ได้หรือไม่?
ตอบ: ได้ – หลังจากแก้ไขแล้ว เพียงใช้ SpreadsheetSaveOptions เพื่อส่งออกเนื้อหาเป็นไฟล์เวิร์กบุ๊ก .xlsx.

ถาม: ฉันจะหาเอกสารเพิ่มเติมเกี่ยวกับ GroupDocs.Editor for .NET ได้จากที่ไหน?
ตอบ: อ้างอิง API รายละเอียดและตัวอย่างโค้ดมีให้ ที่นี่.

อัปเดตล่าสุด: 2026-06-06
ทดสอบด้วย: GroupDocs.Editor 23.10 for .NET
ผู้เขียน: GroupDocs

บทแนะนำที่เกี่ยวข้อง