ThunderDesign.Net-PCL.Threading 2.0.1

ThunderDesign.Net-PCL.Threading

A combination of generic Thread-Safe objects for .Net development.

🚀 Now with .NET 8 support and built-in Source Generators! 🚀

• .NET 8: Take advantage of the latest .NET features and performance improvements.
• Source Generators: Eliminate boilerplate and let the library generate thread-safe, bindable properties for you automatically!

Get started faster, write less code, and enjoy modern .NET development!

A simple C# repository containing a few basic useful Thread-Safe Objects.

Highlights include:

• Collections
  • CollectionThreadSafe
  • DictionaryThreadSafe
  • HashSetThreadSafe
  • LinkedListThreadSafe
  • ListThreadSafe
  • ObservableCollectionThreadSafe
  • ObservableDictionaryThreadSafe
  • QueueThreadSafe
  • SortedDictionaryThreadSafe
  • SortedListThreadSafe
  • StackThreadSafe
• DataCollections
  • ObservableDataCollection
  • ObservableDataDictionary
• DataObjects
  • BindableDataObject
  • DataObject
• Extentions
  • IBindableObjectExtention
  • INotifyCollectionChangedExtension
  • INotifyPropertyChangedExtension
  • ObjectExtention
• HelperClasses
  • ThreadHelper
• Interfaces
  • IBindableCollection
  • IBindableDataObject
  • IBindableDataObject<Key>
  • IBindableObject
  • ICollectionThreadSafe
  • IDataObject
  • IDataObject<Key>
  • IDictionaryThreadSafe
  • IHashSetThreadSafe
  • ILinkedListThreadSafe
  • IListThreadSafe
  • IObservableDataCollection
  • IObservableDataCollection<T>
  • ISortedDictionaryThreadSafe
  • IStackThreadSafe
• Objects
  • BindableObject
  • ThreadObject

Source Generators

The ThunderDesign.Net-PCL.Threading project provides Roslyn-based source generators that automate the creation of common boilerplate code for thread-safe and bindable objects in this library. By including this package in your project, you can reduce repetitive code and ensure consistency across your data and collection classes.

What does it do?

• Automatic Property Generation:
  The source generator scans your code for fields marked with specific attributes (such as [BindableProperty] or [Property]) and automatically generates the corresponding properties, including thread-safe accessors and INotifyPropertyChanged support where appropriate.
• Interface Implementation:
  If your class does not already implement interfaces like IBindableObject, the generator will add the necessary interface implementations and event wiring.
• Thread Safety:
  Generated properties use locking patterns to ensure thread safety, matching the patterns used throughout the ThunderDesign.Net-PCL.Threading library.

How to use

1. Add the NuGet package:
   Reference the ThunderDesign.Net-PCL.Threading package in your project. If you are building from source, add a project reference to ThunderDesign.Net-PCL.SourceGenerators.csproj.

2. Annotate your fields:
   Use [BindableProperty] or [Property] attributes on your fields to indicate which properties should be generated. The generator will handle the rest.

3. Build your project:
   When you build, the source generator will automatically add the generated code to your compilation. You do not need to manually include or maintain the generated files.

4. Enjoy less boilerplate:
   Your classes will have all the necessary properties, events, and thread-safety mechanisms without manual implementation.

Note: Source generators require Visual Studio 2019 16.9+ or .NET SDK 5.0+ for full support.

Example Usage

Suppose you want to create a thread-safe, bindable object with automatic property and notification support.
With the source generator, you only need to annotate your fields:

using ThunderDesign.Net.Threading.Attributes;
public partial class Person 
{ 
    [BindableProperty] 
    private string _name;

    [Property]
    private int _age;
}

What gets generated:

• A public Name property with thread-safe getter/setter and INotifyPropertyChanged support.
• A public Age property with thread-safe getter/setter.

using System.ComponentModel;
using System.Runtime.CompilerServices;
using ThunderDesign.Net.Threading.Extentions;
using ThunderDesign.Net.Threading.Interfaces;

public partial class Person : IBindableObject, INotifyPropertyChanged
{
    public event PropertyChangedEventHandler PropertyChanged;

    protected readonly object _Locker = new object();

    public string Name
    {
        get { return this.GetProperty(ref _name, _Locker); }
        set { this.SetProperty(ref _name, value, _Locker, true); }
    }

    public int Age
    {
        get { return this.GetProperty(ref _age, _Locker); }
        set { this.SetProperty(ref _age, value, _Locker); }
    }
}

You can now use your Person class like this:

var person = new Person(); 
person.Name = "Alice"; 
person.Age = 30; // PropertyChanged event will be raised for Name changes if you subscribe to it.

No need to manually implement property notification, thread safety, or boilerplate code—the generator does it for you!

For more advanced scenarios, you can use attribute parameters to control property behavior (e.g., read-only, also notify other properties, etc.).

Installation

Grab the latest ThunderDesign.Net-PCL.Threading NuGet package and install in your solution.

Install-Package ThunderDesign.Net-PCL.Threading

Use the -version option to specify an older version to install.

Examples

(TIP: Clone repo, open the solution, build it and run sample app.)

• Xamarin
  • SimpleContacts Example

Please Contribute!

This is an open source project that welcomes contributions/suggestions/bug reports from those who use it. If you have any ideas on how to improve the library, please post an issue here on GitHub. Please check out the How to Contribute.

Breaking changes from v1.0.7 to v1.0.8!

Observable Objects now Wait when calling PropertyChanged Event. This can be overwritten durring creation or by setting Property WaitOnNotifyPropertyChanged. Default value is true.

Observable Collections now Wait when calling CollectionChanged Event. This can be overwritten durring creation or by setting Property WaitOnNotifyCollectionChanged. Default value is true.

(TIP: If you experience Dead Locks change this value to false.)

Breaking changes from v1.0.9 to v1.0.10!

Observable Objects Property WaitOnNotifyPropertyChanged has been renamed to Property WaitOnNotifying.

Observable Collections Property WaitOnNotifyCollectionChanged has been removed and now uses Property WaitOnNotifying.