Working with data in ASP.NET CORE 3D Chart Component

9 Jan 202411 minutes to read

Local data

A simple JSON data can be bound to the 3D chart using DataSource property in series. Now map the fields in JSON to XName and YName properties.

<ejs-chart3d id="container" wallColor="transparent" enableRotation="true" rotation="7" tilt="10" depth="100">
    <e-chart3d-primaryxaxis valueType="@Syncfusion.EJ2.Charts.ValueType.Category"
        labelPlacement="@Syncfusion.EJ2.Charts.LabelPlacement.BetweenTicks" labelRotation="-45">
    </e-chart3d-primaryxaxis>
    <e-chart3d-series-collection>
        <e-chart3d-series dataSource="ViewBag.dataSource" xName="month" yName="sales"
            type="@Syncfusion.EJ2.Charts.Chart3DSeriesType.Column"></e-chart3d-series>
    </e-chart3d-series-collection>
</ejs-chart3d>
public ActionResult Index()
{
    List<ChartData> chartData = new List<ChartData>
    {
        new ChartData { month= "Jan", sales= 35 },
        new ChartData { month= "Feb", sales= 28 },
        new ChartData { month= "Mar", sales= 34 },
        new ChartData { month= "Apr", sales= 32 },
        new ChartData { month= "May", sales= 40 },
        new ChartData { month= "Jun", sales= 32 },
        new ChartData { month= "Jul", sales= 35 },
        new ChartData { month= "Aug", sales= 55 },
        new ChartData { month= "Sep", sales= 38 },
        new ChartData { month= "Oct", sales= 30 },
        new ChartData { month= "Nov", sales= 25 },
        new ChartData { month= "Dec", sales= 32 }
    };
    ViewBag.dataSource = chartData;
    return View();
}
public class ChartData
{
    public string month;
    public double sales;
}

Remote data

The remote data can be bound to the 3D chart using the DataManager. The DataManager requires minimal information like web service URL, adaptor and cross domain to interact with service endpoint properly. Assign the instance of the DataManager to the DataSource property in series and map the fields of data to XName and YName properties. You can also use the Query property of the series to filter the data.

<ejs-chart3d id="container" wallColor="transparent" enableRotation="true" rotation="7" tilt="10" depth="100">
    <e-chart3d-primaryxaxis valueType="@Syncfusion.EJ2.Charts.ValueType.Category"
        labelPlacement="@Syncfusion.EJ2.Charts.LabelPlacement.BetweenTicks" labelRotation="-45">
    </e-chart3d-primaryxaxis>
    <e-chart3d-series-collection>
        <e-chart3d-series xName="CustomerID" yName="Freight" type="@Syncfusion.EJ2.Charts.Chart3DSeriesType.Column"
            query="new ej.data.Query().take(5).where('Estimate', 'lessThan', 3, false)"></e-chart3d-series>
    </e-chart3d-series-collection>
    <e-data-manager url='https://services.syncfusion.com/aspnet/production/api/orders'></e-data-manager>
</ejs-chart3d>
public ActionResult Index()
{
    return View();
}

Binding data using ODataAdaptor

OData is a standardized protocol for creating and consuming data. You can retrieve data from OData service using the DataManager. Refer to the following code example for remote Data binding using OData service.

<ejs-chart3d id="container" wallColor="transparent" enableRotation="true" rotation="7" tilt="10" depth="100">
    <e-chart3d-primaryxaxis valueType="@Syncfusion.EJ2.Charts.ValueType.Category"
        labelPlacement="@Syncfusion.EJ2.Charts.LabelPlacement.BetweenTicks" labelRotation="-45">
    </e-chart3d-primaryxaxis>
    <e-chart3d-series-collection>
        <e-chart3d-series xName="CustomerID" yName="Freight" type="@Syncfusion.EJ2.Charts.Chart3DSeriesType.Column"
            query="new ej.data.Query()"></e-chart3d-series>
    </e-chart3d-series-collection>
    <e-data-manager url='https://services.syncfusion.com/aspnet/production/api/orders' adaptor="ODataAdaptor">
    </e-data-manager>
</ejs-chart3d>
public ActionResult Index()
{
    return View();
}

Empty points

The data points that uses the null or undefined as value are considered as empty points. The empty data points are ignored and is not plotted in the chart. When the data is provided by using the points property, by using EmptyPointSettings property in series, the empty can be customized. The default Mode of the empty point is Gap.

<ejs-chart3d id="container" wallColor="transparent" enableRotation="true" rotation="7" tilt="10" depth="100">
    <e-chart3d-primaryxaxis valueType="@Syncfusion.EJ2.Charts.ValueType.Category"
        labelPlacement="@Syncfusion.EJ2.Charts.LabelPlacement.BetweenTicks" labelRotation="-45">
    </e-chart3d-primaryxaxis>
    <e-chart3d-series-collection>
        <e-chart3d-series dataSource="ViewBag.dataSource" xName="month" yName="sales"
            type="@Syncfusion.EJ2.Charts.Chart3DSeriesType.Column">
            <e-chart3d-series-emptypointsettings
                mode="@Syncfusion.EJ2.Charts.EmptyPointMode.Gap"></e-chart3d-series-emptypointsettings>
        </e-chart3d-series>
    </e-chart3d-series-collection>
</ejs-chart3d>
public ActionResult Index()
{
    List<ChartData> chartData = new List<ChartData>
    {
        new ChartData { month= "Jan", sales= 35 },
        new ChartData { month= "Feb", sales= 28 },
        new ChartData { month= "Mar", sales= double.NaN },
        new ChartData { month= "Apr", sales= 32 },
        new ChartData { month= "May", sales= 40 },
        new ChartData { month= "Jun", sales= 32 },
        new ChartData { month= "Jul", sales= 35 },
        new ChartData { month= "Aug", sales= double.NaN },
        new ChartData { month= "Sep", sales= 38 },
        new ChartData { month= "Oct", sales= 30 },
        new ChartData { month= "Nov", sales= 25 },
        new ChartData { month= "Dec", sales= 32 }
    };
    ViewBag.dataSource = chartData;
    return View();
}
public class ChartData
{
    public string month;
    public double sales;
}

Customizing empty point

The specific color for empty point can be set by the Fill property in EmptyPointSettings.

<ejs-chart3d id="container" wallColor="transparent" enableRotation="true" rotation="7" tilt="10" depth="100">
    <e-chart3d-primaryxaxis valueType="@Syncfusion.EJ2.Charts.ValueType.Category"
        labelPlacement="@Syncfusion.EJ2.Charts.LabelPlacement.BetweenTicks" labelRotation="-45">
    </e-chart3d-primaryxaxis>
    <e-chart3d-series-collection>
        <e-chart3d-series dataSource="ViewBag.dataSource" xName="month" yName="sales"
            type="@Syncfusion.EJ2.Charts.Chart3DSeriesType.Column">
            <e-chart3d-series-emptypointsettings mode="@Syncfusion.EJ2.Charts.EmptyPointMode.Average"
                fill="green"></e-chart3d-series-emptypointsettings>
        </e-chart3d-series>
    </e-chart3d-series-collection>
</ejs-chart3d>
public ActionResult Index()
{
    List<ChartData> chartData = new List<ChartData>
    {
        new ChartData { month= "Jan", sales= 35 },
        new ChartData { month= "Feb", sales= 28 },
        new ChartData { month= "Mar", sales= double.NaN },
        new ChartData { month= "Apr", sales= 32 },
        new ChartData { month= "May", sales= 40 },
        new ChartData { month= "Jun", sales= 32 },
        new ChartData { month= "Jul", sales= 35 },
        new ChartData { month= "Aug", sales= double.NaN },
        new ChartData { month= "Sep", sales= 38 },
        new ChartData { month= "Oct", sales= 30 },
        new ChartData { month= "Nov", sales= 25 },
        new ChartData { month= "Dec", sales= 32 }
    };
    ViewBag.dataSource = chartData;
    return View();
}
public class ChartData
{
    public string month;
    public double sales;
}