NamedRange.DataSeries Method

Article
07/25/2011

Creates a data series in the NamedRange control.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
Function DataSeries ( _
    Rowcol As Object, _
    Type As XlDataSeriesType, _
    Date As XlDataSeriesDate, _
    Step As Object, _
    Stop As Object, _
    Trend As Object _
) As Object

Object DataSeries(
    Object Rowcol,
    XlDataSeriesType Type,
    XlDataSeriesDate Date,
    Object Step,
    Object Stop,
    Object Trend
)

Parameters

Rowcol
Type: System.Object
Can be the xlRows or xlColumns constant to have the data series entered in rows or columns, respectively. If this argument is omitted, the size and shape of the range is used.

Type
Type: Microsoft.Office.Interop.Excel.XlDataSeriesType
Can be one of the following XlDataSeriesType constants:
xlAutoFill
xlDataSeriesLinear
xlChronological
xlGrowth

Date
Type: Microsoft.Office.Interop.Excel.XlDataSeriesDate
If the Type argument is xlChronological, the Date argument indicates the step date unit.
Can be one of the following XlDataSeriesDate constants:
xlDay
xlWeekday
xlMonth
xlYear

Step
Type: System.Object
The step value for the series. The default value is 1 (one).

Stop
Type: System.Object
The stop value for the series. If this argument is omitted, Microsoft Office Excel fills to the end of the range.

Trend
Type: System.Object
true to create a linear trend or growth trend; false to create a standard data series. The default value is false.

Return Value

Type: System.Object

Remarks

Optional Parameters

For information on optional parameters, see Optional Parameters in Office Solutions.

Examples

The following code example creates a series of twelve dates. The series contains the last day of every month in 1996.

This example is for a document-level customization.

Private createMonthRange As Microsoft.Office.Tools.Excel.NamedRange

Private Sub CreateMonthSeries()
    createMonthRange = Me.Controls.AddNamedRange( _
        Me.Range("A1", "A12"), "createMonthRange")
    Me.Range("A1").Value2 = "31-JAN-1996"
    createMonthRange.DataSeries(, _
        Excel.XlDataSeriesType.xlChronological, _
        Excel.XlDataSeriesDate.xlMonth, 1, , False)
End Sub

Microsoft.Office.Tools.Excel.NamedRange createMonthRange;
private void CreateMonthSeries()
{
    createMonthRange = this.Controls.AddNamedRange(
        this.Range["A1", "A12"], "createMonthRange");
    this.Range["A1", missing].Value2 = "31-JAN-1996";
    createMonthRange.DataSeries(missing, 
        Excel.XlDataSeriesType.xlChronological, 
        Excel.XlDataSeriesDate.xlMonth, 1, missing, false);
}

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.