arrow-left
All pages
gitbookPowered by GitBook
1 of 8

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Other Components

Wisej.NET provides additional components for specialized functionality like data binding, performance monitoring, messaging, and timing operations. These components enhance applications with system integration and utility features beyond standard UI controls.

BindingSource

Encapsulates the data source for a data-bound component.

The Wisej.NET BindingSource component simplifies data binding by providing currency management, change notification, and intermediary services between controls and data sources. Connect to data through the DataSource property, optionally specifying a DataMember for complex scenarios.

hashtag
Features

hashtag
Data Access

Access underlying data through:

  • Current: Get or modify the current item

  • List: Access the complete data collection

hashtag
Data Operations

Manage data with methods like:

  • RemoveCurrent: Delete current item

  • EndEdit: Commit changes

  • CancelEdit: Discard changes

hashtag
Event Customization

Customize behavior through events:

  • CurrentItemChanged: React to current item updates

  • DataSourceChanged: Handle data source modifications

hashtag
Navigation Integration

Works seamlessly with the control through its BindingNavigator.BindingSource property for VCR-style data navigation.

hashtag
Value Refresh

The RefreshValueOnChange property enables automatic source property updates when data-bound values change.

circle-info

For a full list of properties, methods and events see the

Add/AddNew: Create new items

BindingNavigator
API documentation.arrow-up-right

Timer

Implements a timer that raises an event at user-defined intervals.

The Wisej.NET Timer component provides client-side timing functionality, raising a Tick event after the specified Interval in milliseconds has elapsed. Declare Timer objects at the class level to maintain scope throughout their needed lifetime.

circle-info

For a full list of properties, methods and events see the API documentation.arrow-up-right

hashtag
Features

hashtag
Interval Processing

Configure the Timer for regular processing by:

  1. Setting the Interval property (in milliseconds)

  2. Handling the Tick event for periodic operations

hashtag
Advanced

hashtag
JavaScript Widget

Item
Description

Class name

"wisej.web.Timer"

Source code

https://github.com/iceteagroup/wisej-jsarrow-up-right

Timer incrementing a label value at regular intervals

PerformanceCounter

Enables reading and writing performance data through Windows Performance Monitor.

The Wisej.NET PerformanceCounter component enables reading predefined or custom performance counters and publishing data to custom counters through Windows Performance Monitor.

circle-info

The PerformanceCounter implements IDisposable. Always dispose of it either:

  • Directly: Call Dispose() in a try/catch block

  • Indirectly: Use language constructs like using (C#) or Using (VB)

hashtag
Features

hashtag
Counter Types

Two main usage scenarios:

  • Read existing predefined or custom counters

  • Publish (write) performance data to custom counters

hashtag
Predefined Counters

Access numerous predefined counters through Windows Performance Monitor's .

circle-info

For detailed information about performance monitoring, see:

DataSet

Represents an in-memory cache of data.

The Wisej.NET DataSet component provides an in-memory cache of data retrieved from a data source, serving as a key component of the ADO.NET architecture. A DataSet contains a collection of DataTable objects that can be related through DataRelation objects. Data integrity is maintained using UniqueConstraint and ForeignKeyConstraint objects.

hashtag

Using Objects that Implement IDisposablearrow-up-right

Add Counters dialog boxarrow-up-right
.NET Framework Performance Countersarrow-up-right
System.Diagnostics.PerformanceCounter on MSDNarrow-up-right
Features

hashtag
Table Management

The DataTableCollection, accessed through the Tables property, contains the data tables. Table names are conditionally case-sensitive - if "mydatatable" exists but "Mydatatable" doesn't, searches become case-insensitive.

hashtag
Data Relations

The DataRelationCollection enables navigation through table hierarchies, establishing relationships between tables in the DataSet.

hashtag
XML Integration

The DataSet supports XML operations for data and schema:

  • WriteXmlSchema: Save schema as XML

  • WriteXml: Save both schema and data

  • ReadXml: Load XML documents containing schema and data

circle-info

For detailed information about working with DataSets, see:

  • DataSets, DataTables, and DataViewsarrow-up-right

  • Creating a DataTablearrow-up-right

EventLog

Provides interaction with Windows event logs.

The Wisej.NET EventLog component enables interaction with Windows event logs, which record important software and hardware events. Use it to read existing logs, write entries, manage event sources, and respond to log entries.

circle-info

The EventLog implements IDisposable. Always dispose of it either:

System.Data.DataSet on MSDNarrow-up-right

Directly: Call Dispose() in a try/catch block

  • Indirectly: Use language constructs like using (C#) or Using (VB)

  • hashtag
    Features

    hashtag
    Log Management

    Access and manage event logs through static EventLog members:

    • List available logs

    • Create or delete logs

    • Create or delete event sources

    • Check source existence on a computer

    hashtag
    Default Logs

    Windows provides three default event logs:

    • Application: General application events

    • System: Windows system events

    • Security: Security-related events (read-only)

    Additional logs may be available from installed applications and services like Active Directory.

    circle-info

    For detailed information about working with EventLogs, see:

    System.Diagnostics.EventLog on MSDNarrow-up-right
    Using Objects that Implement IDisposablearrow-up-right

    BindingNavigator

    Represents the navigation and manipulation user interface (UI) for controls that are bound to a data source.

    The Wisej.NET BindingNavigator provides standardized data navigation and manipulation. Typically paired with a BindingSource control through the BindingSource property, it enables intuitive record navigation and interaction.

    hashtag
    Features

    hashtag
    Default Interface

    The BindingNavigator includes ToolStrip elements for common data operations:

    • Navigation buttons (First, Previous, Next, Last)

    • Position and count indicators

    • Data manipulation buttons (Add, Delete)

    hashtag
    Control-Source Mapping

    When bound to a BindingSource, UI controls map directly to source functionality:

    UI Control
    BindingNavigator Member
    BindingSource Member

    hashtag
    Customization

    All contained controls support customization while maintaining the standard navigation interface.

    circle-info

    For a full list of properties, methods and events see the

    MessageQueue

    Provides access to a queue on a Message Queuing server.

    The Wisej.NET MessageQueue component wraps Windows Message Queuing technology, enabling communication between applications across heterogeneous networks and systems, even when temporarily offline. Applications can send, receive, or peek (read without removing) messages from queues.

    circle-exclamation

    Message Queuing is an optional Windows component that must be installed separately.

    hashtag
    Features

    hashtag
    Queue Operations

    The MessageQueue class provides methods for queue interaction:

    • Send(Object): Send messages to the queue

    • Peek: Read messages without removal

    • Receive: Retrieve and remove messages

    hashtag
    Queue Management

    Create new queues or connect to existing ones:

    1. Specify a path in the constructor to connect to existing queues

    2. Create new queues on the server

    3. Configure properties like Category and Label after association

    circle-info

    Behavior may vary slightly depending on the Message Queuing version and operating system. For details, see:

    System.Messaging.MessageQueue on MSDNarrow-up-right

    Move Next

    MoveNextItem

    MoveNext

    Move Last

    MoveLastItem

    MoveLast

    Add New

    AddNewItem

    AddNew

    Delete

    DeleteItem

    RemoveCurrent

    Move First

    MoveFirstItem

    MoveFirst

    Move Previous

    MovePreviousItem

    MovePrevious

    Current Position

    PositionItem

    Current

    Count

    CountItem

    API documentation.arrow-up-right
    BindingNavigator showing standard navigation controls

    Count