View-Element (Website)

Letzte Änderung: Sonntag, 11. April 2010

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen

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>

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-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, wobei verhindert wird, dass die Clientanwendung ein Dokument 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 Microsoft SharePoint Foundation verwendet werden und die den HTML-Ausgabecode analysieren, um den Inhalt der Liste zu bestimmen.

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.

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 (z. B. beim Vorhandensein von zwei Ankündigungslisten auf der Website, und Sie geben List=104 an).

Name

Optionaler Text-Wert. 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 Dateidialogfelds.

  • DISPLAYFORM   Anzeigeformular für Listenelemente.

  • DISPLAYFORMDIALOG   Anzeigeformular für ein Dateidialogfeld.

  • EDITFORM   Bearbeitungsformular für Listenelemente.

  • EDITFORMDIALOG   Bearbeitungsformular für ein Dateidialogfeld.

  • INVALID   Wird nicht verwendet.

  • MAXITEMS   Wird nicht verwendet.

  • NEWFORM   Neues Formular für Listenelemente.

  • NEWFORMDIALOG   Neues Formular für ein Dateidialogfeld.

  • NORMALVIEW   Normalansicht.

  • SOLUTIONFORM   Lösungsformular.

  • VIEW   Ansicht, einschließlich Standardansicht und 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.

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:

        <Switch>
  <Expr><GetVar Name=”ViewHasPrev”/></Expr>
  <Case Value=”TRUE”>
    <![CDATA[...Previous button defined here... ]]>
  </Case>
</Switch>
      

Die Variablen NextPageURL und PrevPageURL werden auch auf nicht leere Wert festgelegt, wenn von der aktuellen Anzeige aus Inhalt auf vorherigen oder nachfolgenden Seiten vorhanden sind. 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. Es folgenden 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 in der Benutzeroberfläche kein Sortieren und Filtern als Hyperlinks in der Spaltenüberschrift bereitgestellt. Der Standardwert ist TRUE.

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

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, Pivot, GANTT oder CALENDAR festgelegt sein.

Url

Optionaler URL-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 den Webpart an.

Untergeordnete Elemente

Element

BinarySerializedWebPart

Übergeordnete Elemente

File

Vorkommen

Minimum: 0

Maximum: Unbegrenzt

Hinweise

Ein Beispiel für die Verwendung des View-Elements finden Sie unter Module-Element (Site).