View-Element (Website)
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 angepasst werden kann. |
Freihandform |
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 der Standardansicht und der Normalansicht. |
Path |
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. |
Eingefädelt |
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
Hinweise
Ein Beispiel, das das View-Element verwendet, finden Sie unter Module-Element (Site).