Retrieves the caption of a data series from its index.

object.GetSeriesCaption index 

Arguments

object

Required. A Chart object.

index

Required. An integer value that specifies the zero-based index of the series in the chart object.

Return Value

The GetSeriesCaption method returns a string value that contains the caption for the series specified by index.

Remarks

If the index argument refers to a series that does not exist in the chart object, the GetSeriesCaption method raises an invalid series index error.

• index must be superior or equal to 0.

The GetSeriesCaption method can return an empty string. This happens when the chart object contains series values without any corresponding caption, or when the series does not exist.

VBScript Sample Code

The following VBScript code enumerates the series stored in a chart object and displays their caption in an ASP page.

'Fill the chart object with data and categories stored in the query string 
chart.SetDataFromQuery

'Retrieve the number of series stored in the chart object 
n_series= chart.GetSeriesCount

If n_series = 0 Then
  Response.Write "No series available"
Else
  'Enumerate the series stored in the chart object 
  For i = 0 to (n_series-1)
    Response.Write chart.GetSeriesCaption(i) & " is the Caption for series number " & i 
  Next
End If

See Also

SetSeriesCaption Method | GetSeriesValue Method | SetSeriesValuesFromString Method | SetSeriesValuesFromArray Method

Applies To: Chart Object