Ready to get started?

Learn more about the CData ADO.NET Provider for Alfresco or download a free trial:

Download Now

LINQ to Alfresco Data

LINQ provides general-purpose query facilities in .NET Framework 3.0 and above and provides one easy way to programmatically access data through from CData ADO.NET Data Providers. This example uses LINQ to access information from the Alfresco Data Provider.

This article demonstrates how to use LINQ to access Alfresco tables through the CData ADO.NET Data Provider for Alfresco. To do this you will LINQ to Entity Framework, which is used to generate the connection and can be used with any CData ADO.NET Data Providers to access data via LINQ.

See the help documentation for a guide to setting up an EF 6 project to use the provider.

  1. In a new project in Visual Studio, right-click on the project and choose to add a new item. Add an ADO.NET Entity Data Model.
  2. Choose EF Designer from Database and click Next.
  3. Add a new Data Connection, and change your data source type to "CData Alfresco Data Source".
  4. Enter your data source connection information.

    To connect to Alfresco, the following connection properties must be supplied: User, Password, and InstanceUrl. User and Password correspond to the login credentials that you use to access Alfresco in a web browser. InstanceUrl corresponds to the Alfresco instance you will be querying. For instance, if you expect your queries to hit https://search-demo.dev.alfresco.me/alfresco/api/-default-/public/search/versions/1/sql, you should supply search-demo.dev.alfresco.me for InstanceUrl.

    Below is a typical connection string:

    User=MyUsername; Password=MyPassword; Format=Solr; InstanceUrl=api-explorer.alfresco.com;
  5. If saving your entity connection to App.Config, set an entity name. In this example we are setting AlfrescoEntities as our entity connection in App.Config.
  6. Enter a model name and select any tables or views you would like to include in the model.

Using the entity you created, you can now perform select commands. For example:

AlfrescoEntities context = new AlfrescoEntities(); var alfrescoQuery = from alfresco in context.Alfresco select alfresco; foreach (var result in alfrescoQuery) { Console.WriteLine("{0} {1} ", result.Id, result.DBID); }

See "LINQ and Entity Framework" chapter in the help documentation for example queries of the supported LINQ.