Cipta Dokumen Word yang Diformat dengan Baik dalam C# pada macOS daripada JSON

Penjanaan Dokumen Word Dinamik daripada Data JSON

Menggunakan pendekatan berasaskan templat dengan ruang letak, dilaksanakan dalam C# untuk macOS dalam .NET 8

// Import necessary libraries
using System;
using System.IO;
using Newtonsoft.Json;
using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Wordprocessing;
// Define the data model for employees
public class Employee
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string DateOfBirth { get; set; }
}
// Main program
class Program
{
    static void Main(string[] args)
    {
        // Load JSON data
        string jsonFilePath = "employees.json";
        var employees = JsonConvert.DeserializeObject<List<Employee>>(File.ReadAllText(jsonFilePath));
        // Define template path and output path
        string templatePath = "template.docx";
        string outputPath = "output.docx";
        // Open the Word template
        using (var wordDoc = WordprocessingDocument.Open(templatePath, true))
        {
            var body = wordDoc.MainDocumentPart.Document.Body;
            // Replace placeholders
            foreach (var employee in employees)
            {
                foreach (var text in body.Descendants<Text>())
                {
                    text.Text = text.Text.Replace("{FirstName}", employee.FirstName)
                                          .Replace("{LastName}", employee.LastName)
                                          .Replace("{DateOfBirth}", employee.DateOfBirth);
                }
            }
        }
        // Save as a new file
        File.Copy(templatePath, outputPath, true);
        Console.WriteLine("Document generated successfully!");
    }
}

Hasilkan Dokumen Word Secara Pengaturcaraan Tanpa Templat

Menggunakan pendekatan berasaskan kod tulen dengan Open XML SDK dalam C#

// Import necessary libraries
using System;
using System.IO;
using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Wordprocessing;
using Newtonsoft.Json;
// Define the data model for employees
public class Employee
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string DateOfBirth { get; set; }
}
// Main program
class Program
{
    static void Main(string[] args)
    {
        // Load JSON data
        string jsonFilePath = "employees.json";
        var employees = JsonConvert.DeserializeObject<List<Employee>>(File.ReadAllText(jsonFilePath));
        // Define output path
        string outputPath = "output_from_code.docx";
        // Create Word document
        using (var wordDoc = WordprocessingDocument.Create(outputPath, DocumentFormat.OpenXml.WordprocessingDocumentType.Document))
        {
            // Add a main document part
            var mainPart = wordDoc.AddMainDocumentPart();
            mainPart.Document = new Document();
            var body = mainPart.Document.AppendChild(new Body());
            // Add content for each employee
            foreach (var employee in employees)
            {
                var para = body.AppendChild(new Paragraph());
                var run = para.AppendChild(new Run());
                run.AppendChild(new Text($"Name: {employee.FirstName} {employee.LastName}, DOB: {employee.DateOfBirth}"));
            }
        }
        Console.WriteLine("Document generated successfully!");
    }
}

Soalan Lazim Mengenai Mengautomasikan Dokumen Word

1. Apakah perpustakaan terbaik untuk bekerja dengan dokumen Word dalam C#?
2. The Open XML SDK secara meluas dianggap sebagai pilihan yang paling mantap untuk memanipulasi dokumen Word secara pengaturcaraan.
3. Bagaimanakah saya menggantikan ruang letak dalam templat Word?
4. Anda boleh gunakan Text.Replace untuk mencari dan menggantikan ruang letak seperti {FirstName} dengan kandungan dinamik.
5. Apakah yang berlaku jika fail JSON saya mengandungi data yang tidak dijangka?
6. menggunakan JsonConvert.DeserializeObject dengan pengesahan memastikan bahawa data JSON anda diproses dengan betul, walaupun ia termasuk medan yang tidak dijangka.
7. Bolehkah saya menambah imej pada dokumen Word saya secara pemrograman?
8. Ya, anda boleh membenamkan imej menggunakan ImagePart dalam Open XML SDK untuk menambah logo atau foto secara dinamik.
9. Bagaimanakah saya boleh memastikan dokumen saya sepadan dengan penjenamaan korporat?
10. Sediakan templat praformat yang merangkumi gaya tersuai, fon dan warna, yang boleh digunakan oleh skrip anda untuk menjana dokumen.
11. Adakah mungkin untuk mengendalikan data JSON bersarang?
12. Anda boleh praproses JSON untuk meratakan objek bersarang atau menggunakan gelung untuk mengisi berbilang ruang letak secara dinamik dalam dokumen Word.
13. Pendekatan manakah yang lebih baik untuk dokumen kompleks: templat atau berasaskan kod?
14. Templat secara amnya lebih baik untuk reka bentuk yang kompleks, manakala pendekatan berasaskan kod sesuai untuk struktur yang lebih ringkas atau penyesuaian yang tinggi.
15. Bagaimanakah saya boleh mengelakkan tiruan templat asal?
16. guna File.Copy untuk menyimpan output sebagai fail baharu, mengekalkan templat asal anda.
17. Bolehkah saya menjana berbilang dokumen Word serentak?
18. Ya, anda boleh mengulangi data JSON anda, mencipta dokumen baharu untuk setiap entri menggunakan gelung dalam skrip anda.
19. Apakah IDE terbaik untuk aliran kerja ini?
20. Walaupun anda boleh menggunakan Visual Studio atau Visual Studio Code, yang kedua adalah ringan dan berfungsi dengan baik dengan macOS.

Membuat Dokumen Word Dinamik dengan JSON dan C#

Pendekatan berasaskan templat menonjol kerana fleksibiliti dan kemudahan penggunaannya, terutamanya untuk mencipta dokumen profesional yang direka bentuk dengan baik. Dengan menggabungkan pemformatan manual dan pemasukan data automatik, anda boleh menjimatkan masa sambil mengekalkan kualiti dan konsistensi. 📝

Sebagai alternatif, menjana dokumen Word secara pemrograman dari awal menawarkan penyesuaian yang lebih besar tetapi memerlukan lebih banyak usaha untuk pemformatan terperinci. Dengan alatan seperti Open XML SDK, kaedah ini sangat baik untuk dokumen mudah atau berulang dengan pelarasan gaya yang minimum. Pilih kaedah yang selaras dengan aliran kerja anda. 🚀