ایجاد اسناد ورد سفارشی با استفاده از C# .NET | افزونه ادغام نامه Aspose.Words

خودکارسازی تولید مستندات برای کسب‌وکارهایی که به دنبال ایجاد گزارش‌ها، فاکتورها و نامه‌های پویا هستند، بسیار حیاتی است. با Aspose.Words Mail Merge for .NET، می‌توانید به‌طور مؤثر الگوهای Word را با داده‌های موجود در منابع مختلف، از جمله اشیاء، CSV، JSON و XML پر کنید. این راهنما شما را در استفاده از Mail Merge در C# برای جریان‌های کاری مستندات خودکار و بهینه راهنمایی می‌کند و بر ایجاد مستندات Word پویا با C# .NET تمرکز دارد.

فهرست مطالب

• مروری بر Mail Merge برای .NET
• تولید مستندات از منابع داده مختلف
  • استفاده از اشیاء C#
  • استفاده از XML
  • استفاده از JSON
  • استفاده از CSV
• بهترین شیوه‌ها برای Mail Merge
• سؤالات متداول

مروری بر Mail Merge برای .NET

افزونه Aspose.Words Mail Merge for .NET به توسعه‌دهندگان این امکان را می‌دهد که مستندات شخصی‌سازی شده را از الگوهای از پیش تعریف شده حاوی فیلدهای ادغام ایجاد کنند. این ادغام به‌گونه‌ای طراحی شده است که در محیط‌های .NET به‌طور یکپارچه استفاده شود و قابلیت‌هایی را ارائه می‌دهد تا:

• الگوها را به‌طور پویا با داده‌ها پر کنید و از تولید مستندات Word در فریم‌ورک .NET پشتیبانی کنید.
• به‌طور مؤثر تولید مستندات انبوه را انجام دهید و از راه‌حل Mail Merge .NET برای مستندات Word بهره ببرید.
• اطمینان حاصل کنید که فرمت‌ها در خروجی‌ها یکسان هستند و بهترین شیوه‌های الگوهای مستندات Word C# را بهبود ببخشید.

ویژگی‌های کلیدی:

1. پشتیبانی از چند منبع: از داده‌های اشیاء، پایگاه‌های داده، XML، JSON و CSV برای ایجاد مستندات Word سفارشی با C# استفاده کنید.
2. عملکرد بالا: به‌طور مؤثر داده‌های بزرگ و عملیات انبوه را برای تولید مستندات Word پویا با .NET Core مدیریت کنید.
3. الگوهای قابل تنظیم: الگوهایی با جای‌گذاری برای درج داده‌ها ایجاد کنید و از قابلیت‌های خودکارسازی Mail Merge Word در .NET بهره ببرید.

راه‌اندازی

برای شروع، Aspose.Words را با استفاده از NuGet نصب کنید:

PM> Install-Package Aspose.Words

تولید مستند Word از الگو با استفاده از اشیاء C#

بیایید با پر کردن یک الگوی Word با استفاده از اشیاء C# شروع کنیم. ما یک مستند Word (DOC/DOCX) با جای‌گذاری‌های زیر ایجاد خواهیم کرد:

<<[sender.Name]>> says: "<<[sender.Message]>>."

در این مثال، sender یک نمونه از کلاسی است که ما از آن برای پر کردن الگو با استفاده از رویکرد تولید مستند Word از پایگاه داده C# استفاده خواهیم کرد.

سپس، ما از موتور گزارش‌گیری Aspose.Words برای تولید مستند Word از الگو و نمونه کلاس Sender با دنبال کردن مراحل زیر استفاده خواهیم کرد:

1. یک نمونه از کلاس Document ایجاد کرده و آن را با مسیر الگوی Word مقداردهی اولیه کنید.
2. یک شیء از کلاس Sender ایجاد و مقداردهی اولیه کنید.
3. کلاس ReportingEngine را نمونه‌سازی کنید.
4. الگو را با استفاده از ReportingEngine.BuildReport() پر کنید که نمونه Document، منبع داده و نام منبع داده را به عنوان پارامتر می‌گیرد.
5. مستند Word تولید شده را با استفاده از Document.Save() ذخیره کنید.

در اینجا نمونه کدی است که نحوه تولید یک مستند Word از یک الگو را در C# نشان می‌دهد.

خروجی

تولید مستند Word از منبع داده XML در C#

برای تولید یک مستند Word از منبع داده XML، ما از یک الگوی Word پیچیده‌تر با جای‌گذاری‌های زیر استفاده خواهیم کرد:

<<foreach [in persons]>>Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.Average(p => p.Age)]>>

منبع داده XML استفاده شده در این مثال در زیر نشان داده شده است.

برای ایجاد یک مستند Word از منبع داده XML، مراحل زیر را دنبال کنید:

1. یک نمونه از کلاس Document ایجاد کرده و آن را با مسیر الگوی Word مقداردهی اولیه کنید.
2. یک نمونه از کلاس XmlDataSource ایجاد کرده و آن را با مسیر فایل XML مقداردهی اولیه کنید.
3. کلاس ReportingEngine را نمونه‌سازی کنید.
4. از روش ReportingEngine.BuildReport() برای پر کردن الگوی Word استفاده کنید.
5. مستند Word تولید شده را با استفاده از روش Document.Save() ذخیره کنید.

در اینجا نمونه کدی است که نحوه تولید یک مستند Word از یک منبع داده XML را در C# نشان می‌دهد.

خروجی

تولید مستند Word از منبع داده JSON در C#

در مرحله بعد، بیایید بررسی کنیم که چگونه می‌توان یک مستند Word را با استفاده از منبع داده JSON تولید کرد. در این مثال، ما یک لیست از مشتریان را که بر اساس مدیرانشان تقسیم‌بندی شده‌اند، ایجاد خواهیم کرد. الگوی Word به شکل زیر خواهد بود:

<<foreach [in managers]>>Manager: <<[Name]>>
Contracts:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>

منبع داده JSON مربوطه که برای پر کردن الگو استفاده خواهیم کرد در زیر آمده است:

برای تولید مستند Word از JSON، ما از کلاس JsonDataSource برای بارگذاری منبع داده استفاده خواهیم کرد و مراحل باقی‌مانده مشابه ساختار قبلی خواهد بود. در اینجا نمونه کدی است که نحوه تولید یک مستند Word از الگوی JSON را در C# نشان می‌دهد.

خروجی

تولید مستند Word از منبع داده CSV در C#

برای تولید مستند Word از یک منبع CSV، ما از الگوی Word زیر استفاده خواهیم کرد:

<<foreach [in persons]>>Name: <<[Column1]>>, Age: <<[Column2]>>, Date of Birth: <<[Column3]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.Average(p => p.Column2)]>>

الگو با استفاده از داده‌های CSV زیر پر خواهد شد:

حال، بیایید کد C# را مرور کنیم. مراحل مشابه باقی می‌مانند به جز یک تفاوت کلیدی: ما از کلاس CsvDataSource برای بارگذاری داده‌های CSV استفاده خواهیم کرد. نمونه کد زیر نحوه تولید مستند Word از یک منبع داده CSV را نشان می‌دهد.

خروجی

آزمایش رایگان Aspose.Words برای .NET

شما می‌توانید Aspose.Words for .NET را با استفاده از یک مجوز موقت رایگان آزمایش کنید.

نتیجه‌گیری

در این مقاله، شما یاد گرفتید که چگونه می‌توان مستندات Word را از الگوها با استفاده از C# تولید کرد. شما بررسی کردید که چگونه می‌توان از منابع داده مختلف مانند اشیاء، XML، JSON و CSV برای تولید مستندات پویا در .NET بهره برد. برای کسب اطلاعات بیشتر در مورد قابلیت‌های پردازش الگوهای Word در .NET، به مستندات مراجعه کنید و در صورت تمایل از طریق فروم ما با ما تماس بگیرید.