The Ocean Library is a cross-platform library that provides API's for WPF, Blazor, Xamarin, UWP, WebApi, Silverlight, and .NET Class Libraries. The Ocean Library has builds for .NET Framework, .NET Standard 2.0 and .NET Core 3.0.
| Ocean |
|---|
See the SetPropertyCodeSnippets.zip file for two code snippets for easily adding entity properties to entity classes that derive from BusinessEntityBase.
- Package: Oceanware.Ocean
- Package: Oceanware.Ocean.Blazor Validator
Oceanware.Ocean is the cross-platform library.
Package: Oceanware.Ocean
Library Features:
-
Validation
- Declarative rule attributes that decorate properties
- Rich set of provided validation rules
- Easy to create additional validation rules and attributes.
- Dynamically added rules that are shared across all instances of the type
- Dynamically added rules that are instance based, each instance has it's own copy of the rule to be applied
- RuleSet's allow object rules to be applied based on the object state or Active Rule Set
- Provides a ModelRulesInvoker to enable easy and simple integration with various UI stacks and their different requirements of validating input, a class, or class property.
-
Input String Correction
- Declarative rule attributes that decorate string properties
- Rich set of provided case correction rules
- Provides custom case correction rules and for application developers to add rules at run-time
- Provides a ModelRulesInvoker to enable easy and simple integration with various UI stacks and their different requirements of validating input, a class, or class property.
-
Audit
- Declarative rules attributes that decorate properties
- API to create either a string or dictionary that represents the state of the entity and property values, very useful in logging or populating exceptions with state data
- Enables skipping properties, for example a Password property values should not be logged.
-
Other
- Feature Rich Sample Data Generator
- Text encryption utility
- BusinessEntityBase class used for XAML applications and .NET Library projects
Oceanware.Ocean.Blazor is for Blazor UI projects.
Package: Oceanware.Ocean.Blazor Validator
Provides the OceanValidator that is the Blazor middleware between the Ocean validation and case correction library, and the Blazor UI. The OceanValidator replaces the DataAnnotations validation library validator.
Provides the OceanNumericInput component.
- Supports binding to Int32, Int32?, Int64, Int64?, Single, Single?, Double, Double?, Decimal, and Decimal? data types.
- Has a FormatString property.
- Prevents users from entering invalid numeric values and values with too many digits after the digits separator.
- String formatting of the entered values uses the culture-specific numeric separator, digits separator, and negative sign.
- Always uses CurrentCulture when performing string format operations.
- Allows entering and displaying a number separator. (the stock Blazor InputNumber component does not as it uses the HTML 5 input with type="number" that prevents a comma from being entered.
- Easily enable mobile browser numeric popup keyboard, set the BrowserInputMode property to Decimal or Numeric.
- Supports displaying the currency symbol in the input field if desired. To enable, set the FormatString to
c.
Provides the OceanAutoComplete component.
- Has a highly customizable auto complete experience.
- Search callback to return items.
- Selected item changed event when an item is selected or when user leaves the control without selecting an item.
- Change appearance of the search results container by creating a class ocean-blazor-auto-complete-container and setting desired values.
- Change appearance of the selected search result item by creating these classes ocean-blazor-selected-search-result, ocean-blazor-not-selected-search-result, and ocean-blazor-not-selected-search-result:hover and setting desired values..
- Handles the arrow up and down, page up and down, escape, enter, and tab keys.
- Arrow up and down move the selected item 1 item up or down.
- Page up and down move the selected item 6 items up or down.
- Escape closes the search results lists.
- Enter and tab keys raises the selected item changed event and closes the search results lists.
.NET Core 3.0 RTM, and latest Visual Studio 2019.
Back in 2008 I wrote a Code Project article about my initial WPF library for line-of-business applications. It was the foundation of Ocean.
April 2008 - Declarative Validation - Original Ocean Validation Library