View Element (List)
Letzte Änderung: Donnerstag, 15. Juli 2010
Gilt für: SharePoint Foundation 2010
Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen
Definiert in einer Listendefinition (Schema.xml) eine Ansicht für eine Liste auf einer Website, die auf Microsoft SharePoint Foundation basiert, in der jede Liste eine Reihe von Ansichten enthalten kann.
.gif "Hinweis") Hinweis |
|---|
In SharePoint Foundation 2010 wird XSLT zum Definieren von Listenansichten verwendet, und das Ansichtsschema wird aus Gründen der Abwärtskompatibilität beibehalten. Weitere Informationen zu XSLT-Listenansichten finden Sie unter Listenansichten. |
<View
AggregateView = "TRUE" | "FALSE"
BaseViewID = "Integer"
ContentTypeID = "Text" CssStyleSheet = "Text"
DefaultView = "TRUE" | "FALSE"
DefaultViewForContentType = "TRUE" | "FALSE"
DisplayName = "Text"
FailIfEmpty = "TRUE" | "FALSE"
FileDialog = "TRUE" | "FALSE"
FPModified = "TRUE" | "FALSE"
FreeForm = "TRUE" | "FALSE"
Hidden = "TRUE" | "FALSE"
ImageUrl = "Text"
IncludeRootFolder = "TRUE" | "FALSE"
List = "Integer" | "Text"
MobileDefaultView = "TRUE" | "FALSE" MobileItemLimit = "Integer" MobileUrl = "Text"
MobileView = "TRUE" | "FALSE"
ModerationType = "Text"
Name = "Text"
OrderedView = "TRUE" | "FALSE"
PageType = "Text"
Path = "Text"
ReadOnly = "TRUE" | "FALSE"
RecurrenceRowset = "TRUE" | "FALSE"
ReqAuth = "TRUE" | "FALSE"
RequiresClientIntegration = "TRUE" | "FALSE"
RowLimit = "Integer"
Scope = "Text"
SetupPath = "Text"
ShowHeaderUI = "TRUE" | "FALSE" TabularView = "TRUE" | "FALSE"
TargetId = "Text"
TargetType = "List" | "ContentType"
Threaded = "TRUE" | "FALSE"
ToolbarTemplate = "Text"
Type = "HTML" | "Chart" | "Pivot"
Url = "Text"
WebPartOrder = "Integer"
WebPartZoneID = "Text">
</View>
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 verfügt eine XML-Formularbibliothek über eine Ansicht zum Zusammenführen von Formularen, 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. Diese Ansicht kann abhängig davon, ob die Listenvorlage oder Definition für die Bibliothek das Zusammenführen von Daten unterstützt, eingeblendet oder ausgeblendet werden. |
|
|
BaseViewID |
Optionaler Integer-Wert. Gibt die ID der Basisansicht an. |
|
|
ContentTypeID |
Optionaler Text-Wert. Gibt die ID des Inhaltstyps an, dem die Ansicht zugeordnet ist. |
|
|
CssStyleSheet |
Optionaler Text-Wert. |
|
|
DefaultView |
Optionaler Boolean-Wert. Mit TRUE wird angegeben, dass die Ansicht die Standardansicht ist. |
|
|
DefaultViewForContentType |
Optionaler Boolean-Wert. Mit TRUE wird angegeben, dass die Ansicht die Standardansicht für einen Inhaltstyp ist. |
|
|
DisplayName |
Optionaler Text-Wert. 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, damit die Clientanwendung ein Dokument nicht analysieren muss, um zu erkennen, ob die Ansicht leer ist. |
|
|
FileDialog |
Optionaler Boolean-Wert. Mit TRUE wird angegeben, dass die Ansicht in Dateidialogfeldern für Anwendungen angezeigt wird, die im Kontext von SharePoint Foundation verwendet werden und die den HTML-Ausgabecode analysieren, um den Inhalt der Liste zu ermitteln. |
|
|
FPModified |
Optionaler Boolean-Wert. TRUE, falls die Ansicht durch die Bearbeitung in einem Webseiten-Editor geändert wurde und nicht mehr mit der SharePoint Foundation-Benutzeroberfläche angepasst werden kann. |
|
|
FreeForm |
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. |
|
|
ImageUrl |
Optionaler Text-Wert. Gibt die serverrelative URL für das Bild an, das im Titelbereich der Listenansicht angezeigt werden soll, beispielsweise /_layouts/images/pgrpicon.png. |
|
|
IncludeRootFolder |
Optionaler Boolean-Wert. Mit TRUE wird angegeben, dass der Stammordner in der Listenansicht zurückgegeben wird. |
|
|
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). |
|
|
MobileDefaultView |
Optionaler Boolean-Wert. Mit TRUE wird angegeben, dass die standardmäßige SharePoint-Listenansicht die mobile Standardansicht ist. Nur eine Ansicht pro Liste kann als mobile Standardansicht festgelegt werden. |
|
|
MobileItemLimit |
Optionaler Integer-Wert. |
|
|
MobileUrl |
Optionaler Text-Wert. |
|
|
MobileView |
Optionaler Boolean-Wert. Mit TRUE wird angegeben, dass die standardmäßige SharePoint-Listenansicht auch eine mobile Ansicht ist. Dieses Attribut wird nicht auf Kalender- und Datenblattansichten oder Gantt-Ansichten angewendet. |
|
|
ModerationType |
Optionaler Text-Wert. Gibt den Inhaltsgenehmigungstyp an, der HideUnapproved, Contributor oder Moderator sein kann. In der HideUnapproved-Ansicht werden nicht genehmigte Entwurfselemente für Benutzer ausgeblendet, die nur über die Berechtigung zum Lesen von Elementen verfügen. In der Contributor-Ansicht werden die ausstehenden und abgelehnten Elemente für den aktuellen Benutzer angezeigt. Auf die Moderator-Ansicht können nur Benutzer zugreifen, die über die Berechtigung zum Verwalten von Listen verfügen. Angezeigt werden die ausstehenden und abgelehnten Elemente für alle Benutzer. |
|
|
Name |
Optionaler Text-Wert. Der Name der Ansicht; wird zum Auswählen einer anders benannten Ansicht auf der Benutzeroberfläche sowie zum Verweisen auf eine benannte Ansicht beim Angeben 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:
|
|
|
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. |
|
|
ReqAuth |
Optionaler Boolean-Wert. |
|
|
RequiresClientIntegration |
Optionaler Boolean-Wert. TRUE, um Features zu verwenden, mit denen Clientanwendungen gestartet werden; anderenfalls müssen die Benutzer lokal an Dokumenten arbeiten und Änderungen hochladen. |
|
|
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, können mithilfe der Schaltflächen Next und Previous auf der Seite andere Teile des zurückgegebenen Recordsets angezeigt werden. Falls RowLimit nicht angegeben ist, wird die Standardanzahl von Datensätzen mit 50 zurückgeben. Falls Keine als Ansichtstyp angegeben ist, werden alle Zeilen des Recordsets in einer Ansicht zurückgegeben. Wenn eine Ansicht gerendert wird, werden die Renderingvariablen ViewHasNext und ViewHasPrev auf TRUE oder FALSE festgelegt, abhängig davon, ob für die aktuelle Ansicht die maximale Anzahl von Datensätzen für das Dataset erreicht wurde. 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:
Die Variablen NextPageURL und PrevPageURL werden auch auf nicht leere Wert festgelegt, wenn von der aktuellen Anzeige aus Inhalte auf vorherigen oder nachfolgenden Seiten vorhanden sind. Diese Variablen können verwendet werden, indem die Schaltflächen Next und Previous so konstruiert werden, dass diese 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. Folgende Werte sind möglich:
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. |
|
|
SetupPath |
Optionaler Text-Wert. Gibt den websiterelativen Pfad des Ordners im Setupverzeichnis an, der die in der Websitedefinition verwendete ASPX-Datei enthält, beispielsweise pages\viewpage.aspx. |
|
|
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. |
|
|
TabularView |
Optionaler Boolean-Wert. |
|
|
TargetId |
Optionaler Text-Wert. |
|
|
TargetType |
Optionaler Text-Wert. Mögliche Werte sind List und ContentType. |
|
|
Threaded |
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 Regeln 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. |
|
|
ToolbarTemplate |
Optionaler Text-Wert. Gibt den Namen der vordefinierten Symbolleistenvorlage an, die für die Ansichtssymbolleiste verwendet wird. |
|
|
Type |
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 oder Pivot festgelegt sein. |
|
|
Url |
Optionaler Text-Wert. Gibt die URL der Ansicht an. |
|
|
WebPartOrder |
Optionaler Integer-Wert. Gibt die vertikale Position des Webparts innerhalb einer Zone an. |
|
|
WebPartZoneID |
Optionaler Text-Wert. Gibt die Zone für das Webpart an. |
|
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen
Minimum: 0 Maximum: Unbegrenzt |
Hinweise
Der wichtigste Ansichtstyp für Listen- und Dokumentzusammenfassungsinformationen ist die HTML-Ansicht. Eine HTML-Ansicht ist im Allgemeinen eine Spaltenansicht, in der Informationen aus einer oder mehreren Listen angezeigt werden. Die anzuzeigenden Daten werden von den in der Ansicht angezeigten Feldern beschrieben. Weitere Informationen zur Funktionsweise von Ansichten in Microsoft SharePoint Foundation 2010 finden Sie unter Listenansichten.
Eine HTML-Ansicht wird primär durch folgende Attribute definiert:
Den Namen.
Die Datenquellenangabe (normalerweise eine einzelne Liste oder Dokumentbibliothek).
Den Filter, der auf die Datenquelle angewendet werden soll.
Die Auflistung der Felder, die angezeigt werden sollen.
Die Sortierreihenfolge der Elemente, die angezeigt werden sollen. Ein Sonderfall der Sortierreihenfolge ist die Gruppierung.
Eine HTML-Vorlage zum Rendern der Ansicht.
Das View-Element ist von zentraler Bedeutung für das Rendern von Seiten und generiert eine SQL-Abfrage für die Felder, Sortierungen und Filter, die in einer bestimmten Ansicht angewendet werden. Mit dem View-Element wird der von der Abfrage zurückgegebene Datensatz durchlaufen und für jede einzelne zurückgegebene Zeile das ViewBody-Element ausgeführt. Innerhalb des ViewBody-Elements kann eine Fields-Elementenumeration für die Behandlung der einzelnen Felder verwendet werden. Alternativ kann auf jedes Feld innerhalb eines Field- Elements einzeln anhand des Namens verwiesen werden.
Jede Ansicht hat einen internen Namen, der in der Regel durch eine GUID dargestellt wird. Die Ansicht kann mithilfe des <View/>-Tags auf einer Seite gerendert werden.
Beispiel
Im folgenden Beispiel wird die Verwendung einer Feldenumeration in einem Ansichtskörper veranschaulicht und eine einfache Tabelle für die Anzeige einer Liste im Browser gezeigt.
<View Name="MyCustomView">
<ViewHeader>
<HTML><![CDATA[<TABLE><TR>]]></HTML>
<Fields>
<HTML><![CDATA[<TH>]]></HTML>
<Field/>
<HTML><![CDATA[</TH>]]></HTML>
</Fields>
<HTML><![CDATA[</TR>]]></HTML>
</ViewHeader>
<ViewBody>
<HTML><![CDATA[<TR>]]></HTML>
<Fields>
<HTML><![CDATA[<TD>]]></HTML>
<Field/>
<HTML><![CDATA[</TD>]]></HTML>
</Fields>
<HTML><![CDATA[</TR>]]></HTML>
</ViewBody>
<ViewFooter>
<HTML><![CDATA[</TABLE>]]></HTML>
</ViewFooter>
Beachten Sie, dass im vorherigen Abschnitt die Feldenumeration innerhalb eines ViewHeader-Abschnitts verwendet wird, um Spaltenüberschriften für die Ansicht zu erstellen.
Im folgenden Abschnitt des Beispiels ist ein ViewFields-Abschnitt im View-Element enthalten, um anzugeben, welche Felder in der Ansicht aufgezählt werden.
<ViewFields>
<FieldRef Name="Created_x0020_By"/>
<FieldRef Name="Last_x0020_Modified"/>
</ViewFields>
| Hinweis |
|---|
Wenn die Ansicht ein Joins-Element enthält, können Felder aus den verknüpften Listen in ViewFields enthalten sein, vorausgesetzt die Felder sind auch in einem ProjectedFields-Element aufgelistet. |
Im letzten Abschnitt des Beispiels wird das Query-Element verwendet, um einen Ergebnissatz anzugeben, der wie im folgenden Beispiel bestimmte Kriterien erfüllt und eine Liste aller Dokumente zurückgibt, die von Mary oder John verfasst wurden.
<Query>
<Where>
<Or>
<Eq>
<FieldRef Name="Created_x0020_By"/>
<Value Type="Text">
Mary
</Value>
</Eq>
<Eq>
<FieldRef Name="Created_x0020_By"/>
<Value Type="Text">
John
</Value>
</Eq>
</Or>
</Where>
<OrderBy>
<FieldRef Name="Last_x0020_Modified"/>
</OrderBy>
</Query>
</View>
Im nächsten Ansichtsbeispiel wird eine Sequenz von Absätzen gezeigt. Mit dem Query-Element wird nicht nur eine Sortierreihenfolge (nach dem Änderungsdatum) angegeben, sondern auch ein Filter (nur Elemente anzeigen, deren Expires-Eigenschaft größer oder gleich dem heutigen Datum ist).
<View Type="HTML" Name="Summary">
<ViewBody ExpandXML="TRUE">
<![CDATA[ <p><SPAN class=DocTitle><ows:Field Name="Title"/></SPAN>
(<ows:Field Name="Author"/>, <ows:Field Name="Modified"/>)
<ows:Limit><Field Name="Body"/></ows:Limit>
</p> ]]>
</ViewBody>
<Query>
<Where>
<Geq>
<FieldRef Name="Expires"/>
<Value Type="DateTime">
<Today/>
</Value>
</Geq>
</Where>
<OrderBy>
<FieldRef Name="Modified"/>
</OrderBy>
</Query>
<ViewFields>
<FieldRef Name="Summary"/>
<FieldRef Name="Author"/>
<FieldRef Name="Modified"/>
<FieldRef Name="Body"/>
</ViewFields>
</View>