BindingList<T> Standard Introduction

Generated Source Code Base Class

System.ComponentModel.BindingList<T>

Description

The BindingList<T> (BindingList(Of T) in Visual Basic) base class provides what can be considered to be a default implementation of the System.ComponentModel.IBindingList interface to provide clients with two-way data binding functionality. The BindingList<T> base class is not abstract and it can, therefore, be used as is, however, the class does not provide implementations of the ApplySortCore, FindCore or RemoveSortCore methods. The generated collection source code provides a closed constructed type, derived from the BindingList<T> base class that enhances the basic functionality by providing implementations of the ApplySortCore, FindCore and RemoveSortCore methods and appropriate overrides of the IsSortedCore, SortDirectionCore, SortPropertyCore, SupportsSearchingCore and SupportsSortingCore properties.

Typically, data bound components or controls that are using BindingList<T> access the data source using the IBindingList interface. Therefore BindingList<T> does not provide implicit, public, members for some of the core IBindingList members, this means that calling code needing to access a BindingList<T> or derived class instance has to cast the instance to IBindingList to make the relevant call.

The generated source code may include implicit, public, members for most of the core IBindingList members. For example, the generated source code may include public IsSorted, SortDirection and SortProperty properties and public Find, Sort and RemoveSort methods. Therefore, calling code can use an instance of the generated class without having to explicitly cast to IBindingList.

The BindingList<T> Standard generated source code depends on the PropertyComparer<T> class to search and sort collected items on the value of a specified property. You can generate the collection class source code with or without the PropertyComparer<T> class. This option is provided to allow you to generate more than one BindingList<T> Standard collection without paying for multiple copies of the PropertyComparer<T> class. In this situation you can generate the PropertyComparer<T> class with the first collection and then generate the other collection classes without the comparer class. However, if you are only generating a single collection, you must specify the option that includes the PropertyComparer<T> class.

Generated Source Code .Net Framework Version Compatibility

Versions: 3.5, 3.0 and 2.0

Generation Properties

You will be required to select/specify the following values in the generation property wizard as part of the source code generation process:

Property Description
Language You can generate either CSharp or Visual Basic source code
Collected Class Name The Type or Class name of the objects that are to be stored in the collection
Collection Class Name The Type or Class name of the collection
Namespace The collection class namespace (CSharp only)
String Comparison The string comparison to use when searching the collection using the value of a string property
Implicit Members Specify True to generate public search and sort members, False to provide explicit IBindingList access only
Allow Null Items Specify True if the collection is to allow null items to be added, False if not

Note

If a value type is specified as the collected class, the private, FindMatch method has to be modified to remove the check for a null item.

If the collected class is not in the same namespace as the collection class, a using (Imports in Visual Basic) statement will need to be added to the generated source code.

Visual Basic Only

If the collection class is not in the default (project) namespace i.e. it is in a sub-namespace, a Namespace statement will need to be added to the generated source code.

Terms and Conditions

Blayd Software retain the copyright and other intellectual rights to the source code as originally generated. However, once you have the source code, you may change it by altering members, adding new members or removing members and you may use the source code in your own personal or commercial projects, either in its original form or with your own alterations. We strongly recommend that you read the full terms and conditions for the use of the generated source code before continuing.

Hints and Tips

We have put together a page of hints and tips to help you get the most out of our .Net Framework source code generator. If you have any doubts or queries about the generation properties and their influence on the generated source code or any other queries we recommend that you read the hints and tips before continuing.

Payments by PayPal Save time. Check out securely. Pay without sharing your financial information. With PayPal, you can pay with a credit or debit card, bank account or PayPal balance.

Order Information

We guarantee that you will get the source code that you have paid for. In the unlikely but possible event that the transfer back to this site from our payment processor fails, we will reactivate the source code generator transaction so that you can complete the process and generate your source code.

To reactivate a paid for but failed source code generator transaction:

  • Direct your browser back to the Blayd Software website
  • Follow the "Contact Us" link in the footer of any of the site's pages or go directly to the Support Section, where you will find the Contact Us links
  • Use the "Code Generator Enquiry" link to email your order reference and a brief description of the problem to us

We will then email a reactivation link to you so that you can complete the generation process and get your source code.

Important

Please make a note of your order reference before clicking the "Buy Now" button. You can either note the reference down or select the reference on the page and copy it to the clipboard, then paste it into a text editor and save to file.

If you are not intending to pay using a PayPal account, you must return back to this site, using the option provided on the PayPal site. If you do not return directly from the PayPal site to this site you will not be able to generate your source code (see above for details of how to reactivate a failed transaction).

Order Reference: 634194097659616053
BindingList<T> Standard
(18.45) (15.00) (23.85)

BindingList<T> Standard with PropertyComparer<T>
(24.60) (20.00) (31.80)