Twórz wykresy w dokumentach programu Word przy użyciu języka C#

Jako programista C# możesz programowo wstawiać różne typy wykresów w dokumentach programu Word. Pomaga w graficznej prezentacji danych i informacji. W tym artykule dowiesz się, jak tworzyć wykresy w dokumentach programu Word przy użyciu języka C#.

W tym artykule omówiono/omówiono następujące tematy:

• API C# do wstawiania wykresów w dokumentach Word
• Twórz wykresy kolumnowe w dokumentach programu Word
• Twórz wykresy punktowe w dokumentach programu Word przy użyciu języka C#
• Wstaw wykresy warstwowe do dokumentów programu Word przy użyciu języka C#
• Wstaw wykresy bąbelkowe do dokumentów programu Word przy użyciu języka C#

API C# do wstawiania wykresów w dokumentach Word

Do wstawiania wykresów w plikach DOCX będziemy używać Aspose.Words for .NET API. Umożliwia generowanie, modyfikowanie, konwertowanie, renderowanie i drukowanie plików bez używania programu Microsoft Word bezpośrednio w aplikacjach wieloplatformowych. Interfejs API umożliwia programowe wstawianie różnych obsługiwanych typów wykresów w dokumentach programu Word.

Możesz pobrać bibliotekę DLL interfejsu API lub zainstalować ją przy użyciu NuGet.

Install-Package Aspose.Words

Twórz wykresy kolumnowe w dokumentach programu Word

Możesz programowo tworzyć wykresy kolumnowe w dokumentach programu Word, wykonując czynności podane poniżej:

• Najpierw utwórz nowy dokument, korzystając z klasy Document.
• Teraz utwórz instancję klasy DocumentBuilder z obiektem klasy Document.
• Następnie wywołaj metodę DocumentBuilder.InsertChart(). Przekaż ChartType jako kolumnę, podając wysokość i szerokość jako parametry wejściowe.
• Uzyskaj wyniki w obiekcie klasy Shape.
• Utwórz teraz instancję klasy Chart i przypisz do niej obiekt Shape.Chart. Zapewnia dostęp do właściwości wykresu, jeśli ten kształt zawiera Chart.
• Następnie pobierz kolekcję serii wykresów w obiekcie ChartSeriesCollection.
• Utwórz tablicę nazw kategorii.
• Teraz wywołaj metodę ChartSeriesCollection.Add(), aby dodać serię wykresów. Przekaż nazwę, tablicę kategorii i wartości jako parametry wejściowe. Powtórz ten krok, aby dodać więcej serii.
• Na koniec wywołaj metodę Document.Save() ze ścieżką do pliku wyjściowego, aby zapisać plik.

Poniższy przykładowy kod pokazuje, jak utworzyć wykres kolumnowy w dokumencie programu Word przy użyciu języka C#.

// Utwórz dokument
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Dodaj wykres z danymi domyślnymi. Można określić różne typy i rozmiary wykresów.
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);

// Właściwość Wykres obiektu Shape zawiera wszystkie opcje związane z wykresami.
Chart chart = shape.Chart;

// Pobierz kolekcję serii wykresów.
ChartSeriesCollection seriesColl = chart.Series;
// Sprawdź liczbę serii.
Console.WriteLine(seriesColl.Count);

// Usuń domyślnie wygenerowaną serię.
seriesColl.Clear();

// Utwórz tablicę nazw kategorii. W tym przykładzie mamy dwie kategorie.
string[] categories = new string[] { "AW Category 1", "AW Category 2" };

// Dodawanie nowej serii. Należy pamiętać, że tablice danych nie mogą być puste, a tablice muszą mieć ten sam rozmiar.
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 });

// Zapisz dokument
doc.Save(@"C:\Files\Words\ColumnsChart.docx");

Twórz wykresy punktowe w dokumentach programu Word przy użyciu języka C#

Wykresy punktowe można programowo wstawiać do dokumentów programu Word, wykonując czynności wymienione wcześniej. Należy jednak ustawić ChartType.Scatter w metodzie DocumentBuilder.InsertChart().

Poniższy przykładowy kod pokazuje, jak utworzyć wykres punktowy w dokumencie programu Word przy użyciu języka C#.

// Utwórz nowy dokument
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Wstaw wykres punktowy.
Shape shape = builder.InsertChart(ChartType.Scatter, 432, 252);
Chart chart = shape.Chart;

// Użyj tego przeciążenia, aby dodać serie do dowolnego typu wykresów punktowych.
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });

// Zapisz dokument
doc.Save(@"C:\Files\Words\ScatterChart.docx");

Wstaw wykresy warstwowe do dokumentów programu Word przy użyciu języka C#

Wykresy warstwowe można wstawiać programowo w dokumentach programu Word, wykonując kroki wymienione wcześniej. Należy jednak ustawić ChartType.Area w metodzie DocumentBuilder.InsertChart().

Poniższy przykładowy kod pokazuje, jak utworzyć wykres warstwowy w dokumencie programu Word przy użyciu języka C#.

// Utwórz nowy dokument
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Wstaw wykres warstwowy.
Shape shape = builder.InsertChart(ChartType.Area, 432, 252);
Chart chart = shape.Chart;

// Użyj tego przeciążenia, aby dodać serie do dowolnego typu wykresów obszarowych, radarowych i giełdowych.
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 });

// Zapisz dokument
doc.Save(@"C:\Files\Words\AreaChart.docx");

Wstaw wykresy bąbelkowe do dokumentów programu Word przy użyciu języka C#

Wykresy bąbelkowe można programowo wstawiać do dokumentów programu Word, wykonując czynności wymienione wcześniej. Należy jednak ustawić ChartType.Bubble w metodzie DocumentBuilder.InsertChart().

Poniższy przykładowy kod pokazuje, jak utworzyć wykres bąbelkowy w dokumencie programu Word przy użyciu języka C#.

// Utwórz nowy dokument
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Wstaw wykres bąbelkowy.
Shape shape = builder.InsertChart(ChartType.Bubble, 432, 252);
Chart chart = shape.Chart;

// Użyj tego przeciążenia, aby dodać serie do dowolnego typu wykresów bąbelkowych.
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 });

// Zapisz dokument
doc.Save(@"C:\Files\Words\BubbleChart.docx");

Zdobądź bezpłatną licencję

Możesz wypróbować interfejs API bez ograniczeń ewaluacyjnych, prosząc o bezpłatną licencję tymczasową.

Wniosek

W tym artykule nauczyłeś się tworzyć wykresy w dokumentach programu Word przy użyciu języka C#. W szczególności nauczyłeś się programowo tworzyć wykresy kolumnowe, warstwowe, bąbelkowe i punktowe w dokumentach programu Word. Podobnie możesz tworzyć inne typy wykresów. Możesz dowiedzieć się więcej o Aspose.Words for .NET API, korzystając z dokumentacji. W przypadku jakichkolwiek niejasności prosimy o kontakt na forum.

Zobacz też

• Pracuj ze spisem treści w dokumencie programu Word C#