NamedRange.DataSeries Method

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.

See Also

Reference

NamedRange Interface

Microsoft.Office.Tools.Excel Namespace