ADO.NET Provider for Microsoft Excel Online

Build 24.0.9060

Reverse Engineering (Scaffolding)

Reverse engineering (via scaffolding) is a process which streamlines OR/M by automatically constructing classes for all of the tables and views available via the Microsoft Excel Online schema. This process also creates a CDataContext class, which extends DbContext and exposes the DbSet properties that represent the tables in the data source.

Install Entity Framework Core Tools

If you're making use of scaffolding in a console app, you'll first need to install the EF Tools via the Package Manager Console (PMC).

Install-Package Microsoft.EntityFrameworkCore.Tools -Version 6.0 //Run this command if using EF Core 6.0

Scaffolding

Scaffolding is performed using the PMC in Visual Studio. You can use following commands to scaffold.

Scaffold All Tables

Use the following command to scaffold all tables and views from the schema into your Models folder:

Scaffold-DbContext "InitiateOAuth=GETANDREFRESH;" CData.EntityFrameworkCore.ExcelOnline -OutputDir Models -Context ExcelOnlineContext

Scaffold A Subset of Tables

You can also refine the scaffolding process to only create classes for a limited selection of tables. This is especially useful when a large schema is taking a long time to scaffold due to the large number of classes it has to generate. This is accomplished by specifying the tables/views that you want to scaffold at the end of your Scaffold-DbContext command in the PMC.

Scaffold-DbContext "InitiateOAuth=GETANDREFRESH;" CData.EntityFrameworkCore.ExcelOnline -OutputDir Models -Context ExcelOnlineContext  -Tables Test_xlsx_Sheet1 

Updating your Data Model

If you would like to re-scaffold to update the model with additional table classes after the initial generation, simply add a '-Force' argument to any Scaffold-DbContext command. The existing model will then be overwritten with your changes.

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 24.0.9060