Intersoft ClientUI Documentation
CanUserSortColumns Property
See Also  Send Feedback
Intersoft.Client.UI.Data Namespace > UXGridView Class : CanUserSortColumns Property






Gets or sets a value that indicates whether the user can sort columns by clicking the column header.

Syntax

Visual Basic (Declaration) 
<CategoryAttribute("Columns")>
Public Property CanUserSortColumns As Boolean
Visual Basic (Usage)Copy Code
Dim instance As UXGridView
Dim value As Boolean
 
instance.CanUserSortColumns = value
 
value = instance.CanUserSortColumns
C# 
[CategoryAttribute("Columns")]
public bool CanUserSortColumns {get; set;}
Delphi 
public read-write property CanUserSortColumns: Boolean;
JScript 
CategoryAttribute("Columns")
public function get,set CanUserSortColumns : boolean
Managed Extensions for C++ 
[CategoryAttribute("Columns")]
public: __property bool get_CanUserSortColumns();
public: __property void set_CanUserSortColumns( 
   bool value
);
C++/CLI 
[CategoryAttribute("Columns")]
public:
property bool CanUserSortColumns {
   bool get();
   void set (    bool value);
}

Remarks

To enable data sorting in UXGridView, you set the CanUserSortColumns property of UXGridView to true. If you prefer to enable sorting only on certain columns, set the CanUserSort property of the UXGridColumn to true.

XAML Copy Code 
<Intersoft:UXGridView CanUserSortColumns="True">        
    <Intersoft:UXGridView.Columns>        
        <Intersoft:UXGridViewTextColumn Header="Customer ID" Binding="{Binding CustomerID}" CanUserSort="False"/>
        <Intersoft:UXGridViewTextColumn Header="Contact Name" Binding="{Binding ContactName}"/>
        <Intersoft:UXGridViewTextColumn Header="Contact Title" Binding="{Binding ContactTitle}"/>
        <Intersoft:UXGridViewTextColumn Header="CompanyName" Binding="{Binding CompanyName}"/>
    </Intersoft:UXGridView.Columns>
</Intersoft:UXGridView>

Depending on the value of the QueryOperation property, the data sorting can be handled in either client or server side.

Client Data Operation

Client data operation means that the data operation such as sorting is executed in the client against the data source provided to UXGridView. To enable this mode, you set the QueryOperation property to Client.

You typically use a collection that implements IPagedCollectionView as the data source or encapsulate the collection to a PagedCollectionView class. To learn how to perform client-side sorting, filtering and paging using UXGridView, see How-to: Implement Client-side Sorting, Filtering and Paging using UXGridView.

Server Data Operation

Server data operation means that the data operation such as sorting is processed in server rather than in client. In this mode, UXGridView does not handle the data operation by its own. It will simply provide the query information allowing you to process it further to a data service.

To use this mode, you set the QueryOperation property to Server. When this mode is selected, UXGridView will not attempt to perform the data operation on the given data source. Instead, it will store and distribute the query information to the SortDescriptors property. When the collection changes, the QueryChanged event of the associated QueryDescriptor will be raised. This allows you to streamline the query processing in a centralized function, which is one of the strong benefits of QueryDescriptor. For more information about QueryDescriptor, see QueryDescriptor Overview.

To learn how to perform server-side sorting, filtering and paging using UXGridView, see How-to: Implement Server-side Sorting, Filtering and Paging using UXGridView.

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2012 All Rights Reserved.