Freigeben über

FieldRef-Element (ContentType)

  • Artikel

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

Gibt eine Spalte an, auf die in diesem Inhaltstyp verwiesen werden soll.

Definition

<FieldRef
  Aggregation="sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  Customization="Text"
  DefaultValue="Text"
  Description="Text"
  DisplayName="Text"
  Format="Text"
  Filterable="TRUE" | "FALSE"
  FilterableNoRecurrence="TRUE" | "FALSE"
  FromBaseType="TRUE" | "FALSE"
  Hidden="TRUE" | "FALSE" | "orResource"
  ID="Text"
  Locked="TRUE" | "FALSE"
  Name="Text"
  Node="Text"
  NumLines="Integer"
  PIAttribute="Text"
  PITarget="Text"
  PrimaryPIAttribute="Text"
  PrimaryPITarge="Text"
  ReadOnly="TRUE" | "FALSE"
  ReadOnlyClient="TRUE" | "FALSE"
  Required="TRUE" | "FALSE"
  Sealed="TRUE" | "FALSE"
  ShowInDisplayForm="TRUE" | "FALSE"
  ShowInEditForm="TRUE" | "FALSE"
  ShowInFileDlg="TRUE" | "FALSE"
  ShowInListSettings="TRUE" | "FALSE"
  ShowInNewForm="TRUE" | "FALSE"
  Sortable="TRUE" | "FALSE">
</FieldRef>

Elemente und Attribute

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

Attribute

Attribut Beschreibung
Aggregation

Wenn Sie das Node-Attribut zum Angeben eines XPath-Ausdrucks verwenden, der eine Auslistung von Werten zurückgibt, können Sie auch ein Aggregation-Attribut einschließen, mit dem die Aktion angegeben wird, die für die zurückgegebene Gruppe von Werten ausgeführt werden soll.

Bei dieser Aktion kann es sich entweder um eine Aggregatfunktion oder um eine Indikation des bestimmten Elements innerhalb der Auflistung handeln.

Mögliche Werte:

  • Summe

  • count

  • Durchschnitt

  • Min

  • Max

  • verschmelzen

  • Klartext Konvertiert Knotentextinhalt in Nur-Text.

  • first Wendet die Heraufstufung und Herabstufung der Eigenschaft auf das erste Element in der Auflistung an.

  • last Wendet die Heraufstufung und Herabstufung der Eigenschaft auf das letzte Element in der Auflistung an.

Weitere Informationen zur Verwendung der Attribute Node, PIAttribute, PITarget, PrimaryPIAttribute und PrimaryPITarget für die Heraufstufung und Herabstufung von Eigenschaften in XML-Dokumenten finden Sie unter Verwenden von Inhaltstypen zum Angeben von XML-Dokumenteigenschaften.
Anpassung

Optionaler Text. Eine Zeichenfolge in Collaborative Application Markup Language (CAML), die benutzerdefinierte Feldeigenschaften definiert.
DefaultValue

Veraltet.
Beschreibung

Optionaler Text-Wert. Stellt die Beschreibung bereit, die im Bearbeitungsformular für eine Liste angezeigt wird, wenn eine Spaltenbeschreibung angegeben wird. Standardmäßig enthalten Spalten in SharePoint Foundation keine Beschreibungen.
DisplayName

Erforderliches Text-Element. Der angezeigte Name der Spalte. Die maximale Länge beträgt 255 Zeichen.

Der Wert dieses Attributs wird als Spaltenüberschrift verwendet, wenn das Feld in einer Tabellenansicht angezeigt wird, und als Formularbeschriftung, wenn das Feld auf einem Formular angezeigt wird. Verwenden Sie das DisplayName-Attribut, um den Anzeigenamen in einen Wert zu ändern, der sich von dem im Feld selbst definierten Namen unterscheidet.
Format

Optionaler Text-Wert. Gibt die Formatierung an, die für numerische Werte verwendet werden soll.

Für Datums-/Uhrzeitspalten sind folgende Werte möglich:

  • DateOnly Zeigt nur den Datumsteil an (und lässt Bearbeitungen zu) (der Zeitteil ist für alle bearbeiteten Werte auf 12:00 Uhr festgelegt).

  • DateTime Zeigt Datum und Uhrzeit an und bearbeitet sie (Standardeinstellung).

  • ISO8601 Datum und Uhrzeit in ISO8601 in UTC konvertierten Zeitformat anzeigen: JJJJ-MM-TTTHH:MM:SSZ.

    Dies ist das Format, das für Dokumenteigenschaften im Microsoft Office System sowie für das standard-Austauschformat verwendet wird, das in Microsoft SharePoint Foundation zwischen neuen und Bearbeiten-Formularen und dem Server verwendet wird.

  • ISO8601Basic Verwenden Sie die abgekürzte Form von Datums-/Uhrzeitformaten 8601: JJJJMMDDTHHMMSSZ.

    Dieses Format wird für vCard/iCal verwendet.

Für Auswahlfelder kann dieses Attribut auf Dropdown (Standard) festgelegt werden, das Bearbeitungsoptionen über eine Dropdownauswahl bereitstellt, oder auf RadioButtons, das Optionen über eine Gruppe von Optionsfeldern bereitstellt.

Für URL-Felder kann dieses Attribut auf Hyperlink (Standard) festgelegt werden, wodurch die URL als normales <A> Tag angezeigt wird, oder auf Image, das die URL als <IMG SRC="URL" ALT="Description">anzeigt.
Filterbar

Optionaler Boolean-Wert. TRUE zum Definieren von Spalten als filterbar.
FilterableNoRecurrence

Optionaler Boolean-Wert. TRUE zum Definieren von Spalten als filterbar ohne wiederkehrende Werte.
FromBaseType

Optionaler Boolean-Wert. Dieses Attribut kann zugunsten des Sealed-Attributs als veraltet ausgesondert werden.
Hidden

Optionaler Boolean-Wert. Mit TRUE ist das Feld in der Benutzeroberfläche vollständig ausgeblendet. Wenn ReadOnly auf TRUE festgelegt wird, wird das Feld nicht in Neuen Formularen oder Formularen bearbeiten angezeigt, kann aber weiterhin in Ansichten eingeschlossen werden.

Wenn Sie dieses Attribut nicht einschließen, behandelt SharePoint Foundation die Spalte so, als wäre das Attribut auf FALSE festgelegt.
ID

Erforderlicher Text. Gibt die Feld-ID der Spalte an, auf die dieses FieldRef-Element verweist. Die Feld-ID ist die Zeichenfolgendarstellung einer GUID einschließlich der geschweiften Klammern. Bei dem Wert wird Groß- und Kleinschreibung unterschieden.

Die IDs für integrierte Felder finden Sie in der Datei fieldswss.xml im folgenden Pfad:
%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\FEATURES\fields
Locked Veraltet.
Name

Erforderliches Text-Element. Der Name einer Spalte. Dies ist der interne Name einer Spalte, der während der gesamten Lebensdauer der Felddefinition garantiert nicht geändert wird. Er muss für die Felder in einer Liste eindeutig sein.
Knoten

Optionaler Text-Wert. Gibt den XML-Knoten im Dokument an, der den Spaltenwert enthält. Wird für die Eigenschaftenherauf- und -herabstufung in XML-Dokumenten verwendet.

Weitere Informationen zur Verwendung der Attribute Node, PIAttribute, PITarget, Primary PIAttribute und PrimaryPITarget für die Eigenschaftenherauf- und -herabstufung in XML-Dokumenten finden Sie unter Using Content Types to Specify XML Document Properties.
NumLines

Optionaler Integer-Wert. Empfiehlt, wie viele Linien (Zeilen) während der Bearbeitung in einem TEXTAREA-Block angezeigt werden sollen. Dies ist lediglich ein Hinweis für die Clientbenutzeroberfläche; die Zahl der Textzeilen, die bearbeitet werden kann, ist nicht begrenzt.
PIAttribute Optionaler Text. Gibt das Attribut in der Dokumentverarbeitungsanweisung an (mithilfe des PITarget-Attributs), das als Spaltenwert verwendet werden soll. Dieses Attribut wird für die Eigenschaftenheraufstufung und -herunterstufung in XML-Dokumenten verwendet.

Wenn Sie das PIAttribute-Attribut angeben, müssen Sie auch das PITarget-Attribut angeben.

Weitere Informationen zum Verwenden der Attribute Node, PIAttribute, PITarget, Primary PIAttribute und PrimaryPITarget für das Herauf- und Herabstufen von Eigenschaften in XML-Dokumenten finden Sie unter Using Content Types to Specify XML Document Properties.
PITarget

Optionaler Text-Wert. Gibt die Dokumentverarbeitungsanweisung an, in der der Spaltenwert in Dokumenten dieses Inhaltstyps gespeichert wird. Dieses Attribut wird für die Eigenschaftenheraufstufung und -herunterstufung in XML-Dokumenten verwendet.

Wenn Sie das PIAttribute-Attribut angeben, müssen Sie auch das PITarget-Attribut angeben.

Weitere Informationen zum Verwenden der Attribute Node, PIAttribute, PITarget, Primary PIAttribute und PrimaryPITarget für das Herauf- und Herabstufen von Eigenschaften in XML-Dokumenten finden Sie unter Using Content Types to Specify XML Document Properties.
PrimaryPIAttribute

Optionaler Text. Gibt ein alternatives Attribut in der Dokumentverarbeitungsanweisung an (mithilfe des PrimaryPITarget-Attributs), das als Spaltenwert verwendet werden soll.

Wenn Sie das PrimaryPIAttribute-Attribut angeben, müssen Sie auch das PrimaryPITarget-Attribut angeben. Falls angegeben, verwendet SharePoint Foundation diese Werte vor denen, die in den Attributen PITarget und PIAttribute angegeben sind.

Dieses Attribut wird für die Eigenschaftenheraufstufung und -herunterstufung in XML-Dokumenten verwendet.

Weitere Informationen zur Verwendung der Attribute Node, PIAttribute, PITarget, Primary PIAttribute und PrimaryPITarget für die Eigenschaftenherauf- und -herabstufung in XML-Dokumenten finden Sie unter Using Content Types to Specify XML Document Properties.
PrimaryPITarget

Optionaler Text-Wert. Gibt eine alternative Dokumentverarbeitungsanweisung an, in der der Spaltenwert für Dokumente dieses Inhaltstyps gespeichert wird.

Wenn Sie das PrimaryPIAttribute-Attribut angeben, müssen Sie auch das PrimaryPITarget-Attribut angeben. Falls angegeben, verwendet SharePoint Foundation diese Werte vor denen, die in den Attributen PITarget und PIAttribute angegeben sind.

Weitere Informationen zum Verwenden der Attribute Node, PIAttribute, PITarget, Primary PIAttribute und PrimaryPITarget für das Herauf- und Herabstufen von Eigenschaften in XML-Dokumenten finden Sie unter Using Content Types to Specify XML Document Properties.
ReadOnly

Optionaler Boolean-Wert. True gibt an, dass das Feld nicht in den Formularen "Neu" oder "Bearbeiten" angezeigt wird, aber in Ansichten eingeschlossen werden kann. Wenn Sie das Hidden-Attribute auf TRUE festlegen, wird das Feld auf der Benutzeroberfläche vollständig ausgeblendet.

Wenn Sie dieses Attribut nicht einschließen, behandelt SharePoint Foundation die Spalte so, als wäre das Attribut auf FALSE festgelegt.
Erforderlich

Erforderlicher Boolean-Wert. Wenn TRUE, muss dem Feld erst ein Wert zugewiesen werden, bevor ein mit diesem Inhaltstyp erstelltes Element gespeichert werden kann.

Wenn in einem Formularbeitrag ein leerer Feldwert angegeben wird, wird im Fehlerformular entweder der Standardtext des Pflichtfelds oder eine explizit angegebene Meldung (d. h. über <ErrorText-Tags> ) angezeigt. Diese Validierung wird nur vom Client verarbeitet (die Datenbank lässt NULL für alle benutzerdefinierten Felder grundsätzlich zu).
Versiegelt

Optionaler Boolean-Wert. TRUE zum Definieren von Spalten als versiegelt. Sie können versiegelte Spalten nicht über die SharePoint Foundation-Benutzeroberfläche oder das Objektmodell bearbeiten. Wenn Sie dieses Attribut nicht einschließen, behandelt SharePoint Foundation die Spalte so, als wäre das Attribut auf FALSE festgelegt.
ShowInDisplayForm

Optionaler Boolean-Wert. TRUE, um die Spalte für Elemente dieses Inhaltstyps auf dem Anzeigeformular anzuzeigen.
ShowInEditForm

Optionaler Boolean-Wert. TRUE, um das Feld auf der Seite zum Bearbeiten eines Eintrags anzuzeigen.
ShowinFileDlg

Optionaler Boolean-Wert. TRUE , um die Spalte im Dateidialogfeld für Elemente dieses Inhaltstyps anzuzeigen.
ShowInListSettings

Optionaler Boolean-Wert. Wenn FALSE, erscheint das Feld im Anzeigemodus New nicht in einer Fields-Enumeration. Felder mit dieser Einstellung sind auf der Standardseite für neue Einträge für eine Liste nicht sichtbar.
ShowInNewForm

Optionaler Boolean-Wert. TRUE , um die Spalte im Neuen Formular für Elemente dieses Inhaltstyps anzuzeigen.
Sortierbar

Optionaler Boolean-Wert. Ergibt TRUE, wenn die Werte im Feld sortiert werden können.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Vorkommen

  • Minimum: 0
  • Maximum: Unbegrenzt

Hinweise

Das FieldRef-Element ist ein Verweis auf eine anderswo auf Website- oder Listenebene definierte Spalte. Im Feldverweis können Sie eine Teilmenge der Spalteneigenschaften überschreiben, wie z. B. die folgenden Eigenschaften:

  • Anzeigename
  • XML-Heraufstufungs- und XML-Herabstufungsattribute
  • Ob das Feld schreibgeschützt, erforderlich oder ausgeblendet ist

Wenn Sie diese Eigenschaften im Feldverweis ändern, werden sie nur für den entsprechenden Inhaltstyp geändert, der den Feldverweis enthält.

Wichtig

Die Attribute ID, Name, DisplayName und Required sind immer erforderlich, selbst wenn das FieldRef-Element auf ein Feld verweist, das im selben Elementmanifest definiert ist.

Beispiel

Im folgenden Beispiel sind zwei FieldRef-Elemente zu sehen, die Spalten zur Einbindung in einen Inhaltstyp angeben.

<FieldRefs>
  <!--  Built-in Title field -->
  <FieldRef ID="{fa564e0f-0c70-4ab9-b863-0177e6ddd247}" Name="Title" DisplayName="Item" Required="TRUE" Sealed="TRUE"/>
  <!--  Custom CostCenter field -->
  <FieldRef ID="{943E7530-5E2B-4C02-8259-CCD93A9ECB18}" Name="CostCenter" DisplayName="Department" Required="TRUE"/>
</FieldRefs>

Siehe auch