Aspose.Words ادغام ایمیل برای .NET
Aspose.Words Mail Merge برای .NET پلاگین به توسعه دهندگان اجازه می دهد تا اسناد سفارشی – مانند ایمیل ها، صورتحسابها، دایرکتوری های، برچسب ها و گزارش ها – را با تعریف یک قالب واحد و جمع آوری آن با داده های پویا ایجاد کنند.
نصب و نصب
- نصب Aspose.Words برای بسته .NET از طریق NuGet یا کنسول مدیریت بسته. ( راهنمای نصب )
- تنظیم مقدار مجوز قبل از انجام عملیات پیوستن به ایمیل. ( مجوز متریکی )
- ارجاع Aspose.Words.dll در پروژه شما.
سازگار با Windows، لینوکس، macOS و پلتفرم های تلفن همراه با استفاده از .NET Framework، .NET Core یا Mono. IDEs پشتیبانی شده شامل Visual Studio (2010-2022)، Xamarin و ManoDevelop است.
ویژگی ها و ویژگی های کلیدی
نسل مستند مبتنی بر قالب
- قالب ها را در DOCX، DOC، RTF یا HTML ایجاد کنید.
- اضافه کردن ** میدان های مخلوط** (به عنوان مثال.,
«FieldName»
) برای نمایندگی از داده های پویا میزبان. - قالب ها را در چند مورد استفاده قابل استفاده و قابل نگهداری نگه دارید.
محدوده داده های جمعیت
- فیلد های ترکیبی محبوب با ** متن، تصاویر، کدهای نوار یا محتوای فرمت شده**.
- کنترل شمارش، گلوله ها و سبک ها به طوری که محتوای ترکیبی با طراحی شرکت مطابقت دارد.
مناطق محدودی و مناطق مشروط
- جدول ها، لیست ها یا پاراگراف ها را برای هر سوابق داده با استفاده از منطقه ها تکرار کنید.
- از مناطق مشروط برای شامل / حذف بخش ها به صورت پویا استفاده کنید (به عنوان مثال، آدرس حمل و نقل را فقط در صورت لزوم نشان دهید).
اتصال منبع داده
- اتصال به هر منبع ADO.NET مطابقت دارد مانند
DataTable
,DataReader
,DataSet
, آریا یا اشیاء سفارشی. - Implement
IMailMergeDataSource
برای کنترل کامل عبور داده ها. - مدیریت منابع داده های سلسله مراتبی و پدر و مادر و فرزند به راحتی ادغام می شود.
مدیریت رویداد سفارشی
- رویدادها مانند
MergeField
,MergeImageField
, وMergeRegion
. - تغییرات اعمال (به عنوان مثال، تاریخ فرمت، ایجاد کدهای QR، و یا جایگزین مکان گیرنده به طور پویا).
عملکرد و مقیاس پذیری
- بهینه سازی برای مجموعه های بزرگ، حجم بالا.
- جریان نتایج به طور مستقیم به دیسک یا پاسخ های HTTP برای به حداقل رساندن استفاده از حافظه.
- پردازش قطعات، ارزیابی میدان تخلیه شده و استفاده مجدد منطقه، پهنای باند را افزایش می دهد.
محلی سازی و بین المللی سازی
- گزارش های چند زبانه را با اجباری کردن ارزش های محلی ایجاد کنید.
- تصمیمات فرهنگی را برای اعداد، ارزها و تاریخ ها اعمال کنید.
- پشتیبانی از زبان های راست به چپ و مدیریت کد مناسب.
سازگاری و پشتیبانی از فرمت
- پشتیبانی از تمام فرمت های اصلی کلمه ( **DOCX، DOC، RTF، HTML ** ) و صادرات به PDF و یا سایر فرم ها از طریق Aspose.Words تبدیل APIs.
- پس از این فرآیند نتایج را با ویژگی های استاندارد Aspose.Words ترکیب کرد: ** امضای دیجیتال، فشرده سازی، هیفناسیون** و بیشتر.
چگونه با استفاده از Mail Merge یک گزارش بسازیم
// Load template
doc = new Document("InvoiceTemplate.docx");
// Example DataTable as data source
DataTable orders = new DataTable("Orders");
orders.Columns.Add("CustomerName");
orders.Columns.Add("Item");
orders.Columns.Add("Quantity");
orders.Rows.Add("John Doe", "Laptop", "1");
orders.Rows.Add("Jane Smith", "Phone", "2");
// Execute Mail Merge
doc.MailMerge.ExecuteWithRegions(orders);
// Save the result
doc.Save("InvoiceReport.docx");
موارد استفاده رایج
- Bulk Letters & Emails : ارسال نامه های شخصی به صورت اتوماتیک.
- فاکتورها و دریافت ها : جمع آوری داده های مشتری و معاملات به قالب های صورتحساب.
- گزارش ها : گزارش های ساختاری را با داده های گروهی یا مشروط ایجاد کنید.
- Labels & Envelopes : ایجاد دارایی های پستی آماده در جمع.
- مدیریت ها و کاتالوگ ها : جمع آوری داده های سلسله مراتبی یا جدول به اسناد ساختار یافته.
راهنمایی ها و بهترین شیوه ها
- استفاده از مجموعه های نام گذاری روشن برای زمینه های ادغام برای بهبود نگهداری.
- به حداقل رساندن مناطق عمیقا نابود شده – داده های مسطح در جایی که ممکن است.
- تعریف و سبک فرمت در قالب برای اطمینان از سازگاری.
- منبع داده ها را قبل از اجرای تأیید کنید تا از اشتباهات زمان اجرا جلوگیری شود.
- استفاده از مدیرهای رویداد برای منطق سفارشی مانند ادغام تصویر یا فرمت مشروط.
- جریان بزرگ ترکیب به ** دیسک یا شبکه جریان** به جای حافظه.
- قالب های کنترل نسخه و آزمایش آنها با داده های نمونه به طور منظم.
- سوابق پیشرفت و اشتباهات را برای حسابرسی و نظارت بر عملکرد ترکیب می کنند.
پرسش های مکرر
**Mail Merge برای .NET چیست?**یک چارچوب برای تولید اسناد سفارشی از قالب ها با میدان های ادغام، جمع آوری شده توسط منابع داده مانند پایگاه داده ها یا مجموعه ها.
کدام منابع داده پشتیبانی می شود?DataTable
, DataSet
, IDataReader
, ریشه ها , و اشیاء سفارشی از طریق IMailMergeDataSource
.
**آیا این کار با داده های سلسله مراتبی انجام می شود?**بله، مناطق نازک به شما اجازه می دهد تا ساختارهای داده پدر و فرزند را ادغام کنید.
**آیا می توان تصاویر را به صورت پویا وارد کرد?**بله استفاده کنید MergeImageField
حوادث برای تزریق تصاویر (به عنوان مثال، تصاویر پروفایل، کدهای QR).
**آیا از ترکیبات در مقیاس بزرگ پشتیبانی می کند?**بله.بهینه سازی شده برای پردازش با حجم بالا با اثر انگشت حافظه پایین.
**کدام فرمت ها پشتیبانی می شوند?**تمام فرمت های اصلی کلمه ( **DOCX، DOC، RTF، HTML ** ) با صادرات به PDF و بیشتر.