FieldRef-Element (Abfrage)

  • Artikel

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>