clinq Wiki & Documentation Rss Feed

New Comment on "Sample Usage Scenarios"

GerhardKreuzer — Thu, 02 Sep 2010 16:54:39 GMT

LINQ is Kinq .... after some extensions, your work really rocks!!!!

Updated Wiki: Home

akutruff — Wed, 06 Jan 2010 16:30:28 GMT

Project Description
Continous LINQ is a .NET Framework 3.5 extension that builds on the LINQ query syntax to create continuous, self-updating result sets.
In traditional LINQ queries, you write your query and get stale results. With Continuous LINQ,

you write a query and the results of that query are continuously updated as changes are made to the source collection or items within the source collection.

CLINQ has tremendous value in GUI development and is especially useful in binding to filtered streams of data such as financial or other network message data.

Getting Started

Reactive Programming

ReactiveObject NOTE: You must now also call OnPropertyChanging in addition to OnPropertyChanged when using ReactiveObject

Feature Roadmap - What we're thinking of adding to CLINQ in the future

Advanced Scenarios

Adding to a Source Collection from a Collection Changed Event Handler

Appendix and Reference

Updated Wiki: Home

akutruff — Wed, 06 Jan 2010 16:13:21 GMT

Feature Roadmap - What we're thinking of adding to CLINQ in the future

Advanced Scenarios

Appendix and Reference

Updated Wiki: Home

akutruff — Wed, 06 Jan 2010 15:49:55 GMT

Feature Roadmap - What we're thinking of adding to CLINQ in the future

Advanced Scenarios

Appendix and Reference

CLINQ FAQ
Supported LINQ Syntax
Supported Platforms
Cannot resolve link macro, invalid number of parameters.

Updated Wiki: Feature Roadmap

akutruff — Wed, 06 Jan 2010 15:46:32 GMT

Feature Roadmap

The following is a tentative list of some of the features that we're planning on implementing in upcoming releases of CLINQ.
As features are implemented in the release, this page will be updated. The idea is that the tentative feature plans will actually make it into the release notes and description for each release.

CLINQ v2.3.0.0

OrderBy improvements to prevent removal and addition to a list

Please suggest new features.

Updated Wiki: Supported LINQ Syntax

akutruff — Wed, 06 Jan 2010 15:44:54 GMT

Supported LINQ Syntax

The following is a list of the operators supported by CLINQ:

Supported operators

Where
Select
SelectMany
GroupBy
OrderBy (Ascending/Descending)
ThenBy (Ascending/Descending)
GroupJoin
Distinct
Except
Concat

Aggregation:

ContinuousSum
ContinuousContains
ContinuousFirstOrDefault
ContinuousMax
ContinuousMin

CLINQ does NOT support:

Join

Updated Wiki: Supported LINQ Syntax

akutruff — Wed, 06 Jan 2010 15:44:22 GMT

Supported LINQ Syntax

The following is a list of the operators supported by CLINQ:

Supported operators

Where
Select
SelectMany
GroupBy
OrderBy Ascending/Descending
ThenBy
GroupJoin
ContinuousFirstOrDefault
Distinct
Except
Concat

Aggregation:

ContinuousSum
ContinuousContains
ContinuousFirstOrDefault
ContinuousMax
ContinuousMin

CLINQ does NOT support:

Join

New Comment on "How CLINQ Works"

dotnetaddict — Mon, 16 Mar 2009 14:35:26 GMT

This is actually some old code.... but what used to happen when creating a new instance of the FVA was that the constructor for that class would create event listeners on the source... which meant that the FVA wouldn't be GC'd until the source was GC'd (another source of problems, actually).. but yes, we intended to not use the return value from the FVA creation. Have a look at some of the 2.0 code for how we're doing things now.

Updated Wiki: Smart Property Notification

DotNetAddict — Tue, 07 Oct 2008 17:23:30 GMT

Smart Property Notification

Smart Property Notification was added to CLINQ in the CLINQ v2.0.0.0 release.

Updated Wiki: Smart Property Notification

DotNetAddict — Tue, 07 Oct 2008 17:22:24 GMT

CLINQ v2.0.0.0 - Smart Property Notification

Updated Wiki: CLINQ v2.0 Features

DotNetAddict — Tue, 07 Oct 2008 17:21:56 GMT

CLINQ v2.0.0.0 Features

Updated Wiki: Smart Property Notification

DotNetAddict — Tue, 07 Oct 2008 17:18:18 GMT

CLINQ v2.0.0.0 - Smart Property Notification

Updated Wiki: Smart Property Notification

DotNetAddict — Tue, 07 Oct 2008 17:17:07 GMT

CLINQ v2.0 Features

Smart Property Notification

UPDATED WIKI: Create Your Own Continuous Aggregate

DotNetAddict — Fri, 02 May 2008 15:13:01 GMT

Creating Your Own Continuous Aggregate

UPDATED WIKI: Continuous Aggregation

DotNetAddict — Fri, 02 May 2008 15:12:43 GMT

Continuous Aggregation

Continuous Aggregation is the act of taking a continuous collection, or any other ObservableCollection, for that matter, and continuously updating a scalar value that is some kind of aggregation of that collection. For example, let's say you have a collection of Customers and you want to have a value on your WPF GUI that is a constantly updating number showing the sum of the customer ages. It could also be more complicated and show the sum total of all orders purchased by a subset of customers. The possibilities are endless.

The first thing you would do is create your continuous collection, potentially by using a CLINQ query over an observable collection, as shown below:

customersOverThirty = from cust in AllCustomers
                        where cust.Age > 30
                        select cust;

Then you create your continuous value object and invoke one of the aggregation extensions, such as ContinuousSum:

ContinuousValue<int> totalAge = customersOverThirty.ContinuousSum<Customer>(c => c.Age);

If you want to get really fancy, you can even nest/chain continuous aggregations together, as shown here:

ContinuousValue<double> totalPrice = customersOverThirty.ContinuousSum<Customer>(
    c => c.Orders.ContinuousSum<Order>( o => o.Price ));

Now you can safely place this continuous value in your model object, a model singleton, or the datacontext of a WPF window and the WPF GUI will automatically be made aware of the changes to that scalar value!

Click here to see how you can Create Your Own Continuous Aggregate.

Continuous Aggregation should be available in the 1.1.0.0 release - CLINQ v1.1.0.0

UPDATED WIKI: CLINQ FAQ

javaerb — Thu, 17 Apr 2008 14:23:20 GMT

FAQ

Cannot Change ObservableCollection During a CollectionChanged Event

"I am writing some code where, in response to an item being added to a collection in my adapter chain, I need to add an item to the source collection.
I get the error message 'Cannot change ObservableCollection During a CollectionChanged Event'. Is there a way around this?"

Actually, yes, there is a way around it. If you are planning on inserting a row into the source collection which triggered the current event handler, you need to defer the work of adding the new item to a background thread, this will circumvent the re-entry barrier on ObservableCollection. Keep in mind, however, that putting it on the background thread won't save you if your code isn't designed to avoid an infinite loop of item additions - you will need to plan around that carefully.

A detailed examination of this exact scenario, including the solution code, can be found here:
Adding to a Source Collection from a Collection Changed Event Handler

Is CLINQ Thread-Safe?

The short answer is, "no." Any synchronization between threads must be done by you. Using the ContinuousCollection class as your source collection will ensure that all updates happen on the dispatcher on which the collection was created (in a WPF scenario). CLINQ will also guarantee that updates to the source collection or to properties are visible when the query is bound to a WPF control, as long as the source collection is created on the GUI dispatcher. Other than that, no thread-safety guarantees are made. That would make the code way too complex, and we seek to maintain only the core functionality necessary to make this all work.

UPDATED WIKI: Supported LINQ Syntax

javaerb — Wed, 16 Apr 2008 20:52:53 GMT

Supported LINQ Syntax

While CLINQ is an attempt at as complete an implementation of the LINQ syntax as possible, there are some LINQ queries that just don't make sense for CLINQ to implement and others would just be too difficult to implement for such a small gain in value. The following is a list of the operators supported by CLINQ:

Where
Select
SelectMany
GroupBy
OrderBy (including ThenBy)

CLINQ does NOT support:

Join

UPDATED WIKI: Continuous Aggregation

DotNetAddict — Wed, 16 Apr 2008 12:39:56 GMT

Continuous Aggregation

customersOverThirty = from cust in AllCustomers
                        where cust.Age > 30
                        select cust;

Then you create your continuous value object and invoke one of the aggregation extensions, such as ContinuousSum:

ContinuousValue<int> totalAge = customersOverThirty.ContinuousSum<Customer>(c => c.Age);

If you want to get really fancy, you can even nest/chain continuous aggregations together, as shown here:

ContinuousValue<double> totalPrice = customersOverThirty.ContinuousSum<Customer>(
    c => c.Orders.ContinuousSum<Order>( o => o.Price ));

Now you can safely place this continuous value in your model object, a model singleton, or the datacontext of a WPF window and the WPF GUI will automatically be made aware of the changes to that scalar value!

Continuous Aggregation should be available in the 1.1.0.0 release - CLINQ v1.1.0.0

UPDATED WIKI: Continuous Aggregation

DotNetAddict — Wed, 16 Apr 2008 12:38:12 GMT

Continuous Aggregation

customersOverThirty = from cust in AllCustomers
                        where cust.Age > 30
                        select cust;

Then you create your continuous value object and invoke one of the aggregation extensions, such as ContinuousSum:

ContinuousValue<int> totalAge = customersOverThirty.ContinuousSum<Customer>(c => c.Age);

Now you can safely place this continuous value in your model object, a model singleton, or the datacontext of a WPF window and the WPF GUI will automatically be made aware of the changes to that scalar value!

Continuous Aggregation should be available in the 1.1.0.0 release - CLINQ v1.1.0.0

UPDATED WIKI: Continuous Aggregation

DotNetAddict — Wed, 16 Apr 2008 12:36:45 GMT

Continuous Aggregation

customersOverThirty = from cust in AllCustomers
                                  where cust.Age > 30
                                  select cust;

Then you create your continuous value object and invoke one of the aggregation extensions, such as ContinuousSum:

ContinuousValue<int> totalAge = customersOverThirty.ContinuousSum<Customer>(c => c.Age);