Class Series
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
차트에서 단일 데이터 시리즈를 나타내는 객체를 캡슐화합니다.
public class Series
상속
상속된 멤버
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; }
속성 값
Bar3DShapeType
3D 막대 또는 열 차트에서 사용되는 3D 모양 유형을 가져오거나 설정합니다.
public Bar3DShapeType Bar3DShapeType { get; set; }
속성 값
Border
Series 객체의 테두리를 나타냅니다.
public Line Border { get; }
속성 값
BubbleScale
지정된 차트 그룹에서 버블의 스케일 팩터를 가져오거나 설정합니다. 0(제로)에서 300까지의 정수 값일 수 있으며, 기본 크기의 백분율에 해당합니다. 버블 차트에만 적용됩니다.
public int BubbleScale { get; set; }
속성 값
BubbleSizes
차트 시리즈의 버블 크기 값을 가져오거나 설정합니다.
public string BubbleSizes { get; set; }
속성 값
CountOfDataValues
데이터 값의 수를 가져옵니다.
public int CountOfDataValues { get; }
속성 값
DataLabels
지정된 ASeries에 대한 DataLabels 객체를 나타냅니다.
public DataLabels DataLabels { get; }
속성 값
DisplayName
차트 그래프에 표시되는 시리즈의 이름을 가져옵니다.
public string DisplayName { get; }
속성 값
DoughnutHoleSize
도넛 차트 그룹의 구멍 크기를 반환하거나 설정합니다. 구멍 크기는 차트 크기의 백분율로 표현되며, 10에서 90퍼센트 사이입니다.
public int DoughnutHoleSize { get; set; }
속성 값
DownBars
선형 차트의 다운 바를 나타내는 Aspose.Cells.Charts.DropBars 객체를 반환합니다. 선형 차트에만 적용됩니다.
public DropBars DownBars { get; }
속성 값
DropLines
선형 차트 또는 영역 차트에서 시리즈의 드롭 라인을 나타내는 Aspose.Cells.Drawing.Line 객체를 반환합니다. 선형 차트 또는 영역 차트에만 적용됩니다.
public Line DropLines { get; }
속성 값
Explosion
파이 차트의 중심에서 열린 파이 조각까지의 거리는 파이 지름의 백분율로 표현됩니다.
public int Explosion { get; set; }
속성 값
FirstSliceAngle
첫 번째 파이 차트 또는 도넛 차트 조각의 각도를 도(시계 방향으로 수직에서) 가져오거나 설정합니다. 파이, 3D 파이 및 도넛 차트에만 적용되며, 0에서 360 사이입니다.
public short FirstSliceAngle { get; set; }
속성 값
GapWidth
막대 또는 열 클러스터 사이의 간격을 막대 또는 열 너비의 백분율로 반환하거나 설정합니다. 이 속성의 값은 0에서 500 사이여야 합니다.
public short GapWidth { get; set; }
속성 값
Has3DEffect
시리즈에 3차원 외관이 있는 경우 true입니다. 버블 차트에만 적용됩니다.
public bool Has3DEffect { get; set; }
속성 값
HasDropLines
차트에 드롭 라인이 있는 경우 true입니다. 선형 차트 또는 영역 차트에만 적용됩니다.
public bool HasDropLines { get; set; }
속성 값
HasHiLoLines
선형 차트에 고저 라인이 있는 경우 true입니다. 선형 차트에만 적용됩니다.
public bool HasHiLoLines { get; set; }
속성 값
HasLeaderLines
시리즈에 리더 라인이 있는 경우 true입니다.
public bool HasLeaderLines { get; set; }
속성 값
HasRadarAxisLabels
레이다 차트에 카테고리 축 레이블이 있는 경우 true입니다. 레이다 차트에만 적용됩니다.
public bool HasRadarAxisLabels { get; set; }
속성 값
HasSeriesLines
스택형 열 차트 또는 막대 차트에 시리즈 라인이 있거나 파이 차트 또는 막대 차트의 두 섹션 간에 연결선이 있는 경우 true입니다. 스택형 열 차트, 막대 차트, 파이 차트 또는 막대 차트에만 적용됩니다.
public bool HasSeriesLines { get; set; }
속성 값
HasUpDownBars
선형 차트에 위 아래 바가 있는 경우 true입니다. 선형 차트에만 적용됩니다.
public bool HasUpDownBars { get; set; }
속성 값
HiLoLines
선형 차트에서 시리즈의 고저 라인을 나타내는 HiLoLines 객체를 반환합니다. 선형 차트에만 적용됩니다.
public Line HiLoLines { get; }
속성 값
IsAutoSplit
임계값이 자동인지 여부를 나타냅니다.
public bool IsAutoSplit { get; }
속성 값
IsColorVaried
포인트의 색상이 다양하게 설정되어 있는지 나타냅니다. 차트에는 하나의 시리즈만 포함되어야 합니다.
public bool IsColorVaried { get; set; }
속성 값
IsFiltered
시리즈가 선택되었거나 필터링되었는지 여부를 나타냅니다. true는 이 시리즈가 필터링되었으며 차트에 표시되지 않음을 나타냅니다.
public bool IsFiltered { get; set; }
속성 값
IsVerticalValues
데이터 소스가 수직인지 여부를 나타냅니다.
public bool IsVerticalValues { get; }
속성 값
LayoutProperties
레이아웃의 속성을 나타냅니다.
public SeriesLayoutProperties LayoutProperties { get; }
속성 값
LeaderLines
차트에서 리더 라인을 나타냅니다. 리더 라인은 데이터 레이블을 데이터 포인트에 연결합니다. 이 객체는 컬렉션이 아니며, 단일 리더 라인을 나타내는 객체는 없습니다.
public Line LeaderLines { get; }
속성 값
LegendEntry
이 시리즈에 따라 범례 항목을 가져옵니다.
public LegendEntry LegendEntry { get; }
속성 값
Marker
Aspose.Cells.Charts.Series.Marker?text=marker를 가져옵니다.
public Marker Marker { get; }
속성 값
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; }
속성 값
PlotOnSecondAxis
이 시리즈가 두 번째 값 축에 플로팅되는지 여부를 나타냅니다.
public bool PlotOnSecondAxis { get; set; }
속성 값
Points
차트에서 시리즈의 포인트 컬렉션을 가져옵니다.
public ChartPointCollection Points { get; }
속성 값
비고
차트가 파이 차트 또는 막대 차트인 경우 마지막 포인트는 첫 번째 파이 플롯의 다른 포인트입니다.
SecondPlotSize
파이 차트 또는 막대 차트의 보조 섹션 크기를 반환하거나 설정합니다. 기본 파이 크기의 백분율로, 5에서 200까지의 값일 수 있습니다.
public short SecondPlotSize { get; set; }
속성 값
SeriesLines
스택형 막대 차트 또는 스택형 열 차트의 시리즈 라인을 나타내는 SeriesLines 객체를 반환합니다. 스택형 막대 및 스택형 열 차트에만 적용됩니다.
public Line SeriesLines { get; }
속성 값
Shadow
시리즈에 그림자가 있는 경우 true입니다.
public bool Shadow { get; set; }
속성 값
ShapeProperties
Series의 시각적 모양 속성을 보유하는 Aspose.Cells.Drawing.ShapePropertyCollection 객체를 가져옵니다.
public ShapePropertyCollection ShapeProperties { get; }
속성 값
ShowNegativeBubbles
차트 그룹에 대해 음수 버블이 표시되는 경우 true입니다. 버블 차트에 대해서만 유효합니다.
public bool ShowNegativeBubbles { get; set; }
속성 값
SizeRepresents
버블 차트에서 버블 크기가 나타내는 것을 가져오거나 설정합니다.
public BubbleSizeRepresents SizeRepresents { get; set; }
속성 값
비고
BubbleSizeRepresents.SizeIsArea는 Aspose.Cells.Charts.Series.BubbleSizes의 값이 버블의 면적임을 의미합니다. BubbleSizeRepresents.SizeIsWidth는 Aspose.Cells.Charts.Series.BubbleSizes의 값이 버블의 너비임을 의미합니다.
Smooth
곡선 스무딩을 나타냅니다. 선형 차트 또는 산점도 차트에 대해 곡선 스무딩이 활성화된 경우 true입니다. 선형 및 산점도 차트에만 적용됩니다.
public bool Smooth { get; set; }
속성 값
SplitType
파이 차트 또는 막대 차트에서 두 번째 파이 또는 막대에 어떤 데이터 포인트가 포함되는지를 결정하는 방법을 반환하거나 설정합니다.
public ChartSplitType SplitType { get; set; }
속성 값
SplitValue
파이 차트 또는 막대 차트에서 두 번째 파이 또는 막대에 포함될 데이터 포인트를 결정하는 데 사용되는 값을 반환하거나 설정합니다.
public double SplitValue { get; set; }
속성 값
TrendLines
이 시리즈의 모든 추세선을 반환합니다.
public TrendlineCollection TrendLines { get; }
속성 값
Type
데이터 시리즈의 유형을 가져오거나 설정합니다.
public ChartType Type { get; set; }
속성 값
UpBars
선형 차트의 업 바를 나타내는 DropBars 객체를 반환합니다. 선형 차트에만 적용됩니다.
public DropBars UpBars { get; }
속성 값
Values
이 차트 시리즈의 Y 값을 나타냅니다.
public string Values { get; set; }
속성 값
ValuesFormatCode
Values의 NumberList의 형식 코드를 나타냅니다.
public string ValuesFormatCode { get; set; }
속성 값
XErrorBar
시리즈의 X 방향 오류 바를 나타냅니다.
public ErrorBar XErrorBar { get; }
속성 값
XValues
차트 시리즈의 X 값을 나타냅니다.
public string XValues { get; set; }
속성 값
XValuesFormatCode
X Values의 NumberList의 형식 코드를 나타냅니다.
public string XValuesFormatCode { get; set; }
속성 값
YErrorBar
시리즈의 Y 방향 오류 바를 나타냅니다.
public ErrorBar YErrorBar { get; }
속성 값
메서드
Move(int)
시리즈를 위 또는 아래로 이동합니다.
public void Move(int count)
매개변수
count
int
위로 이동하는 수입니다. 0보다 작으면 시리즈를 위로 이동하고; 0보다 크면 시리즈를 아래로 이동합니다.