create-charts-in-word-documents-using-csharp

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

مباحث زیر در این مقاله مورد بحث و بررسی قرار گرفته‌اند:

C# API برای وارد کردن نمودارها در اسناد ورد

برای درج نمودارها در فایل‌های DOCX، ما از Aspose.Words for .NET API استفاده خواهیم کرد. این امکان را به شما می‌دهد که فایل‌ها را بدون استفاده مستقیم از مایکروسافت ورد در برنامه‌های چندسکویی تولید، ویرایش، تبدیل، رندر و چاپ کنید. این API به شما این امکان را می‌دهد که انواع مختلف supported chart types را به طور برنامه‌نویسی در اسناد ورد درج کنید.

شما می‌توانید یا دانلود DLL API را یا آن را با استفاده از NuGet نصب کنید.

Install-Package Aspose.Words

نمودارهای ستونی را در مستندات ورد ایجاد کنید

شما می‌توانید به‌صورت برنامه‌نویسی نمودارهای ستونی در اسناد ورد ایجاد کنید با دنبال کردن مراحل زیر:

  • در ابتدا، یک سند جدید با استفاده از Document کلاس ایجاد کنید.
  • حال، یک نمونه از کلاس DocumentBuilder را با شیء کلاس Document ایجاد کنید.
  • سپس، متد DocumentBuilder.InsertChart() را فراخوانی کنید. ChartType را به عنوان Column، با ارتفاع و عرض به عنوان پارامترهای ورودی ارائه دهید.
  • نتایج را در شیء کلاس Shape دریافت کنید.
  • اکنون یک نمونه از کلاس Chart ایجاد کنید و شیء Shape.Chart را به آن اختصاص دهید. این دسترسی به ویژگی‌های نمودار را ارائه می‌دهد اگر این شکل یک نمودار داشته باشد.
  • سپس، مجموعه سری نمودار را در ChartSeriesCollection شیء دریافت کنید.
  • Create category names array.
  • حالا، متد ChartSeriesCollection.Add() را برای افزودن سری‌های نمودار فراخوانی کنید. نام، آرایه دسته و مقادیر را به عنوان پارامترهای ورودی ارسال کنید. این مرحله را تکرار کنید تا سری‌های بیشتری اضافه کنید.
  • در نهایت، متد Document.Save() را با مسیر فایل خروجی فراخوانی کنید تا فایل ذخیره شود.

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

// Create a document
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Add chart with default data. You can specify different chart types and sizes.
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);

// خصوصیات نمودار شکل شامل تمام گزینه‌های مربوط به نمودار است.
Chart chart = shape.Chart;

// مجموعه سری‌های نمودار را دریافت کنید.
ChartSeriesCollection seriesColl = chart.Series;
// Check series count.
Console.WriteLine(seriesColl.Count);

// Delete default generated series.
seriesColl.Clear();

// Create category names array, in this example we have two categories.
string[] categories = new string[] { "AW Category 1", "AW Category 2" };

// افزودن سری جدید. لطفاً توجه داشته باشید که آرایه‌های داده نباید خالی باشند و آرایه‌ها باید اندازه یکسانی داشته باشند.
seriesColl.Add("AW Series 1", categories, new double[] { 1, 2 });
seriesColl.Add("AW Series 2", categories, new double[] { 3, 4 });
seriesColl.Add("AW Series 3", categories, new double[] { 5, 6 });
seriesColl.Add("AW Series 4", categories, new double[] { 7, 8 });
seriesColl.Add("AW Series 5", categories, new double[] { 9, 10 });

// Save the document
doc.Save(@"C:\Files\Words\ColumnsChart.docx");
در اسناد ورد با استفاده از C# نمودارهای ستونی ایجاد کنید.

نمودارهای ستونی را در اسناد Word با استفاده از C# ایجاد کنید

چگونه نمودارهای پراکنده در اسناد ورد با استفاده از C# ایجاد کنیم

شما می‌توانید چارت‌های پراکنده را به طور برنامه‌نویسی در مستندات Word خود درج کنید با پیروی از مراحل ذکر شده قبلاً. با این حال، شما باید ChartType.Scatter را در DocumentBuilder.InsertChart() متد تنظیم کنید.

نمونه کد زیر نشان می‌دهد که چگونه یک چارت پراکنش در یک سند Word با استفاده از C# ایجاد کنید.

// یک سند جدید ایجاد کنید
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// نمودار پراکندگی را وارد کنید.
Shape shape = builder.InsertChart(ChartType.Scatter, 432, 252);
Chart chart = shape.Chart;

// از این اضافه بار برای افزودن سری به هر نوع نمودار پراکنده استفاده کنید.
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });

// Save the document
doc.Save(@"C:\Files\Words\ScatterChart.docx");
ایجاد نمودارهای پراکنده در اسناد ورد با استفاده از C#.

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

نرم‌افزار Word را با استفاده از C# برای درج نمودارهای منطقه‌ای ادغام کنید.

شما می‌توانید نمودارهای ناحیه‌ای را به طور برنامه‌نویسی در اسناد ورد وارد کنید با دنبال کردن مراحل ذکر شده قبلاً. با این حال، شما نیاز دارید تا ChartType.Area را در DocumentBuilder.InsertChart() متد تنظیم کنید.

کد نمونه زیر نشان می‌دهد که چگونه می‌توان یک نمودار منطقه‌ای در یک سند ورد با استفاده از C# ایجاد کرد.

// یک سند جدید ایجاد کنید
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// چارت ناحیه را وارد کنید.
Shape shape = builder.InsertChart(ChartType.Area, 432, 252);
Chart chart = shape.Chart;

// از این بارگذاری برای افزودن سری به هر نوع نمودار منطقه، رادار و سهام استفاده کنید.
chart.Series.Add("AW Series 1", new DateTime[] {
    new DateTime(2002, 05, 01),
    new DateTime(2002, 06, 01),
    new DateTime(2002, 07, 01),
    new DateTime(2002, 08, 01),
    new DateTime(2002, 09, 01)},
    new double[] { 32, 32, 28, 12, 15 });

// سند را ذخیره کن
doc.Save(@"C:\Files\Words\AreaChart.docx");
چارت‌های منطقه‌ای را در اسناد ورد با استفاده از C# وارد کنید.

نصب نمودارهای منطقه ای در اسناد Word با استفاده از C#

نصب نمودارهای حبابی در اسناد ورد با استفاده از C#

شما می‌توانید نمودارهای حبابی را به صورت برنامه‌نویسی در اسناد Word وارد کنید با دنبال کردن مراحلی که قبلاً ذکر شد. با این حال، شما باید ChartType.Bubble را در DocumentBuilder.InsertChart() متد تنظیم کنید.

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

// Create a new document
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// درج نمودار حباب.
Shape shape = builder.InsertChart(ChartType.Bubble, 432, 252);
Chart chart = shape.Chart;

// از این بار اضافی برای افزودن سری به هر نوع نمودار حباب استفاده کنید.
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 }, new double[] { 10, 4, 8 });

// Save the document
doc.Save(@"C:\Files\Words\BubbleChart.docx");
درج نمودارهای حبابی در اسناد ورد با استفاده از C#.

نصب نمودارهای حبابی در اسناد Word با استفاده از C#

یک مجوز رایگان بگیرید

شما می‌توانید بدون محدودیت‌های ارزیابی، API را با درخواست یک مجوز موقت رایگان امتحان کنید.

نتیجه گیری

در این مقاله، شما یاد گرفته‌اید که چگونه نمودارها را در اسناد Word با استفاده از C# ایجاد کنید. به‌ویژه، شما یاد گرفته‌اید که چگونه نمودارهای ستونی، ناحیه‌ای، حباب و پراکنده را به‌صورت برنامه‌نویسی در اسناد Word ایجاد کنید. به همین ترتیب، شما می‌توانید انواع دیگر نمودارها را نیز ایجاد کنید. می‌توانید اطلاعات بیشتری در مورد Aspose.Words برای API .NET با استفاده از documentation یاد بگیرید. در صورت هر گونه ابهام، لطفاً با ما در forum تماس بگیرید.

برای اطلاعات بیشتر