PageableListT Class

Spotfire 14.3 API Reference
Represents a list that is divided into smaller blocks which are part of the Spotfire paging mechanism.
It is primarily intended to be used for storing a large number of values.
Best performance is achieved by only adding values to the end of the list. Inserting and removing elements is permitted but expensive from a performance perspective.
Inheritance Hierarchy

SystemObject
  Spotfire.Dxp.Data.CollectionsPageableListT

Namespace:  Spotfire.Dxp.Data.Collections
Assembly:  Spotfire.Dxp.Data (in Spotfire.Dxp.Data.dll) Version: 65.0.19510.3242 (65.0.19510.3242)
Syntax

C#
[SerializableAttribute]
[PersistenceVersionAttribute(3, 0)]
public sealed class PageableList<T> : IList, 
	ICollection, IEnumerable, IList<T>, ICollection<T>, IEnumerable<T>, 
	IDisposable, ISerializable

Type Parameters

T
The type for the values in the list.

The following types are currently supported:
bool
int
long
decimal
float
double
string
DateTime
TimeSpan
BinaryLargeObject

The PageableListT type exposes the following members.

Constructors

  NameDescription
Public methodPageableListT Obsolete.
Initializes a new instance of the PageableListT class that is empty.
Public methodPageableListT(IEnumerableT) Obsolete.
Initializes a new instance of the PageableListT class that contains elements copied from the specified collection.
Public methodPageableListT(PageableListSettings)
Initializes a new instance of the PageableListT class that is empty.
Public methodPageableListT(PageableListSettings, IEnumerableT)
Initializes a new instance of the PageableListT class that contains elements copied from the specified collection.
Top
Properties

  NameDescription
Public propertyCount
Gets the number of elements actually contained in the PageableListT.
Public propertyIsFixedSize
Gets a value indicating whether the PageableListT has a fixed size.
Public propertyIsReadOnly
Gets a value indicating whether the PageableListT is read-only.
Public propertyIsSynchronized
Gets a value indicating whether access to the PageableListT is synchronized (thread safe).
Public propertyItem
Gets or sets the element at the specified index.
Public propertySyncRoot
Gets an object that can be used to synchronize access to the PageableListT
Top
Methods

  NameDescription
Public methodAdd(Object)
Adds an object to the end of the PageableListT.
Public methodAdd(T)
Adds an object to the end of the PageableListT.
Public methodAsReadOnly
Returns this if read-only, otherwise a read-only clone.
Public methodAsWritable
Returns a writable clone if this is read-only, otherwise this.
Public methodClear
Removes all elements from the PageableListT.
Public methodContains(Object)
Determines whether an element is in the PageableListT.
Public methodContains(T)
Determines whether an element is in the PageableListT.
Public methodCopyTo(Array, Int32)
Copies the entire PageableListT to a compatible one-dimensional array, starting at the specified index of the target array.
Public methodCopyTo(T, Int32)
Copies the entire PageableListT to a compatible one-dimensional array, starting at the specified index of the target array.
Public methodDispose
Releases all memory associated with the PageableListT.
Public methodEnumerate
Returns an enumerator that iterate through the given elements.
Public methodEquals
Determines whether the specified object is equal to the current object.
(Inherited from Object.)
Public methodGetEnumerator
Returns an enumerator that iterates through a collection.
Public methodGetHashCode
Serves as the default hash function.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodIndexOf(Object)
Searches for the specified object and returns the zero-based index of the first occurrence within the entire PageableListT.
Public methodIndexOf(T)
Searches for the specified object and returns the zero-based index of the first occurrence within the entire PageableListT.
Public methodInsert(Int32, Object)
Inserts an element into the PageableListT at the specified index.
Public methodInsert(Int32, T)
Inserts an element into the PageableListT at the specified index.
Public methodRemove(Object)
Removes the first occurrence of a specific object from the PageableListT.
Public methodRemove(T)
Removes the first occurrence of a specific object from the PageableListT.
Public methodRemoveAt
Removes the element at the specified index of the PageableListT.
Public methodSetReadOnly
Calling this method will turn the list into a read-only collection. Any attempt to change the content after this call will throw an exception.
Public methodSort
Sorts the elements in the entire PageableListT using the default comparer.
Public methodSort(IComparerT)
Sorts the elements in the entire PageableListT using the specified comparer.
Public methodSortS(PageableListS)
Sorts a pair of PageableListT objects (this contains the keys and valueList contains the corresponding items) based on the keys in this. The default comparer is used when sorting.
Public methodSortS(PageableListS, IComparerT)
Sorts a pair of PageableListT objects (this contains the keys and valueList contains the corresponding items) based on the keys in this. The supplied comparer is used when sorting.
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Top
Explicit Interface Implementations

  NameDescription
Explicit interface implementationPrivate methodIEnumerableGetEnumerator
Returns an enumerator that iterates through a collection.
Explicit interface implementationPrivate methodISerializableGetObjectData
Populates a SerializationInfo with the data needed to serialize the target object.
Explicit interface implementationPrivate propertyIListItem
Gets or sets the element at the specified index.
Explicit interface implementationPrivate methodIListRemoveAt
Removes the IList item at the specified index.
Top
Remarks

A PageableListT is not thread safe for concurrent reading and writing, but if it is made read-only through a call to SetReadOnly multiple readers are handled in a thread safe manner.
In read-write mode synchronization needs to be implemented by the caller.

From Spotfire 2.2.0 the type parameter <T> may also be BinaryLargeObject, the Spotfire type used to represent a byte stream. From Spotfire 3.1.0 the following type parameters are added: bool, long, float and TimeSpan.

Version Information

Supported in: 14.3, 14.2, 14.1, 14.0, 12.5, 12.4, 12.3, 12.2, 12.1, 12.0, 11.8
See Also

Reference