Class Series

Class Series

Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)

차트에서 단일 데이터 시리즈를 나타내는 객체를 캡슐화합니다.

public class Series

상속

objectSeries

상속된 멤버

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

예시

//Workbook 객체 인스턴스화
Workbook workbook = new Workbook();
//Excel 객체에 새 워크시트 추가
int sheetIndex = workbook.Worksheets.Add();
//워크시트의 시트 인덱스를 통해 새로 추가된 워크시트의 참조 얻기
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//"A1" 셀에 샘플 값 추가
worksheet.Cells["A1"].PutValue(50);
//"A2" 셀에 샘플 값 추가
worksheet.Cells["A2"].PutValue(100);
//"A3" 셀에 샘플 값 추가
worksheet.Cells["A3"].PutValue(150);
//"A4" 셀에 샘플 값 추가
worksheet.Cells["A4"].PutValue(200);
//"B1" 셀에 샘플 값 추가
worksheet.Cells["B1"].PutValue(60);
//"B2" 셀에 샘플 값 추가
worksheet.Cells["B2"].PutValue(32);
//"B3" 셀에 샘플 값 추가
worksheet.Cells["B3"].PutValue(50);
//"B4" 셀에 샘플 값 추가
worksheet.Cells["B4"].PutValue(40);
//"C1" 셀에 카테고리 데이터로 샘플 값 추가
worksheet.Cells["C1"].PutValue("Q1");
//"C2" 셀에 카테고리 데이터로 샘플 값 추가
worksheet.Cells["C2"].PutValue("Q2");
//"C3" 셀에 카테고리 데이터로 샘플 값 추가
worksheet.Cells["C3"].PutValue("Y1");
//"C4" 셀에 카테고리 데이터로 샘플 값 추가
worksheet.Cells["C4"].PutValue("Y2");
//워크시트에 차트 추가
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5);
//새로 추가된 차트의 인스턴스에 접근
Chart chart = worksheet.Charts[chartIndex];
//"A1" 셀에서 "B4"까지 차트 데이터 소스로 NSeries 추가
int seriesIndex = chart.NSeries.Add("A1:B4", true);
//NSeries의 카테고리 데이터 소스 설정
chart.NSeries.CategoryData = "C1:C4";
Series series = chart.NSeries[seriesIndex];
//시리즈의 값 설정
series.Values = "=B1:B4";
//시리즈의 차트 유형 변경
series.Type = ChartType.Line;
//마커 속성 설정
series.Marker.MarkerStyle = ChartMarkerType.Circle;
series.Marker.ForegroundColorSetType = FormattingType.Automatic;
series.Marker.ForegroundColor = System.Drawing.Color.Black;
series.Marker.BackgroundColorSetType = FormattingType.Automatic;

//비즈니스 로직 수행

//Excel 파일 저장
workbook.Save("book1.xls");
'Workbook 객체 인스턴스화
Dim workbook As Workbook = New Workbook()
'Excel 객체에 새 워크시트 추가
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'워크시트의 시트 인덱스를 통해 새로 추가된 워크시트의 참조 얻기
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
' "A1" 셀에 샘플 값 추가
worksheet.Cells("A1").PutValue(50)
' "A2" 셀에 샘플 값 추가
worksheet.Cells("A2").PutValue(100)
' "A3" 셀에 샘플 값 추가
worksheet.Cells("A3").PutValue(150)
' "A4" 셀에 샘플 값 추가
worksheet.Cells("A4").PutValue(200)
' "B1" 셀에 샘플 값 추가
worksheet.Cells("B1").PutValue(60)
' "B2" 셀에 샘플 값 추가
worksheet.Cells("B2").PutValue(32)
' "B3" 셀에 샘플 값 추가
worksheet.Cells("B3").PutValue(50)
' "B4" 셀에 샘플 값 추가
worksheet.Cells("B4").PutValue(40)
' "C1" 셀에 카테고리 데이터로 샘플 값 추가
worksheet.Cells("C1").PutValue("Q1")
' "C2" 셀에 카테고리 데이터로 샘플 값 추가
worksheet.Cells("C2").PutValue("Q2")
' "C3" 셀에 카테고리 데이터로 샘플 값 추가
worksheet.Cells("C3").PutValue("Y1")
' "C4" 셀에 카테고리 데이터로 샘플 값 추가
worksheet.Cells("C4").PutValue("Y2")
'워크시트에 차트 추가
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'새로 추가된 차트의 인스턴스에 접근
Dim chart As Chart = worksheet.Charts(chartIndex)
' "A1" 셀에서 "B4"까지 차트 데이터 소스로 NSeries 추가
Dim seriesIndex As Int32 = chart.NSeries.Add("A1:B4", True)
' NSeries의 카테고리 데이터 소스 설정
chart.NSeries.CategoryData = "C1:C4"
Dim series As Series = chart.NSeries(seriesIndex)
' 시리즈의 값 설정
series.Values = "=B1:B4"
' 시리즈의 차트 유형 변경
series.Type = ChartType.Line
' 마커 속성 설정
series.Marker.MarkerStyle = ChartMarkerType.Circle
series.Marker.ForegroundColorSetType = FormattingType.Automatic
series.Marker.ForegroundColor = System.Drawing.Color.Black
series.Marker.BackgroundColorSetType = FormattingType.Automatic
'Excel 파일 저장
workbook.Save("book1.xls")

속성

Area

Series 객체의 배경 영역을 나타냅니다.

public Area Area { get; }

속성 값

Area

Bar3DShapeType

3D 막대 또는 열 차트에서 사용되는 3D 모양 유형을 가져오거나 설정합니다.

public Bar3DShapeType Bar3DShapeType { get; set; }

속성 값

Bar3DShapeType

Border

Series 객체의 테두리를 나타냅니다.

public Line Border { get; }

속성 값

Line

BubbleScale

지정된 차트 그룹에서 버블의 스케일 팩터를 가져오거나 설정합니다. 0(제로)에서 300까지의 정수 값일 수 있으며, 기본 크기의 백분율에 해당합니다. 버블 차트에만 적용됩니다.

public int BubbleScale { get; set; }

속성 값

int

BubbleSizes

차트 시리즈의 버블 크기 값을 가져오거나 설정합니다.

public string BubbleSizes { get; set; }

속성 값

string

CountOfDataValues

데이터 값의 수를 가져옵니다.

public int CountOfDataValues { get; }

속성 값

int

DataLabels

지정된 ASeries에 대한 DataLabels 객체를 나타냅니다.

public DataLabels DataLabels { get; }

속성 값

DataLabels

DisplayName

차트 그래프에 표시되는 시리즈의 이름을 가져옵니다.

public string DisplayName { get; }

속성 값

string

DoughnutHoleSize

도넛 차트 그룹의 구멍 크기를 반환하거나 설정합니다. 구멍 크기는 차트 크기의 백분율로 표현되며, 10에서 90퍼센트 사이입니다.

public int DoughnutHoleSize { get; set; }

속성 값

int

DownBars

선형 차트의 다운 바를 나타내는 Aspose.Cells.Charts.DropBars 객체를 반환합니다. 선형 차트에만 적용됩니다.

public DropBars DownBars { get; }

속성 값

DropBars

DropLines

선형 차트 또는 영역 차트에서 시리즈의 드롭 라인을 나타내는 Aspose.Cells.Drawing.Line 객체를 반환합니다. 선형 차트 또는 영역 차트에만 적용됩니다.

public Line DropLines { get; }

속성 값

Line

Explosion

파이 차트의 중심에서 열린 파이 조각까지의 거리는 파이 지름의 백분율로 표현됩니다.

public int Explosion { get; set; }

속성 값

int

FirstSliceAngle

첫 번째 파이 차트 또는 도넛 차트 조각의 각도를 도(시계 방향으로 수직에서) 가져오거나 설정합니다. 파이, 3D 파이 및 도넛 차트에만 적용되며, 0에서 360 사이입니다.

public short FirstSliceAngle { get; set; }

속성 값

short

GapWidth

막대 또는 열 클러스터 사이의 간격을 막대 또는 열 너비의 백분율로 반환하거나 설정합니다. 이 속성의 값은 0에서 500 사이여야 합니다.

public short GapWidth { get; set; }

속성 값

short

Has3DEffect

시리즈에 3차원 외관이 있는 경우 true입니다. 버블 차트에만 적용됩니다.

public bool Has3DEffect { get; set; }

속성 값

bool

HasDropLines

차트에 드롭 라인이 있는 경우 true입니다. 선형 차트 또는 영역 차트에만 적용됩니다.

public bool HasDropLines { get; set; }

속성 값

bool

HasHiLoLines

선형 차트에 고저 라인이 있는 경우 true입니다. 선형 차트에만 적용됩니다.

public bool HasHiLoLines { get; set; }

속성 값

bool

HasLeaderLines

시리즈에 리더 라인이 있는 경우 true입니다.

public bool HasLeaderLines { get; set; }

속성 값

bool

HasRadarAxisLabels

레이다 차트에 카테고리 축 레이블이 있는 경우 true입니다. 레이다 차트에만 적용됩니다.

public bool HasRadarAxisLabels { get; set; }

속성 값

bool

HasSeriesLines

스택형 열 차트 또는 막대 차트에 시리즈 라인이 있거나 파이 차트 또는 막대 차트의 두 섹션 간에 연결선이 있는 경우 true입니다. 스택형 열 차트, 막대 차트, 파이 차트 또는 막대 차트에만 적용됩니다.

public bool HasSeriesLines { get; set; }

속성 값

bool

HasUpDownBars

선형 차트에 위 아래 바가 있는 경우 true입니다. 선형 차트에만 적용됩니다.

public bool HasUpDownBars { get; set; }

속성 값

bool

HiLoLines

선형 차트에서 시리즈의 고저 라인을 나타내는 HiLoLines 객체를 반환합니다. 선형 차트에만 적용됩니다.

public Line HiLoLines { get; }

속성 값

Line

IsAutoSplit

임계값이 자동인지 여부를 나타냅니다.

public bool IsAutoSplit { get; }

속성 값

bool

IsColorVaried

포인트의 색상이 다양하게 설정되어 있는지 나타냅니다. 차트에는 하나의 시리즈만 포함되어야 합니다.

public bool IsColorVaried { get; set; }

속성 값

bool

IsFiltered

시리즈가 선택되었거나 필터링되었는지 여부를 나타냅니다. true는 이 시리즈가 필터링되었으며 차트에 표시되지 않음을 나타냅니다.

public bool IsFiltered { get; set; }

속성 값

bool

IsVerticalValues

데이터 소스가 수직인지 여부를 나타냅니다.

public bool IsVerticalValues { get; }

속성 값

bool

LayoutProperties

레이아웃의 속성을 나타냅니다.

public SeriesLayoutProperties LayoutProperties { get; }

속성 값

SeriesLayoutProperties

LeaderLines

차트에서 리더 라인을 나타냅니다. 리더 라인은 데이터 레이블을 데이터 포인트에 연결합니다. 이 객체는 컬렉션이 아니며, 단일 리더 라인을 나타내는 객체는 없습니다.

public Line LeaderLines { get; }

속성 값

Line

LegendEntry

이 시리즈에 따라 범례 항목을 가져옵니다.

public LegendEntry LegendEntry { get; }

속성 값

LegendEntry

Marker

Aspose.Cells.Charts.Series.Marker?text=marker를 가져옵니다.

public Marker Marker { get; }

속성 값

Marker

Name

데이터 시리즈의 이름을 가져오거나 설정합니다.

public string Name { get; set; }

예시

//셀에 대한 참조 이름
chart.NSeries[0].Name = "=A1";

//이름에 문자열 설정
chart.NSeries[0].Name = "첫 번째 시리즈";
'셀에 대한 참조 이름
chart.NSeries[0].Name = "=A1"

'이름에 문자열 설정
chart.NSeries[0].Name = "첫 번째 시리즈"

Overlap

막대 및 열이 어떻게 배치되는지를 지정합니다. -100에서 100 사이의 값일 수 있습니다. 2D 막대 및 2D 열 차트에만 적용됩니다.

public short Overlap { get; set; }

속성 값

short

PlotOnSecondAxis

이 시리즈가 두 번째 값 축에 플로팅되는지 여부를 나타냅니다.

public bool PlotOnSecondAxis { get; set; }

속성 값

bool

Points

차트에서 시리즈의 포인트 컬렉션을 가져옵니다.

public ChartPointCollection Points { get; }

속성 값

ChartPointCollection

비고

차트가 파이 차트 또는 막대 차트인 경우 마지막 포인트는 첫 번째 파이 플롯의 다른 포인트입니다.

SecondPlotSize

파이 차트 또는 막대 차트의 보조 섹션 크기를 반환하거나 설정합니다. 기본 파이 크기의 백분율로, 5에서 200까지의 값일 수 있습니다.

public short SecondPlotSize { get; set; }

속성 값

short

SeriesLines

스택형 막대 차트 또는 스택형 열 차트의 시리즈 라인을 나타내는 SeriesLines 객체를 반환합니다. 스택형 막대 및 스택형 열 차트에만 적용됩니다.

public Line SeriesLines { get; }

속성 값

Line

Shadow

시리즈에 그림자가 있는 경우 true입니다.

public bool Shadow { get; set; }

속성 값

bool

ShapeProperties

Series의 시각적 모양 속성을 보유하는 Aspose.Cells.Drawing.ShapePropertyCollection 객체를 가져옵니다.

public ShapePropertyCollection ShapeProperties { get; }

속성 값

ShapePropertyCollection

ShowNegativeBubbles

차트 그룹에 대해 음수 버블이 표시되는 경우 true입니다. 버블 차트에 대해서만 유효합니다.

public bool ShowNegativeBubbles { get; set; }

속성 값

bool

SizeRepresents

버블 차트에서 버블 크기가 나타내는 것을 가져오거나 설정합니다.

public BubbleSizeRepresents SizeRepresents { get; set; }

속성 값

BubbleSizeRepresents

비고

BubbleSizeRepresents.SizeIsArea는 Aspose.Cells.Charts.Series.BubbleSizes의 값이 버블의 면적임을 의미합니다. BubbleSizeRepresents.SizeIsWidth는 Aspose.Cells.Charts.Series.BubbleSizes의 값이 버블의 너비임을 의미합니다.

Smooth

곡선 스무딩을 나타냅니다. 선형 차트 또는 산점도 차트에 대해 곡선 스무딩이 활성화된 경우 true입니다. 선형 및 산점도 차트에만 적용됩니다.

public bool Smooth { get; set; }

속성 값

bool

SplitType

파이 차트 또는 막대 차트에서 두 번째 파이 또는 막대에 어떤 데이터 포인트가 포함되는지를 결정하는 방법을 반환하거나 설정합니다.

public ChartSplitType SplitType { get; set; }

속성 값

ChartSplitType

SplitValue

파이 차트 또는 막대 차트에서 두 번째 파이 또는 막대에 포함될 데이터 포인트를 결정하는 데 사용되는 값을 반환하거나 설정합니다.

public double SplitValue { get; set; }

속성 값

double

TrendLines

이 시리즈의 모든 추세선을 반환합니다.

public TrendlineCollection TrendLines { get; }

속성 값

TrendlineCollection

Type

데이터 시리즈의 유형을 가져오거나 설정합니다.

public ChartType Type { get; set; }

속성 값

ChartType

UpBars

선형 차트의 업 바를 나타내는 DropBars 객체를 반환합니다. 선형 차트에만 적용됩니다.

public DropBars UpBars { get; }

속성 값

DropBars

Values

이 차트 시리즈의 Y 값을 나타냅니다.

public string Values { get; set; }

속성 값

string

ValuesFormatCode

Values의 NumberList의 형식 코드를 나타냅니다.

public string ValuesFormatCode { get; set; }

속성 값

string

XErrorBar

시리즈의 X 방향 오류 바를 나타냅니다.

public ErrorBar XErrorBar { get; }

속성 값

ErrorBar

XValues

차트 시리즈의 X 값을 나타냅니다.

public string XValues { get; set; }

속성 값

string

XValuesFormatCode

X Values의 NumberList의 형식 코드를 나타냅니다.

public string XValuesFormatCode { get; set; }

속성 값

string

YErrorBar

시리즈의 Y 방향 오류 바를 나타냅니다.

public ErrorBar YErrorBar { get; }

속성 값

ErrorBar

메서드

Move(int)

시리즈를 위 또는 아래로 이동합니다.

public void Move(int count)

매개변수

count int

위로 이동하는 수입니다. 0보다 작으면 시리즈를 위로 이동하고; 0보다 크면 시리즈를 아래로 이동합니다.

 한국어