View-Element (List)

Artikel
04/08/2023

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

In einer Listendefinition (Schema.xml) definiert eine Ansicht für eine Liste in einer Website, die auf Microsoft SharePoint Foundation basiert, wobei jede Liste eine Reihe von Ansichten enthalten kann.

Hinweis

SharePoint Foundation 2010 verwendet XSLT zum Definieren von Listenansichten, und das Ansichtsschema wird aus Gründen der Abwärtskompatibilität beibehalten. Weitere Informationen zu XSLT-Listenansichten finden Sie unter List Views.

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

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 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.
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. 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. True , um anzugeben, dass die Ansicht in Dateidialogfeldern für Anwendungen angezeigt wird, die im Kontext von SharePoint Foundation verwendet werden, und 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.
ImageUrl	Optionaler Text. Gibt die serverrelative URL für das Bild an, das im Titelbereich der Listenansicht angezeigt wird, z. B `/_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.
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. Gibt den Inhaltsgenehmigungstyp an, der HideUnapproved, Contributor oder Moderator sein kann. Die Ansicht HideUnapproved blendet nicht genehmigte Entwurfselemente vor Benutzern aus, die nur über die Berechtigung zum Lesen von Elementen verfügen. In der Ansicht Mitwirkender werden die ausstehenden und abgelehnten Elemente für den aktuellen Benutzer angezeigt. Die Moderatoransicht ist nur für Benutzer zugänglich, die über verwaltete Listenberechtigungen verfügen, und zeigt die ausstehenden und abgelehnten Elemente für alle Benutzer an.
Name	Optionaler Text. 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: 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.
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. Wenn RowLimit nicht angegeben ist, ist die Standardanzahl der zurückgegebenen Zeilen 50. Wenn None für den Ansichtstyp 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: `XML<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 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. 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 .
SetupPath	Optionaler Text. Gibt den websiterelativen Pfad zum Ordner im Setupverzeichnis an, der die ASPX-Seite für die Ansicht enthält, `pages\viewpage.aspx`z. B. .
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.
TargetType	Optionaler Text. Mögliche Werte sind List und ContentType.
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 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.
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 oder Pivot festgelegt sein.
Url	Optionaler Text-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

Ansichten

Vorkommen

Minimum: 0
Maximum: Unbegrenzt

HinwBemerkungeneise

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. 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 für das Rendern von Seiten von zentraler Bedeutung und generiert eine SQL-Abfrage für die Felder, Sortierungen und Filter, die in einer bestimmten Ansicht angewendet werden. Das View-Element durchläuft das von der Abfrage zurückgegebene Dataset und führt das ViewBody-Element für jede zurückgegebene Zeile aus. Innerhalb des ViewBody-Elements kann eine Fields-Elementenumeration verwendet werden, um jedes Feld zu behandeln, oder auf jedes Feld kann einzeln anhand des Namens innerhalb eines Field-Elements verwiesen werden.

Jede Ansicht hat einen internen Namen, der in der Regel durch eine GUID dargestellt wird. Die Ansicht kann mit dem <Tag Ansicht/> auf einer Seite gerendert werden.

Beispiele

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. Das Query-Element gibt nicht nur eine Sortierreihenfolge (in der Reihenfolge des Änderungsdatums) an, sondern auch einen 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>

Siehe auch

Listenansichten