Share via

View, élément (Site)

  • Article

S’applique à : | SharePoint 2016 SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013

Utilisé dans une définition de site pour spécifier un affichage de liste pour une page à l’intérieur d’un module.

<View
  AggregateView = "TRUE" | "FALSE"
  BaseViewID = "Integer"
  DefaultView = "TRUE" | "FALSE"
  DisplayName = "Text"
  FailIfEmpty = "TRUE" | "FALSE"
  FileDialog = "TRUE" | "FALSE"
  FPModified = "TRUE" | "FALSE"
  FreeForm = "TRUE" | "FALSE"
  Hidden = "TRUE" | "FALSE"
  List = "Integer" } "Text"
  Name = "Text"
  OrderedView = "TRUE" | "FALSE"
  PageType = "Text"
  Path = "Text"
  ReadOnly = "TRUE" | "FALSE"
  RecurrenceRowset = "TRUE" | "FALSE"
  RowLimit = "Integer"
  Scope = "Text"
  ShowHeaderUI = "TRUE" | "FALSE"
  Threaded = "TRUE" | "FALSE"
  Type = "HTML" | "Chart" | "Pivot"
  Url = "URL"
  WebPartOrder = "Integer"
  WebPartZoneID = "Text">
</View>

Éléments et attributs

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut Description
AggregateView
Facultatif Boolean. TRUE pour spécifier que l’affichage est un vue Fusionner les formulaires utilisée dans une bibliothèque de formulaires XML. Par défaut, une bibliothèque de formulaires XML est mise en service avec une vue Fusionner les formulaires qui est initialement masquée. Lorsqu’un éditeur XML est utilisé pour publier un fichier XFP (XML Form Properties) dans le répertoire Forms de la bibliothèque avec un modèle utilisé par l’éditeur, l’attribut AggregateView identifie la vue Fusionner les formulaires, qui peut être rendue visible ou masquée selon que la définition ou le modèle de liste pour la bibliothèque prend ou non en charge la fusion des données.
BaseViewID
Integer facultatif. Spécifie l’ID de l’affichage de base.
DefaultView
Facultatif Boolean. TRUE pour spécifier que l’affichage est l’affichage par défaut.
DisplayName
Argument Text facultatif. Spécifie le nom de l’affichage qui apparaît sur la barre Lancement rapide.
FailIfEmpty
Facultatif Boolean. Si l’affichage ne retourne aucun élément, la valeur TRUE permet de retourner une page vierge et un code d’erreur HTTP au lieu de restituer l’élément ViewEmpty. Utilisé pour la manipulation par programme des affichages à partir d’une application cliente, afin que celle-ci n’ait pas besoin d’analyser un document pour découvrir si l’affichage est vide.
FileDialog
Facultatif Boolean. TRUE pour spécifier que l’affichage est affiché dans les boîtes de dialogue de fichier pour les applications utilisées dans le contexte de Microsoft SharePoint Foundation, qui analysent le code HTML de sortie pour déterminer le contenu de la liste.
FPModified
Facultatif Boolean. TRUE si l’affichage a été modifié par modification dans un éditeur de page web et que l’affichage n’est plus personnalisable par l’interface utilisateur de SharePoint Foundation.
Freeform
Facultatif Boolean. TRUE pour spécifier une autre mise en forme de champ pour le rendu de certains types de champs. En particulier, cela affecte l’alignement des colonnes de nombres, ce qui est notamment utile dans les types d’affichages non tabulaires personnalisés.
Hidden
Facultatif Boolean. TRUE pour masquer l’affichage.
List
Argument Integer ou Text facultatif. Spécifie le type de liste. Cette valeur peut être l'ID du modèle pour une liste (un entier) ou l'URL vers une liste mise en service dans le site (une chaîne). La méthode conseillée consiste à utiliser Text, car Integer peut ne pas être suffisamment spécifique (par exemple, s'il existe deux listes d'annonces dans le site et que vous spécifiez List=104).
Name
Texte facultatif. Nom donné à l’affichage (utilisé pour sélectionner un affichage nommé différent dans l’interface utilisateur, ainsi que pour faire référence à un affichage nommé lors de la spécification d’un filtre pour un champ Lookup).
OrderedView
Facultatif Boolean. TRUE pour spécifier que l’affichage est trié.
PageType
Argument Text facultatif. Spécifie le type du formulaire dans lequel l’affichage est utilisé.

Les valeurs possibles sont les suivantes :
DEFAULTVIEW Affichage par défaut.
DIALOGVIEW Affichage de la boîte de dialogue Fichier.
DISPLAYFORM Formulaire d’affichage des éléments de liste.
DISPLAYFORMDIALOG Formulaire d’affichage d’une boîte de dialogue de fichier.
EDITFORM Modifier le formulaire pour les éléments de liste.
EDITFORMDIALOG Modifier le formulaire d’une boîte de dialogue de fichier.
NON VALIDE Non utilisé.
MAXITEMS Non utilisé.
NEWFORM Nouveau formulaire pour les éléments de liste.
NEWFORMDIALOG Nouveau formulaire pour une boîte de dialogue de fichier.
NORMALVIEW Affichage normal.
SOLUTIONFORM Formulaire de solution.
VUE Affichage, y compris l’affichage par défaut et l’affichage normal.
Chemin
Text facultatif. Spécifie le nom de fichier pour l’affichage.
ReadOnly
Facultatif Boolean. TRUE pour que l’affichage soit disponible en lecture seule.
RecurrenceRowset
Facultatif Boolean. TRUE pour développer les événements périodiques dans l’affichage et afficher chaque instance de chaque événement périodique. La valeur par défaut est FALSE.
RowLimit
Integer facultatif. S’applique uniquement au type d’affichage HTML. Spécifie le nombre maximal de lignes à rendre sur n’importe quelle page. Lorsque la limite de ligne est dépassée, les boutons Next et Previous de la page permettent d’afficher d’autres parties du jeu d’enregistrements retourné.
Si RowLimit n’est pas spécifié, le nombre de lignes retournées par défaut est 50. Si « Aucun » est spécifié pour le type d’affichage, toutes les lignes du jeu d’enregistrements sont retournées dans un seul affichage.

Lorsqu’une vue est rendue, les variables ViewHasNext de rendu et ViewHasPrev sont définies sur TRUE ou FALSE, selon que l’affichage actuel a atteint la limite de lignes du jeu de données. Ces variables peuvent être utilisées dans des définitions de pages successives pour restituer les boutons Next et Previous sur la page, comme dans l’exemple suivant :
<Switch> <Expr><GetVar Name="ViewHasPrev"/></Expr> <Case Value="TRUE"><![CDATA[...Previous button defined here... ]]> </Case></Switch>

Les variables NextPageURL et PrevPageURL sont également définies sur des valeurs non vides lorsqu’il existe du contenu de pagination vers l’avant ou vers l’arrière à partir de l’affichage actuel. Ces variables peuvent être utilisées en créant les boutons Next et Previous de manière à avoir l’URL correcte qui permet d’accéder à la page de contenu suivante.
Scope
Text facultatif. Spécifie l'étendue récursive pour un affichage d’une bibliothèque de documents.

Les valeurs possibles sont les suivantes :
FilesOnly : montre uniquement les fichiers d’un dossier spécifique.
Recursive : montre tous les fichiers de tous les dossiers.
RecursiveAll : montre tous les fichiers et tous les sous-dossiers de tous les dossiers.

Si cet attribut n’est pas défini, l’affichage montre uniquement les fichiers et les sous-dossiers d’un dossier spécifique. La valeur de cet attribut correspond à la propriété Scope de la classe SPView .
ShowHeaderUI
Facultatif Boolean. FALSE pour afficher tous les éléments FieldRef utilisés dans le mode d’affichage d’en-tête sans décoration de l’interface utilisateur avec du code HTML. En d’autres termes, lorsque ce mode est défini, l’interface utilisateur ne fournit pas le tri et le filtrage sous forme de liens hypertexte dans l’en-tête de colonne. La valeur par défaut est TRUE.
Fileté
Facultatif Boolean. TRUE pour appliquer le regroupement interne dans l’affichage. Un affichage thématique est construit selon la colonne de threading intégrée (supposée exister pour la liste). La vue est triée sur ce champ en tant que tri secondaire. Si d'autres colonnes de la vue sont marquées comme étant triées ou regroupées, elles sont appliquées avant l'ordre de tri des colonnes de thread. Toutes les discussions regroupées par thème peuvent ainsi être réunies, et le thread de message peut être affiché sous la collection.

Lorsque la valeur est TRUE, l’élément RowLimit a une signification différente s’il est utilisé sur un affichage de liste de forum de discussion à thème. Au lieu de spécifier le nombre d’éléments à retourner, il spécifie le nombre de discussions thématiques à retourner, où un thème peut être constitué d’un ou plusieurs éléments. En plus d’avoir l’attribut Threaded défini sur TRUE, une vue threaded doit être triée par l’ID de thread pour que ce comportement de limite de lignes prenne effet.
Type
Text facultatif. Spécifie le type de rendu de l’affichage. Le type est la vue HTML énumérée commune et peut être défini sur HTML, Chart, Pivot, GANTT ou CALENDAR.
Url
URL facultatif. Spécifie l’URL de l’affichage.
WebPartOrder
Entier facultatif. Spécifie le positionnement vertical du composant WebPart dans une zone.
WebPartZoneID
Texte facultatif. Spécifie la zone pour le composant WebPart.

Éléments enfants

Éléments parents

Occurrences

  • Minimum : 0
  • Maximum : pas de limite

Remarques

Pour obtenir un exemple qui utilise l’élément View , consultez Module, élément (Site) .