NamedRange.DataSeries Method

Article
01/07/2014

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"].Value2 = "31-JAN-1996";
    createMonthRange.DataSeries(missing,
        Excel.XlDataSeriesType.xlChronological, 
        Excel.XlDataSeriesDate.xlMonth, 1, 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.

Share via