مرور اتصالات از اکسل در C# | مرور اتصالات اکسل به اکسل

ترکیب نامه ایجاد اسناد شخصی‌سازی‌شده به صورت انبوه را آسان می‌کند، مانند نامه‌ها، ایمیل‌ها، فاکتورها یا گواهینامه‌ها. شما با یک الگو شروع می‌کنید و آن را با استفاده از داده‌ها از یک صفحه‌گسترده پر می‌کنید. هر ردیف در فایل اکسل یک سند جدید با جزئیات صحیح در مکان‌های مناسب ایجاد می‌کند. این یک روش هوشمند برای خودکارسازی وظایف تکراری مانند ارسال فاکتورها یا تولید گزارش‌ها است. در این پست، به شما نشان خواهیم داد که چگونه یک ترکیب نامه از اکسل با استفاده از C# انجام دهید. بیایید شروع کنیم.

این مقاله شامل موضوعات زیر است:

کتابخانه ادغام نامه C# برای اکسل

ما از API Aspose.Cells for .NET برای انجام ادغام پستی از اکسل در C# استفاده خواهیم کرد. این ابزارهای قدرتمندی را برای کار با فایل‌های اکسل به‌طور مستقیم در کد شما ارائه می‌دهد. این امکان را به توسعه‌دهندگان می‌دهد که به‌راحتی صفحات گسترده ایجاد، بخوانند و بروز رسانی کنند. همچنین می‌توانید وظایف پیشرفته‌ای مانند ادغام پستی را بدون دردسر انجام دهید. این کتابخانه اتوماسیون اکسل را سریع، انعطاف‌پذیر و قابل‌اعتماد می‌کند.

برای شروع با Aspose.Cells برای .NET، این دستورالعمل‌های نصب ساده را دنبال کنید:

  1. لطفاً آن را از releases دانلود کنید.
  2. کتابخانه را با استفاده از مدیر بسته NuGet با دستور زیر نصب کنید:
PM> Install-Package Aspose.Cells

Mail Merge چگونه با Aspose.Cells کار می‌کند؟

Aspose.Cells از `ادغام پستی” در همان راهی که Word پشتیبانی نمی‌کند. این کتابخانه ادغام پستی را با استفاده از Smart Markers به Excel اضافه می‌کند. این مارکرها به عنوان نشانه‌گذار در دفترچه محاسباتی شما عمل می‌کنند و کتابخانه آن‌ها را در زمان اجرا با داده‌های واقعی جایگزین می‌کند. هنگامی که هر ردیف از منبع داده شما پردازش می‌شود، الگو را پر کرده و محتوای آن را به صورت خودکار گسترش می‌دهد، به شما این امکان را می‌دهد که با صرفاً چند خط کد C# اسناد کاملاً شخصی‌سازی شده تولید کنید.

&=DataSource.ColumnName

در هنگام پردازش، Aspose.Cells اینها را با داده‌های واقعی از یک DataTable، List<T>، یا هر IEnumerable جایگزین می‌کند. به عنوان مثال، کتابخانه &=Data.Name را با مقادیر از ستون Name در جدول Data جایگزین می‌کند.

قالب اکسل را آماده کنید.

یک فایل Excel ایجاد کنید (به عنوان مثال، Template.xlsx) با مارکرهای هوشمند. اینجا یک طرح نمونه است:

نامایمیلمقدار
&=Data.Name&=Data.Email&=Data.Amount

راهنمای قدم به قدم برای انجام مرج پست از اکسل در C#

برای انجام ادغام نامه از اکسل با استفاده از Aspose.Cells برای .NET، به سادگی مراحل زیر را دنبال کنید:

مرحله ۱: فایل قالب اکسل را بارگذاری کنید

فایل الگوی Excel را که شامل Smart Markers است با استفاده از کلاس Workbook بارگذاری کنید. کلاس Workbook نمایانگر کل فایل Excel (کتاب کار) است. فایل الگوی بارگذاری شده به عنوان طرحی برای خروجی ادغام شده شما عمل می‌کند.

Workbook workbook = new Workbook("Template.xlsx");

مرحله 2: ایجاد یک DataTable

اینجا، ما یک DataTable ایجاد می‌کنیم که منبع داده‌های Excel شما را شبیه‌سازی می‌کند. هر ستون با یک مارکر هوشمند مطابقت دارد و هر ردیف یک مجموعه از مقادیر برای درج را نشان می‌دهد. کلاس DataTable از System.Data داده‌هایی را که می‌خواهید ادغام کنید، نگه می‌دارد. هر ستون با یک مارکر هوشمند مطابقت دارد و هر ردیف یک مجموعه منحصر به فرد از مقادیر را فراهم می‌کند.

DataTable dt = new DataTable("Data");
dt.Columns.Add("Name");
dt.Columns.Add("Email");
dt.Columns.Add("Amount");

dt.Rows.Add("Alice", "alice@example.com", 1000);
dt.Rows.Add("Bob", "bob@example.com", 1500);

مرحله 3: الگوهای اکسل خود را به منبع داده متصل کنید

ما از کلاس WorkbookDesigner برای پیوند زدن الگو با داده ها استفاده می کنیم. کلاس WorkbookDesigner یک کلاس ویژه در Aspose.Cells است که برای مدیریت نشانگرهای هوشمند و پیوند داده طراحی شده است. این کلاس منبع داده شما (مانند یک DataTable) را با الگوی Excel پیوند می زند. روش SetDataSource() داده DataTable (Data) را به نشانگرهای هوشمند در دفتر کار پیوند می دهد.

WorkbookDesigner designer = new WorkbookDesigner(workbook);
designer.SetDataSource(dt);
  • SetDataSource() DataTable را به نشانگرهای هوشمند در کاربرگ متصل می‌کند.
  • "Data" نامی است که در نشانگرهایی مانند &=Data.Name استفاده می‌شود.

مرحله ۴: اجرای ادغام پست

پس از اینکه منبع داده را تنظیم کردید، فراخوانی Process() تمام نشانگرهای هوشمند را با مقادیر واقعی از DataTable پر می‌کند. این فرمان ادغام ایمیل را اجرا می‌کند. این فرمان از طریق نشانگرهای هوشمند می‌رود و آن‌ها را با مقادیر واقعی از منبع داده جایگزین می‌کند.

designer.Process();

مرحله ۵: فایل را ذخیره کنید

نهایتاً، ما فایل تکمیل شده را با تمام داده‌های ادغام شده ذخیره می‌کنیم.

workbook.Save("MergedOutput.xlsx");

خروجی ترکیب شده را به عنوان PDF ذخیره کنید

شما می‌توانید به‌راحتی سند اکسل ترکیب‌شده را با یک خط کد به فرمت PDF ذخیره کنید.

// Set PDF options
PdfSaveOptions options = new PdfSaveOptions();

// Save as PDF
workbook.Save("MergedDocument.pdf", SaveFormat.Pdf);

کد کامل C# برای ادغام داده های ایمیل

// الگوی اکسل را بارگذاری کنید
Workbook workbook = new Workbook("Template.xlsx");

// Create dummy data
DataTable dt = new DataTable("Data");
dt.Columns.Add("Name");
dt.Columns.Add("Email");
dt.Columns.Add("Amount");

dt.Rows.Add("Alice", "alice@example.com", 1000);
dt.Rows.Add("Bob", "bob@example.com", 1200);

// منبع داده را تنظیم کنید
WorkbookDesigner designer = new WorkbookDesigner(workbook);
designer.SetDataSource(dt);

// فرایند نشانگرهای هوشمند (ادغام پستی)
designer.Process();

// Save the output
workbook.Save("MergedOutput.xlsx");

Output

فایل خروجی اکسل شامل یک ردیف برای هر ورودی است که داده‌های شخصی‌سازی شده به جای نشانگرهای هوشمند قرار داده شده‌اند.

ادغام نامه از اکسل در C# - خروجی

ادغام ایمیل از اکسل در C# - خروجی

به‌دست آوردن یک مجوز رایگان

برای دریافت یک مجوز موقتی رایگان که به شما اجازه می‌دهد تا بدون هیچ گونه محدودیتی تمام ویژگی‌های Aspose.Cells for .NET را تست کنید. این گزینه برای ارزیابی API برای وظایف اتوماسیون مانند ادغام پستی، گزارش‌گیری Excel یا صادرات PDF ایده آل است.

ادغام پست الکترونیکی Excel به Excel: منابع رایگان

علاوه بر ادغام نامه Excel، ما منابع مختلفی را برای کمک به شما در درک عمیق‌تر Aspose.Cells برای .NET ارائه می‌دهیم. مستندات، آموزش‌ها و انجمن‌های جامعه ما را برای کسب اطلاعات بیشتر بررسی کنید.

سوالات متداول (FAQs)

Q1: آیا می‌توانم از ادغام پستی اکسل بدون نصب مایکروسافت آفیس استفاده کنم؟

بله، ادغام نامه به مایکروسافت آفیس نیاز ندارد. Aspose.Cells به صورت مستقل اجرا می‌شود و همه چیز را از طریق APIهای خود مدیریت می‌کند.

Q2: تفاوت بین Smart Markers و Word Merge Fields چیست؟

مارکرهای هوشمند در اکسل کار می‌کنند و برای گسترش داده‌های سطری بیشتر قابل تنظیم هستند. فیلدهای ادغام خاص ورد هستند.

Q3: آیا می‌توانم از اکسل به ورد با استفاده از Aspose ادغام کنم؟

بله، اما برای آن سناریو به Aspose.Words نیاز خواهید داشت.

Q4: آیا امکان اتوماسیون تولید PDF از ادغام های Excel وجود دارد؟

به طور قطع. فقط workbook نهایی را در فرمت PDF با استفاده از Aspose.Cells ذخیره کنید.

نتیجه گیری

ادغام ایمیل از اکسل یک روش قدرتمند برای تولید اسناد پویا و شخصی‌سازی شده با استفاده از رابط کاربری آشنا به صفحه‌گسترده است. در این پست وبلاگ، ما فرآیند ادغام ایمیل از اکسل با استفاده از C# را بررسی کردیم. با استفاده از نشانگرهای هوشمند Aspose.Cells، شما انعطاف‌پذیری کامل برای اتوماسیون این فرآیند و تولید هزاران فاکتور، گواهینامه یا هر گزارش ساختاریافته‌ای را دارید.

اگر سوالی دارید یا به کمک بیشتری نیاز دارید، لطفاً با ما در free support forum تماس بگیرید.

همچنین ببینید