Class Series
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Enkapsuluje obiekt, który reprezentuje pojedynczą serię danych w wykresie.
public class SeriesDziedziczenie
Członkowie dziedziczeni
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Przykłady
//Tworzenie obiektu Workbook
Workbook workbook = new Workbook();
//Dodawanie nowego arkusza do obiektu Excel
int sheetIndex = workbook.Worksheets.Add();
//Uzyskiwanie referencji do nowo dodanego arkusza, przekazując jego indeks arkusza
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//Dodawanie przykładowej wartości do komórki "A1"
worksheet.Cells["A1"].PutValue(50);
//Dodawanie przykładowej wartości do komórki "A2"
worksheet.Cells["A2"].PutValue(100);
//Dodawanie przykładowej wartości do komórki "A3"
worksheet.Cells["A3"].PutValue(150);
//Dodawanie przykładowej wartości do komórki "A4"
worksheet.Cells["A4"].PutValue(200);
//Dodawanie przykładowej wartości do komórki "B1"
worksheet.Cells["B1"].PutValue(60);
//Dodawanie przykładowej wartości do komórki "B2"
worksheet.Cells["B2"].PutValue(32);
//Dodawanie przykładowej wartości do komórki "B3"
worksheet.Cells["B3"].PutValue(50);
//Dodawanie przykładowej wartości do komórki "B4"
worksheet.Cells["B4"].PutValue(40);
//Dodawanie przykładowej wartości do komórki "C1" jako danych kategorii
worksheet.Cells["C1"].PutValue("Q1");
//Dodawanie przykładowej wartości do komórki "C2" jako danych kategorii
worksheet.Cells["C2"].PutValue("Q2");
//Dodawanie przykładowej wartości do komórki "C3" jako danych kategorii
worksheet.Cells["C3"].PutValue("Y1");
//Dodawanie przykładowej wartości do komórki "C4" jako danych kategorii
worksheet.Cells["C4"].PutValue("Y2");
//Dodawanie wykresu do arkusza
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5);
//Uzyskiwanie instancji nowo dodanego wykresu
Chart chart = worksheet.Charts[chartIndex];
//Dodawanie NSeries (źródło danych wykresu) do wykresu w zakresie od komórki "A1" do "B4"
int seriesIndex = chart.NSeries.Add("A1:B4", true);
//Ustawianie źródła danych dla danych kategorii NSeries
chart.NSeries.CategoryData = "C1:C4";
Series series = chart.NSeries[seriesIndex];
//Ustawianie wartości serii.
series.Values = "=B1:B4";
//Zmiana typu wykresu serii.
series.Type = ChartType.Line;
//Ustawianie właściwości markerów.
series.Marker.MarkerStyle = ChartMarkerType.Circle;
series.Marker.ForegroundColorSetType = FormattingType.Automatic;
series.Marker.ForegroundColor = System.Drawing.Color.Black;
series.Marker.BackgroundColorSetType = FormattingType.Automatic;
//wykonaj swoją logikę
//Zapisywanie pliku Excel
workbook.Save("book1.xls");'Tworzenie obiektu Workbook
Dim workbook As Workbook = New Workbook()
'Dodawanie nowego arkusza do obiektu Excel
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'Uzyskiwanie referencji do nowo dodanego arkusza, przekazując jego indeks arkusza
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'Dodawanie przykładowej wartości do komórki "A1"
worksheet.Cells("A1").PutValue(50)
'Dodawanie przykładowej wartości do komórki "A2"
worksheet.Cells("A2").PutValue(100)
'Dodawanie przykładowej wartości do komórki "A3"
worksheet.Cells("A3").PutValue(150)
'Dodawanie przykładowej wartości do komórki "A4"
worksheet.Cells("A4").PutValue(200)
'Dodawanie przykładowej wartości do komórki "B1"
worksheet.Cells("B1").PutValue(60)
'Dodawanie przykładowej wartości do komórki "B2"
worksheet.Cells("B2").PutValue(32)
'Dodawanie przykładowej wartości do komórki "B3"
worksheet.Cells("B3").PutValue(50)
'Dodawanie przykładowej wartości do komórki "B4"
worksheet.Cells("B4").PutValue(40)
'Dodawanie przykładowej wartości do komórki "C1" jako danych kategorii
worksheet.Cells("C1").PutValue("Q1")
'Dodawanie przykładowej wartości do komórki "C2" jako danych kategorii
worksheet.Cells("C2").PutValue("Q2")
'Dodawanie przykładowej wartości do komórki "C3" jako danych kategorii
worksheet.Cells("C3").PutValue("Y1")
'Dodawanie przykładowej wartości do komórki "C4" jako danych kategorii
worksheet.Cells("C4").PutValue("Y2")
'Dodawanie wykresu do arkusza
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'Uzyskiwanie instancji nowo dodanego wykresu
Dim chart As Chart = worksheet.Charts(chartIndex)
'Dodawanie NSeries (źródło danych wykresu) do wykresu w zakresie od komórki "A1" do "B4"
Dim seriesIndex As Int32 = chart.NSeries.Add("A1:B4", True)
'Ustawianie źródła danych dla danych kategorii NSeries
chart.NSeries.CategoryData = "C1:C4"
Dim series As Series = chart.NSeries(seriesIndex)
'Ustawianie wartości serii.
series.Values = "=B1:B4"
'Zmiana typu wykresu serii.
series.Type = ChartType.Line
'Ustawianie właściwości markerów.
series.Marker.MarkerStyle = ChartMarkerType.Circle
series.Marker.ForegroundColorSetType = FormattingType.Automatic
series.Marker.ForegroundColor = System.Drawing.Color.Black
series.Marker.BackgroundColorSetType = FormattingType.Automatic
'Zapisywanie pliku Excel
workbook.Save("book1.xls")Właściwości
Area
Reprezentuje obszar tła obiektu Series.
public Area Area { get; }Wartość właściwości
Bar3DShapeType
Pobiera lub ustawia typ kształtu 3D używany w wykresie słupkowym lub kolumnowym 3D.
public Bar3DShapeType Bar3DShapeType { get; set; }Wartość właściwości
Border
Reprezentuje krawędź obiektu Series.
public Line Border { get; }Wartość właściwości
BubbleScale
Pobiera lub ustawia współczynnik skali dla bąbelków w określonej grupie wykresów. Może to być wartość całkowita od 0 (zero) do 300, odpowiadająca procentowi domyślnego rozmiaru. Dotyczy tylko wykresów bąbelkowych.
public int BubbleScale { get; set; }Wartość właściwości
BubbleSizes
Pobiera lub ustawia wartości rozmiarów bąbelków serii wykresu.
public string BubbleSizes { get; set; }Wartość właściwości
CountOfDataValues
Pobiera liczbę wartości danych.
public int CountOfDataValues { get; }Wartość właściwości
DataLabels
Reprezentuje obiekt DataLabels dla określonej ASeries.
public DataLabels DataLabels { get; }Wartość właściwości
DisplayName
Pobiera nazwę serii, która wyświetla się na wykresie.
public string DisplayName { get; }Wartość właściwości
DoughnutHoleSize
Zwraca lub ustawia rozmiar otworu w grupie wykresów pierścieniowych. Rozmiar otworu wyrażany jest jako procent rozmiaru wykresu, między 10 a 90 procent.
public int DoughnutHoleSize { get; set; }Wartość właściwości
DownBars
Zwraca obiekt Aspose.Cells.Charts.DropBars, który reprezentuje dolne paski na wykresie liniowym. Dotyczy tylko wykresów liniowych.
public DropBars DownBars { get; }Wartość właściwości
DropLines
Zwraca obiekt Aspose.Cells.Drawing.Line, który reprezentuje linie spadku dla serii na wykresie liniowym lub obszarowym. Dotyczy tylko wykresów liniowych lub obszarowych.
public Line DropLines { get; }Wartość właściwości
Explosion
Odległość otwartego kawałka ciasta od środka wykresu kołowego wyrażana jest jako procent średnicy ciasta.
public int Explosion { get; set; }Wartość właściwości
FirstSliceAngle
Pobiera lub ustawia kąt pierwszego kawałka wykresu kołowego lub wykresu pierścieniowego, w stopniach (zgodnie z ruchem wskazówek zegara od pionu). Dotyczy tylko wykresów kołowych, 3D kołowych i pierścieniowych, 0 do 360.
public short FirstSliceAngle { get; set; }Wartość właściwości
GapWidth
Zwraca lub ustawia przestrzeń między klastrami słupków lub kolumn, jako procent szerokości słupka lub kolumny. Wartość tej właściwości musi mieścić się w przedziale od 0 do 500.
public short GapWidth { get; set; }Wartość właściwości
Has3DEffect
Prawda, jeśli seria ma trójwymiarowy wygląd. Dotyczy tylko wykresów bąbelkowych.
public bool Has3DEffect { get; set; }Wartość właściwości
HasDropLines
Prawda, jeśli wykres ma linie spadku. Dotyczy tylko wykresów liniowych lub obszarowych.
public bool HasDropLines { get; set; }Wartość właściwości
HasHiLoLines
Prawda, jeśli wykres liniowy ma linie wysokie-niskie. Dotyczy tylko wykresów liniowych.
public bool HasHiLoLines { get; set; }Wartość właściwości
HasLeaderLines
Prawda, jeśli seria ma linie przywódcze.
public bool HasLeaderLines { get; set; }Wartość właściwości
HasRadarAxisLabels
Prawda, jeśli wykres radarowy ma etykiety osi kategorii. Dotyczy tylko wykresów radarowych.
public bool HasRadarAxisLabels { get; set; }Wartość właściwości
HasSeriesLines
Prawda, jeśli wykres słupkowy skumulowany lub wykres słupkowy ma linie serii lub jeśli wykres kołowy lub wykres słupkowy ma linie łączące między dwoma sekcjami. Dotyczy tylko wykresów słupkowych skumulowanych, wykresów słupkowych, wykresów kołowych lub wykresów słupkowych.
public bool HasSeriesLines { get; set; }Wartość właściwości
HasUpDownBars
Prawda, jeśli wykres liniowy ma paski w górę i w dół. Dotyczy tylko wykresów liniowych.
public bool HasUpDownBars { get; set; }Wartość właściwości
HiLoLines
Zwraca obiekt HiLoLines, który reprezentuje linie wysokie-niskie dla serii na wykresie liniowym. Dotyczy tylko wykresów liniowych.
public Line HiLoLines { get; }Wartość właściwości
IsAutoSplit
Wskazuje, czy wartość progowa jest automatyczna.
public bool IsAutoSplit { get; }Wartość właściwości
IsColorVaried
Reprezentuje, czy kolor punktów jest zróżnicowany. Wykres musi zawierać tylko jedną serię.
public bool IsColorVaried { get; set; }Wartość właściwości
IsFiltered
Wskazuje, czy seria jest wybrana lub filtrowana. Prawda oznacza, że ta seria jest filtrowana i nie będzie wyświetlana na wykresie.
public bool IsFiltered { get; set; }Wartość właściwości
IsVerticalValues
Wskazuje, czy źródło danych jest pionowe.
public bool IsVerticalValues { get; }Wartość właściwości
LayoutProperties
Reprezentuje właściwości układu.
public SeriesLayoutProperties LayoutProperties { get; }Wartość właściwości
LeaderLines
Reprezentuje linie przywódcze na wykresie. Linie przywódcze łączą etykiety danych z punktami danych. Ten obiekt nie jest kolekcją; nie ma obiektu, który reprezentuje pojedynczą linię przywódczą.
public Line LeaderLines { get; }Wartość właściwości
LegendEntry
Pobiera wpis legendy zgodnie z tą serią.
public LegendEntry LegendEntry { get; }Wartość właściwości
Marker
Pobiera marker Aspose.Cells.Charts.Series.Marker?text=marker.
public Marker Marker { get; }Wartość właściwości
Name
Pobiera lub ustawia nazwę serii danych.
public string Name { get; set; }Wartość właściwości
Przykłady
//Referencja do nazwy w komórce
chart.NSeries[0].Name = "=A1";
//Ustawienie ciągu jako nazwy
chart.NSeries[0].Name = "Pierwsza seria";'Referencja do nazwy w komórce
chart.NSeries[0].Name = "=A1"
'Ustawienie ciągu jako nazwy
chart.NSeries[0].Name = "Pierwsza seria"Overlap
Określa, jak są pozycjonowane słupki i kolumny. Może to być wartość między -100 a 100. Dotyczy tylko wykresów słupkowych 2D i kolumnowych 2D.
public short Overlap { get; set; }Wartość właściwości
PlotOnSecondAxis
Wskazuje, czy ta seria jest wykreślona na drugiej osi wartości.
public bool PlotOnSecondAxis { get; set; }Wartość właściwości
Points
Pobiera kolekcję punktów w serii na wykresie.
public ChartPointCollection Points { get; }Wartość właściwości
Uwagi
Gdy wykres jest wykresem kołowym lub słupkowym, ostatni punkt jest innym punktem w pierwszym wykresie kołowym.
SecondPlotSize
Zwraca lub ustawia rozmiar drugiej sekcji wykresu kołowego lub słupkowego, jako procent rozmiaru głównego wykresu kołowego. Może to być wartość od 5 do 200.
public short SecondPlotSize { get; set; }Wartość właściwości
SeriesLines
Zwraca obiekt SeriesLines, który reprezentuje linie serii dla wykresu słupkowego skumulowanego lub wykresu kolumnowego skumulowanego. Dotyczy tylko wykresów słupkowych skumulowanych i kolumnowych skumulowanych.
public Line SeriesLines { get; }Wartość właściwości
Shadow
Prawda, jeśli seria ma cień.
public bool Shadow { get; set; }Wartość właściwości
ShapeProperties
Pobiera obiekt Aspose.Cells.Drawing.ShapePropertyCollection, który przechowuje właściwości wizualne kształtu serii.
public ShapePropertyCollection ShapeProperties { get; }Wartość właściwości
ShowNegativeBubbles
Prawda, jeśli negatywne bąbelki są wyświetlane dla grupy wykresów. Ważne tylko dla wykresów bąbelkowych.
public bool ShowNegativeBubbles { get; set; }Wartość właściwości
SizeRepresents
Pobiera lub ustawia, co reprezentuje rozmiar bąbelka na wykresie bąbelkowym.
public BubbleSizeRepresents SizeRepresents { get; set; }Wartość właściwości
Uwagi
BubbleSizeRepresents.SizeIsArea oznacza, że wartość Aspose.Cells.Charts.Series.BubbleSizes jest powierzchnią bąbelka. BubbleSizeRepresents.SizeIsWidth oznacza, że wartość Aspose.Cells.Charts.Series.BubbleSizes jest szerokością bąbelka.
Smooth
Reprezentuje wygładzanie krzywej. Prawda, jeśli wygładzanie krzywej jest włączone dla wykresu liniowego lub wykresu punktowego. Dotyczy tylko wykresów liniowych i punktowych połączonych liniami.
public bool Smooth { get; set; }Wartość właściwości
SplitType
Zwraca lub ustawia wartość, która określa, jak określić, które punkty danych znajdują się w drugim wykresie kołowym lub słupkowym na wykresie kołowym lub słupkowym.
public ChartSplitType SplitType { get; set; }Wartość właściwości
SplitValue
Zwraca lub ustawia wartość, która ma być używana do określenia, które punkty danych znajdują się w drugim wykresie kołowym lub słupkowym na wykresie kołowym lub słupkowym.
public double SplitValue { get; set; }Wartość właściwości
TrendLines
Zwraca wszystkie linie trendu tej serii.
public TrendlineCollection TrendLines { get; }Wartość właściwości
Type
Pobiera lub ustawia typ serii danych.
public ChartType Type { get; set; }Wartość właściwości
UpBars
Zwraca obiekt DropBars, który reprezentuje górne paski na wykresie liniowym. Dotyczy tylko wykresów liniowych.
public DropBars UpBars { get; }Wartość właściwości
Values
Reprezentuje wartości Y tej serii wykresu.
public string Values { get; set; }Wartość właściwości
ValuesFormatCode
Reprezentuje kod formatu listy liczb wartości.
public string ValuesFormatCode { get; set; }Wartość właściwości
XErrorBar
Reprezentuje błąd kierunku X serii.
public ErrorBar XErrorBar { get; }Wartość właściwości
XValues
Reprezentuje wartości x serii wykresu.
public string XValues { get; set; }Wartość właściwości
XValuesFormatCode
Reprezentuje kod formatu listy liczb wartości X.
public string XValuesFormatCode { get; set; }Wartość właściwości
YErrorBar
Reprezentuje błąd kierunku Y serii.
public ErrorBar YErrorBar { get; }Wartość właściwości
Metody
Move(int)
Przesuwa serię w górę lub w dół.
public void Move(int count)Parametry
count int
Liczba przesunięć w górę lub w dół. Przesuń serię w górę, jeśli jest to mniejsze od zera; Przesuń serię w dół, jeśli jest to większe od zera.
