Partager via


QueryBasedCollection<T> - Classe

Représente la classe de base de collection qui fournit la prise en charge de grandes collections d'échange et l'interrogation de la prise en charge, telles que le tri et le filtrage de données.

Hiérarchie d’héritage

System.Object
  Microsoft.SharePoint.Publishing.CollectionBase<T>
    Microsoft.SharePoint.Publishing.QueryBasedCollection<T>
      Microsoft.SharePoint.Publishing.PageLayoutCollection
      Microsoft.SharePoint.Publishing.PublishingPageCollection

Espace de noms :  Microsoft.SharePoint.Publishing
Assembly :  Microsoft.SharePoint.Publishing (dans Microsoft.SharePoint.Publishing.dll)

Syntaxe

'Déclaration
<SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel := True)> _
<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel := True)> _
Public MustInherit Class QueryBasedCollection(Of T As Class) _
    Inherits CollectionBase(Of T)
'Utilisation
Dim instance As QueryBasedCollection(Of T)
[SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel = true)]
[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel = true)]
public abstract class QueryBasedCollection<T> : CollectionBase<T>
where T : class

Paramètres de type

  • T

Remarques

En plus de la prise en charge de l'énumération foreach (For Each dans Visual Basic) et la propriété de Count fournis par la classe de base de CollectionBase , cette collection prend en charge de pagination de données grandes collections et l'interrogation de la prise en charge, telles que le tri et le filtrage.

Vous pouvez appliquer le tri et le filtrage à l'aide du langage CAML Collaborative Application Markup (Language), qui définit une requête à utiliser dans un objet deSPQueryMicrosoft SharePoint Foundation. Vous devez appliquer la requête CAML lorsque la collection est initialement créée ou extraite. Par exemple, la méthode PublishingWeb.GetPages a des surcharges qui prennent une chaîne CAML directement et surcharges qui prennent une instance SPQuery qui possède une propriété SPQuery.Query . Vous pouvez utiliser la balise < OrderBy > CAML pour trier la collection. Par exemple, pour trier une collection dans l'ordre croissant en fonction du titre, utilisez la requête CAML.

<OrderBy><FieldRef Name="Title" Ascending="TRUE"></FieldRef></OrderBy>

Le CAML < emplacement > balise peut être utilisée pour le filtrage de la collection.

Pour filtrer une collection basée sur le titre correspondant à une valeur « abc », utilisez la requête CAML.

<Where><Eq><FieldRef Name="Title"></FieldRef><Value Type="Text">abc</Value></Eq></Where>

Cette collection prend également en charge les données d'échange, permettant ainsi à des sous-ensembles de la collection à récupérer. Vous devez spécifier le nombre maximal d'objets à récupérer dans chaque sous-ensemble lorsque la collection est initialement créée ou extraite. Par exemple, la méthode PublishingWeb.GetPages a des surcharges qui prennent une nombre limite de lignes et surcharges qui prennent une instance SPQuery qui possède une propriété SPQuery.RowLimit . La méthode QueryNext peut être utilisée pour passer au sous-ensemble suivant des données paginées.

Cohérence de thread

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.

Voir aussi

Référence

QueryBasedCollection<T> - Membres

Microsoft.SharePoint.Publishing - Espace de noms