View-Element (Website)

  • Artikel

Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online-| SharePoint Server 2013

Wird innerhalb einer Websitedefinition zum Angeben einer Listenansicht für eine Seite innerhalb eines Moduls verwendet.

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

Elemente und Attribute

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

Attribute

Attribut Beschreibung
AggregateView
Optionaler Boolean-Wert. Mit TRUE wird angegeben, dass es sich bei der Ansicht um eine Ansicht zum Zusammenführen von Formularen handelt, die in einer XML-Formularbibliothek verwendet wird. Standardmäßig wird eine XML-Formularbibliothek mit einer Ansicht zum Zusammenführen von Formularen bereitgestellt, die zunächst ausgeblendet ist. Wenn mit einem XML-Editor eine XFP-Datei (XML Form Properties) im Formularverzeichnis der Bibliothek zusammen mit einer Vorlage veröffentlicht wird, die vom Editor verwendet wird, wird durch das AggregateView-Attribut die Ansicht zum Zusammenführen von Formularen identifiziert, die abhängig davon, ob die Listenvorlage oder Definition für die Bibliothek das Zusammenführen von Daten unterstützt, eingeblendet oder ausgeblendet werden kann.
BaseViewID
Optionaler Integer-Wert. Gibt die ID der Basisansicht an.
DefaultView
Optionaler Boolean-Wert. Mit TRUE wird angegeben, dass die Ansicht die Standardansicht ist.
DisplayName
Optionaler Text. Gibt den Namen der Ansicht an, die auf der Schnellstartleiste angezeigt wird.
FailIfEmpty
Optionaler Boolean-Wert. Falls von der Ansicht keine Elemente zurückgegeben werden, lautet der Wert TRUE, um eine leere Seite und einen HTTP-Fehlercode zurückzugeben, anstatt das ViewEmpty-Element zu rendern. Wird für die programmgesteuerte Änderung von Ansichten von einer Clientanwendung verwendet, wobei verhindert wird, dass die Clientanwendung ein Dokument analysieren muss, um zu erkennen, ob die Ansicht leer ist.
FileDialog
Optionaler Boolean-Wert. TRUE , um anzugeben, dass die Ansicht in Dateidialogfeldern für Anwendungen angezeigt wird, die im Kontext von Microsoft SharePoint Foundation verwendet werden, die den AUSGABE-HTML-Code analysieren, um den Inhalt der Liste zu bestimmen.
FPModified
Optionaler Boolean-Wert. TRUE , wenn die Ansicht durch Bearbeiten in einem Webseiten-Editor geändert wurde und die Ansicht nicht mehr über die SharePoint Foundation-Benutzeroberfläche (UI) angepasst werden kann.
Freiform
Optionaler Boolean-Wert. Mit TRUE wird eine alternative Feldformatierung zum Rendern bestimmter Feldtypen angegeben. Dies hat besonders Auswirkungen auf die Ausrichtung von Zahlenspalten, was speziell bei benutzerdefinierten Ansichtstypen, die keine Tabellen enthalten, nützlich ist.
Hidden
Optionaler Boolean-Wert. TRUE zum Ausblenden der Ansicht.
List
Optionaler Integer- oder Text-Wert. Gibt den Listentyp an. Dieser Wert kann entweder die ID der Vorlage für eine Liste sein (eine ganze Zahl) oder die URL zu einer auf der Website bereitgestellten Liste (eine Zeichenfolge). Als bewährte Methode wird Text verwendet, da Integer möglicherweise nicht spezifisch genug ist (beispielsweise wenn zwei Ankündigungslisten auf der Website vorhanden sind und Sie List=104 angeben).
Name
Optionaler Text. Der Name der Ansicht (wird zum Auswählen einer anders benannten Ansicht in der Benutzeroberfläche sowie zum Verweisen auf eine benannte Ansicht durch Angabe eines Filters für ein Lookup-Feld verwendet).
OrderedView
Optionaler Boolean-Wert. Mit TRUE wird angegeben, dass die Ansicht sortiert ist.
PageType
Optionaler Text-Wert. Gibt den Formulartyp an, in dem die Ansicht verwendet wird.

Folgende Werte sind zulässig:
DEFAULTVIEW Standardansicht.
DIALOGVIEW Ansicht des Dialogfelds "Datei".
DISPLAYFORM Anzeigeformular für Listenelemente.
DISPLAYFORMDIALOG Formular für ein Dateidialogfeld anzeigen.
EDITFORM Bearbeitungsformular für Listenelemente.
EDITFORMDIALOG Formular bearbeiten für ein Dateidialogfeld.
UNGÜLTIG Nicht verwendet.
MAXITEMS Nicht verwendet.
NEWFORM Neues Formular für Listenelemente.
NEWFORMDIALOG Neues Formular für ein Dateidialogfeld.
NORMALVIEW Normalansicht.
SOLUTIONFORM Lösungsformular.
ANSEHEN Ansicht, einschließlich Standardansicht und Normalansicht.
Pfad
Optionaler Text-Wert. Gibt den Dateinamen für die Ansicht an.
ReadOnly
Optionaler Boolean-Wert. TRUE zum Festlegen des Schreibschutzes für die Ansicht.
RecurrenceRowset
Optionaler Boolean-Wert. TRUE, um Ereignisserien in der Ansicht zu erweitern und jede Instanz jeder Ereignisserie anzuzeigen. Der Standardwert ist FALSE.
RowLimit
Optionaler Integer-Wert. Gilt nur für den HTML-Ansichtstyp. Gibt die maximale Anzahl von Datensätzen an, die auf einer beliebigen Seite gerendert werden. Wenn die maximale Anzahl von Datensätzen überschritten wird, ermöglichen die Schaltflächen Next und Previous auf der Seite das Anzeigen anderer Teile des zurückgegebenen Recordsets.
Wenn RowLimit nicht angegeben ist, ist die Standardanzahl der zurückgegebenen Zeilen 50. Wenn für den Ansichtstyp "None" angegeben ist, werden alle Zeilen des Recordsets in einer Ansicht zurückgegeben.

Wenn eine Ansicht gerendert wird, werden die Rendervariablen ViewHasNext und ViewHasPrev auf TRUE oder FALSE festgelegt, je nachdem, ob die aktuelle Ansicht den Zeilengrenzwert aus dem Dataset erreicht hat. Diese Variablen können in nachfolgenden Seitendefinitionen zum Rendern der Schaltflächen Next und Previous auf der Seite verwendet werden, wie im folgenden Beispiel zu sehen:
<Switch> <Expr><GetVar Name="ViewHasPrev"/></Expr> <Case Value="TRUE"><![CDATA[...Previous button defined here... ]]> </Case></Switch>

Die Variablen NextPageURL und PrevPageURL werden auch auf nichtblank-Werte festgelegt, wenn vorwärts- oder rückwärts paging-Inhalt aus der aktuellen Anzeige vorhanden ist. Diese Variablen können verwendet werden, indem die Schaltflächen Next und Previous so konstruiert werden, dass sie die richtige URL für den Zugriff auf den Inhalt der nächsten Inhaltsseite besitzen.
Scope
Optionaler Text-Wert. Gibt den rekursiven Bereich für eine Ansicht einer Dokumentbibliothek an.

Mögliche Werte:
FilesOnly - Nur die Dateien eines bestimmten Ordners anzeigen.
Recursive - Alle Dateien aller Ordner anzeigen.
RecursiveAll - Alle Dateien und alle Unterordner aller Ordner anzeigen.

Falls dieses Attribut nicht festgelegt ist, werden in der Ansicht nur Dateien und Unterordner eines bestimmten Ordners angezeigt. Der Wert dieses Attributs entspricht der Scope-Eigenschaft der SPView-Klasse .
ShowHeaderUI
Optionaler Boolean-Wert. FALSE, um alle FieldRef-Elemente zu rendern, die im Kopfzeilenanzeigemodus verwendet werden, ohne dass die Benutzeroberfläche mit HTML ergänzt wird. Mit anderen Worten: Wenn dieser Modus festgelegt ist, wird auf der Benutzeroberfläche kein Sortieren und Filtern als Hyperlinks in der Spaltenüberschrift bereitgestellt. Der Standardwert ist TRUE.
Gewinde
Optionaler Boolean-Wert. TRUE, um eine innere Gruppierung in der Ansicht anzuwenden. Eine Ansicht mit Thread wird auf der Grundlage der integrierten Threadspalte (deren Vorhandensein für die Liste angenommen wird) konstruiert. Die Ansicht wird nach diesem Feld als sekundäre Sortierung sortiert. Falls Spalten in der Ansicht als sortiert oder gruppiert angegeben sind, werden diese vor der Sortierreihenfolge der Threadspalte angewendet. Daher können alle Diskussionen, die nach einem Thema gruppiert sind, zusammengefasst werden, und der Meldungsthread kann unter der Auflistung angezeigt werden.

Falls TRUE, besitzt das RowLimit-Element eine andere Bedeutung, wenn es in einer Listenansicht einer Diskussionsrunde mit Thread verwendet wird. Statt die Anzahl der zurückzugebenden Elemente anzugeben, wird die Anzahl der zurückzugebenden Diskussionsthreads angegeben, wobei ein Thread ein oder mehrere Elemente enthalten kann. Zusätzlich zum Festlegen des Threaded-Attributs auf TRUE muss eine Ansicht mit Thread nach Thread-ID sortiert sein, damit dieses Verhalten für die Einschränkung von Datensätzen verwendet werden kann.
Typ
Optionaler Text-Wert. Gibt den Renderingtyp der Ansicht an. Der Typ stellt die häufig verwendete aufgezählte HTML-Ansicht dar und kann auf HTML, Chart, Pivot, GANTT oder CALENDAR festgelegt sein.
Url
Optionaler URL-Wert. Gibt die URL der Ansicht an.
WebPartOrder
Optionaler Integer-Wert. Gibt die vertikale Positionierung des Webparts innerhalb einer Zone an.
WebPartZoneID
Optionaler Text. Gibt die Zone für das Webpart an.

Untergeordnete Elemente

Übergeordnete Elemente

Vorkommen

  • Minimum: 0
  • Maximum: Unbegrenzt

HinwBemerkungeneise

Ein Beispiel, das das View-Element verwendet, finden Sie unter Module-Element (Site).