FieldRef-Element (Abfrage)

Artikel
04/08/2023

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

Stellt einen Verweis auf ein Feld in einer Abfrage dar.

<FieldRef
  Alias = "Text"
  Ascending = "TRUE" | "FALSE"
  CreateURL = "Text"
  DisplayName = "Text"
  Explicit = "TRUE" | "FALSE"    Format = "Text"
  ID = "Text"
  Key = "Text"  List = "Text"
  LookupId = "TRUE" | "FALSE"
  Name = "Text"
  RefType = "Text"
  ShowField = "Text"
  TextOnly = "TRUE" | "FALSE"
  Type = "Text">
</FieldRef>

Elemente und Attribute

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

Attribute

Attribut	Beschreibung
Alias	Optionaler Text.
Aufsteigend	Optionaler Boolean-Wert. Dies gibt die Sortierreihenfolge für ein in einer Ansicht definiertes FieldRef-Element an. Der Standardwert ist TRUE.
CreateURL	Optionaler Text-Wert. Gibt die URL für die ASPX-Datei zum Erstellen einer Besprechungsarbeitsbereich-Website an.
DisplayName	Optionaler Text-Wert. Dieses Attribut enthält den Anzeigenamen des Felds, auf das verwiesen wird.
Explicit	Optionaler Boolean-Wert. Dieses Attribut wird nur innerhalb des ViewFields-Elements unterstützt. TRUE, wenn das Feld in der Ansichtsdefinition explizit deklariert ist und nicht in einer Fields-Enumeration innerhalb einer Ansicht zurückgegeben wird.
Format	Optionaler Text.
ID	Optionaler Text-Wert. Gibt die GUID an, die das Feld identifiziert.
Schlüssel	Optionaler Text. Wenn das Attribut auf Primary festgelegt wird, bedeutet dies, dass das Feld der Primärschlüssel für die Tabelle ist und somit eindeutig jeden Datensatz in der Tabelle identifiziert.
List	Optionaler Text. Gibt die übergeordnete Fremdliste an, wenn das FieldRef-Element ein untergeordnetes Element eines Eq-Elements im Join-Element ist. Der Wert ist ein Alias für die Liste, der durch das ListAlias-Attribut des Join-Elements definiert ist.
Lookupid	Optionaler Boolean-Wert. Wenn das Feld ein Lookup-Typ ist, gibt an, dass Abfragen nach dem Element anhand seiner eindeutigen Element-ID und nicht anhand des Feldwerts suchen sollen. Dies kann z. B. nützlich sein, wenn mehrere Elemente identische Werte im Feld aufweisen und Sie ein bestimmtes Element abfragen möchten. Der Standardwert ist „false“.
Name	Optionaler Text-Wert. Dieses Attribut enthält den internen Namen des Felds, auf das verwiesen wird.
Reftype	Optionaler Text-Wert. Gibt den Typ des Verweises für ein Feld in einer Ereignisliste an.
ShowField	Optionaler Text. Das ShowField-Attribut kann auf den anzuzeigenden Feldnamen festgelegt werden. Standardmäßig wird ein per Link verknüpfter Text aus dem Titelfeld des Datensatzes in der externen Liste angezeigt. Mit dem ShowField-Attribut kann dieses Standardverhalten jedoch außer Kraft gesetzt und ein anderes Feld aus der externen Liste angezeigt werden. Die folgenden Datentypen sind als Ziele eines ShowField-Attributs zulässig: Text, Choice und Counter.
TextOnly	Optionaler Boolean-Wert. Gibt an, dass das Feld nur Textwerte enthält.
Typ	Optionaler Text-Wert. Gibt die Funktion an, die auf eine Summenspalte oder eine berechnete Spalte angewendet wird. Mögliche Werte: AVG Durchschnittswert. Gilt für die Feldtypen DateTimeNumber, Integer und Currency. COUNT Anzahl der Elemente. Gilt für alle Feldtypen, für die Aggregation zulässig ist. MAX Maximalwert. Gilt für die Feldtypen DateTimeNumber, Integer und Currency. MIN Minimaler Wert. Gilt für die Feldtypen DateTimeNumber, Integer und Currency. SUMME Summe der Werte. Gilt für die Feldtypen Number, Integer und Currency. STDEV Standardabweichung. Gilt für die Feldtypen Number, Integer und Currency. VAR Varianz. Gilt für die Feldtypen Number, Integer und Currency. Bei den Werten für das Type-Attribut wird die Groß-/Kleinschreibung nicht beachtet.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Vorkommen

Minimum: 0
Maximum: 1 (innerhalb von OrderBy ungebunden)

Beispiele

Im folgenden Beispiel wird nach Fällen abfragt, in denen das Feld Expires entweder NULL ist oder einen Wert enthält, der größer oder gleich dem aktuellen Datum ist.

<Query>
   <Where>
      <Or>
         <IsNull>
            <FieldRef Name="Expires" />
         </IsNull>
         <Geq>
            <FieldRef Name="Expires" />
            <Value Type="DateTime">
               <Today />
            </Value>
         </Geq>
      </Or>
   </Where>
   <OrderBy>
      <FieldRef Name="Modified" Ascending="FALSE" />
   </OrderBy>
</Query>

Dieses Beispiel aus der Schema.xml-Datei für Die Felder für Kontaktlisten, die auf der Symbolleiste angezeigt werden sollen.

<ViewFields>
   <FieldRef Name="LinkTitleNoMenu"></FieldRef>
   <FieldRef Name="FirstName"></FieldRef>
   <FieldRef Name="WorkPhone"></FieldRef>
   <FieldRef Name="Email"></FieldRef>
</ViewFields>

Freigeben über