FieldRef-Element (Abfrage)

Artikel
09/24/2014

Letzte Änderung: Dienstag, 22. Juni 2010

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen

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"
  Name = "Text"
  RefType = "Text"
  ShowField = "Text"
  TextOnly = "TRUE" | "FALSE"
  Type = "Text">
</FieldRef>

Attribute

Attribut	Beschreibung
Alias	Optionaler Text-Wert.
Ascending	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-Wert.
ID	Optionaler Text-Wert. Gibt die GUID an, die das Feld identifiziert.
Key	Optionaler Text-Wert. 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-Wert. 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.
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-Wert. Das ShowField-Attribut kann auf den Namen des anzuzeigenden Felds festgelegt werden. Standardmäßig wird ein HyperlinkText aus dem Title-Feld des Datensatzes in der externen Liste angezeigt. Mit dem ShowField-Attribut kann dieses Verhalten überschrieben 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.
Type	Optionaler Text-Wert. Gibt die Funktion an, die auf eine Summenspalte oder eine berechnete Spalte angewendet wird. Mögliche Werte: AVG Mittelwert. Gilt für die Feldtypen DateTime, Number, Integer und Currency. COUNT Anzahl von Werten. Gilt für alle Feldtypen, für die Aggregation zulässig ist. MAX Maximalwert. Gilt für die Feldtypen DateTimeNumber, Integer und Currency. MIN Minimalwert. Gilt für die Feldtypen DateTimeNumber, Integer und Currency. SUM Summe von Werten. 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

BeginsWith, Contains, DateRangesOverlap, Eq, FieldRefs, Geq, GroupBy, Gt, In, Includes, IsNotNull, IsNull, Leq, Lt, Neq, NotIncludes, OrderBy

Vorkommen

Mindestvorkommen: 0

Maximum: 1 (Innerhalb von OrderBy unbegrenzt)

Beispiel

Im folgenden Beispiel wird auf Fälle abgefragt, in denen das Expires-Feld entweder null ist oder einen Wert größer als oder gleich dem aktuellen Datum hat.

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

Im folgenden Beispiel aus der Datei Schema.xml für Kontaktlisten werden Felder für die Anzeige auf der Symbolleiste angegeben.

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

Freigeben über