Partager via

View, élément (Site)

  • Article

Dernière modification : dimanche 11 avril 2010

S’applique à : SharePoint Foundation 2010

Dans cet article
Attributs
Éléments enfants
Éléments parents
Occurrences

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>

Attributs

Attribut

Description

AggregateView

Argument Boolean facultatif. 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

Argument Integer facultatif. Spécifie l’ID de l’affichage de base.

DefaultView

Argument Boolean facultatif. TRUE pour spécifier que l’affichage est l’affichage par défaut.

DisplayName

Argument Text facultatif. Spécifie le nom de la vue affichée sur la barre Lancement rapide.

FailIfEmpty

Argument Boolean facultatif. 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

Argument Boolean facultatif. TRUE pour spécifier que l’affichage apparaît dans les boîtes de dialogue de fichier pour les applications utilisées dans le contexte de Microsoft SharePoint Foundation, qui analysent la sortie HTML pour déterminer le contenu de la liste.

FPModified

Argument Boolean facultatif. TRUE si l’affichage a été modifié par le biais d’un éditeur de page Web et qu’il n’est plus personnalisable par l’interface utilisateur SharePoint Foundation.

FreeForm

Argument Boolean facultatif. 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

Argument Boolean facultatif. 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

Argument Text 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

Argument Boolean facultatif. 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 boîte de dialogue de fichier.

  • DISPLAYFORM   Formulaire d’affichage des éléments de liste.

  • DISPLAYFORMDIALOG   Formulaire d’affichage pour une boîte de dialogue de fichier.

  • EDITFORM   Formulaire de modification des éléments de liste.

  • EDITFORMDIALOG   Formulaire de modification pour une boîte de dialogue de fichier.

  • INVALID   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.

  • VIEW   Affichage, notamment l’affichage par défaut et l’affichage normal.

Path

Argument Text facultatif. Spécifie le nom de fichier pour l’affichage.

ReadOnly

Argument Boolean facultatif. TRUE pour que l’affichage soit disponible en lecture seule.

RecurrenceRowset

Argument Boolean facultatif. 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

Argument Integer facultatif. S’applique uniquement au type d’affichage HTML. Spécifie le nombre maximal de lignes à restituer 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’un affichage est restitué, les variables de rendu ViewHasNext et ViewHasPrev sont définies sur TRUE ou FALSE, selon que l’affichage actuel a atteint ou non la limite de lignes du groupe 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 prennent également des valeurs non vides si la mémoire tampon contient des données pour la page qui précède ou suit la page actuelle. 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

Argument 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

Argument Boolean facultatif. 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.

Threaded

Argument Boolean facultatif. 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). L’affichage est trié sur ce champ en tant que tri secondaire. Si d’autres colonnes de l’affichage sont spécifiées comme étant triées ou regroupées, ces règles sont appliquées avant l’ordre de tri des colonnes de threading. Ainsi, toutes les discussions regroupées par une rubrique peuvent être rassemblées, et le threading 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 thèmes de discussion à retourner, où un thème peut être constitué d’un ou plusieurs éléments. Outre le fait d’avoir l’attribut Threaded défini sur TRUE, un affichage thématique doit être trié par l’ID de thread afin que ce comportement de limite de ligne entre en vigueur.

Type

Argument Text facultatif. Spécifie le type de rendu de l’affichage. Le type est l’affichage HTML énuméré courant et peut être défini sur HTML,Chart, Pivot, GANTT ou CALENDAR.

Url

Argument URL facultatif. Spécifie l’URL de l’affichage.

WebPartOrder

Argument Integer facultatif. Spécifie le positionnement vertical du composant WebPart dans une zone.

WebPartZoneID

Argument Text facultatif. Spécifie la zone pour le composant WebPart.

Éléments enfants

Élément

BinarySerializedWebPart

Éléments parents

Fichier

Occurrences

Minimum : 0

Maximum : illimité

Remarques

Voir Module, élément (Site) pour un exemple d’utilisation de l’élément View.