Field-Element (Feldtypen)

Artikel
09/24/2014

Letzte Änderung: Freitag, 9. April 2010

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente

Repräsentiert ein Merkmal des Feldtyps.

<Field
  Name="Text">
</Field>

Attribute

Attribut	Beschreibung
Name	Erforderlicher Text-Wert. Eine Zeichenfolge, die den Namen des angegebenen Aspekts des Feldtyps repräsentiert, den das Field-Element darstellt. Der Wert muss einer der Zeichenfolge entsprechen, die in der Tabelle weiter unten aufgeführt sind.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

FieldType-Element (Feldtypen)

Hinweise

Untergeordnete Field-Elemente des FieldType-Elements werden in fldtypes*.xml-Dateien in %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\XML konfiguriert.

Jedes FieldType-Element verfügt über mehrere erforderliche und optionale Field-Elemente, die anhand ihres Name-Attributs unterschieden werden. In der folgenden Tabelle werden diese Elemente beschrieben. Im -Objektmodell wird ein Feldtyp durch die SPFieldTypeDefinition-Klasse repräsentiert. Diese Klasse verfügt über eine schreibgeschützte Eigenschaft, die bis auf zwei Ausnahmen allen Zeilen der Tabelle entspricht. (Die Ausnahmen sind InternalType und SQLType.) Sofern nichts anderes angegeben ist, sind die Eigenschaftennamen mit dem Wert des entsprechenden Name-Attributs identisch.

Wert des Name-Attributs des Field-Elements	Beschreibung
AllowBaseTypeRendering	Optionaler Boolean-Wert. Der Standardwert ist FALSE. Gibt an, ob eine Clientanwendung das Feld als Basistyp (auch ParentType genannt) rendert, wenn die Clientanwendung nicht feststellen kann, wie der benutzerdefinierte Feldtyp ordnungsgemäß gerendert wird. Wenn das Attribut auf TRUE festgelegt ist und die Clientanwendung den benutzerdefinierten Feldtyp nicht ordnungsgemäß rendern kann, rendert die Clientanwendung das Feld wie den standardmäßigen übergeordneten SharePoint Foundation-Feldtyp, von dem das Feld erbt.
CAMLRendering	Optionaler Boolean-Wert. Der Standardwert ist FALSE. Gibt an, ob das Feld in Listenansichten gerendert wird und hierbei CAML-Markup in einem RenderPattern-Element innerhalb des übergeordneten FieldType-Elements verwendet wird. Der Standardwert FALSE bedeutet, dass das Feld durch eine XSL-Transformation in einer *fldtypes.xsl-Datei in Listenansichten gerendert wird; hierbei handelt es sich um das Standardsystem zum Rendern von Feldern in Listenansichten. (Dieses Element hat jedoch keinen Einfluss auf das Rendern von Feldern in Formularen des Typs Anzeigen, Neu und Bearbeiten**. RenderPattern ist weiterhin das Standardverfahren zum Rendern des Felds auf einem Anzeigeformular.)
FieldTypeClass	Optionaler String-Wert, aber erforderlich für alle benutzerdefinierten Feldtypen. Stellt den starken Namen der Feldtyp-Klassenbibliothek dar. "FieldTypeClass" schließt den Klassennamen und den Assemblynamen mit Version, Culture und PublicKeyToken ein, beispielsweise <Field Name="FieldTypeClass">CustomFieldTypes.RegularExpression.RegularExpressionField, CustomFieldTypes.RegularExpression, Version=1.0.0.0, Culture=neutral, PublicKeyToken=57e55365ec0ce80a</Field> (Nur der vollständig qualifizierte Klassenname wird für Feldtypen eingeschlossen, die in SharePoint Foundation integriert sind.)
FieldEditorUserControl		Optionaler String-Wert. Repräsentiert den relativen Pfad zur Datei FeldtypFieldEditor.ascx, die ein Steuerelement definiert, das in SharePoint Foundation im Abschnitt Zusätzliche Spalteneinstellungen der Seite Neue Websitespalteangezeigt wird. Das Steuerelement ermöglicht es beim Erstellen von Spalten, für eine bestimmte Spalte die variablen Eigenschaften des Feldtyps festzulegen, beispielsweise "/_controltemplates/RegularExpressionFieldEditor.ascx". Falls es kein <Field Name="FieldEditorUserControl">-Element gibt, werden die besonderen Eigenschaften des Feldtyps durch das PropertySchema-Element (Feldtypen)-Element gerendert. FieldEditorUserControl muss eine feste, nicht lokalisierbare Zeichenfolge sein.
Filterable		Erforderlicher Boolean-Wert. Gibt an, ob eine Liste mit einer auf diesem Feldtyp basierenden Spalte anhand des Werts der Spalte gefiltert werden kann, die diesen Typ verwendet. Bei TRUE ist die Spaltenüberschrift ein Steuerelement, das die Benutzer zum Filtern der Liste verwenden können.
InternalType	Optionaler String-Wert. Repräsentiert einen internen Basistyp. Verwenden Sie kein <Field Name="InternalType">-Element in Ihren benutzerdefinierten Feldtypdefinitionen.
ParentType	Erforderlicher String-Wert (kann jedoch eine leere Zeichenfolge sein). Stellt den Namen des Typs dar, von dem die Feldklasse abgeleitet wurde. Die möglichen Werte entsprechen exakt den möglichen Werte für das Attribut Type des Field-Element (Liste)-Elements. Wenn der Feldtyp nicht von einem anderen Typ abgeleitet wurde, ist der Wert eine leere Zeichenfolge: <Field Name="ParentType"></Field>. Für benutzerdefinierte Feldtypen darf dieser Wert nie leer sein. Alle benutzerdefinierten Feldtypen erben von einem anderen Typ. Im SharePoint Foundation-Objektmodell hat ParentType die Bezeichnung BaseRenderingTypeName.
ShowOnListAuthoringPages	Optionaler Boolean-Wert. Der Standardwert ist TRUE. Gibt an, ob dieser Feldtyp angezeigt wird, um in Listen eingebunden zu werden. Bei TRUE zeigt SharePoint Foundation diesen Feldtyp auf Listenerstellungsseiten an, sodass Benutzer den Feldtyp in ihre Listen einbinden können Im SharePoint Foundation-Objektmodell hat ShowOnListAuthoringPages die Bezeichnung ShowOnListCreate.
ShowOnDocumentLibraryAuthoringPages	Optionaler Boolean-Wert. Der Standardwert ist TRUE. Gibt an, ob dieser Feldtyp angezeigt wird, um in Dokumentbibliotheken eingebunden zu werden. Bei TRUE zeigt SharePoint Foundation diesen Feldtyp auf Dokumentbibliothek-Erstellungsseiten an, sodass Benutzer den Feldtyp in ihre Dokumentbibliotheken einbinden können Im SharePoint Foundation-Objektmodell hat ShowOnDocumentLibraryAuthoringPages die Bezeichnung ShowOnDocumentLibraryCreate.
ShowOnSurveyAuthoringPages	Optionaler Boolean-Wert. Der Standardwert ist TRUE. Gibt an, ob dieser Feldtyp angezeigt wird, um in Umfragen eingebunden zu werden. Bei TRUE zeigt SharePoint Foundation diesen Feldtyp auf Umfrageerstellungsseiten an, sodass Benutzer den Feldtyp in ihre Umfragen einbinden können Im SharePoint Foundation-Objektmodell hat ShowOnSurveyAuthoringPages die Bezeichnung ShowOnSurveyCreate.
ShowOnColumnTemplateAuthoringPages	Optionaler Boolean-Wert. Der Standardwert ist TRUE. Gibt an, ob dieser Feldtyp als Spaltenvorlagen-Feldtyp angezeigt werden soll. Bei TRUE zeigt SharePoint Foundation diesen Feldtyp auf Spaltenvorlagen-Erstellungsseiten an, sodass Benutzer die Möglichkeit haben, eine Spaltenvorlage dieses Feldtyps zu erstellen. Im SharePoint Foundation-Objektmodell hat ShowOnColumnTemplateAuthoringPages die Bezeichnung ShowOnColumnTemplateCreate.
SQLType	Optionaler String-Wert. Gibt den SQL-Datentyp an, der zum Speichern der Daten in der Inhaltsdatenbank verwendet wird. Verwenden Sie kein <Field Name="SQLType">-Element in Ihren benutzerdefinierten Feldtypdefinitionen.
Sortable	Erforderlicher Boolean-Wert. Gibt an, ob eine Liste mit einer auf diesem Feldtyp basierenden Spalte anhand der Spalte sortiert werden kann, die diesen Typ verwendet. Bei TRUE ist die Spaltenüberschrift ein Steuerelement, das die Benutzer zum Sortieren der Liste verwenden können.
TypeDisplayName	Erforderlicher String-Wert. Stellt den Anzeigenamen des Feldtyps auf der Benutzeroberfläche dar. In SharePoint Foundation wird der Wert in der Spalte Typ der [Listen-]Seite Anpassen (listedit.aspx) angezeigt. Er wird auch anstelle von "TypeShortDescription" verwendet, wenn dieses Element nicht vorhanden ist. "TypeDisplayName" sollte eine lokalisierbare Zeichenfolge sein.
TypeName	Erforderlicher String-Wert. Stellt den Namen des Feldtyps dar. Es muss sich um einen eindeutigen Namen innerhalb aller Feldtypnamen in der SharePoint-Serverfarm handeln. "TypeName" muss eine feste, nicht lokalisierbare Zeichenfolge sein.
TypeShortDescription	Optionaler String-Wert. Stellt die Kurzbeschreibung des Feldtyps dar, der auf der Benutzeroberfläche angezeigt wird. In SharePoint Foundation wird der Wert mit einem Optionsfeld im Abschnitt Name und Typ der Seiten Neue Websitespalte und Spalte erstellen und in der Spalte Typ des Websitespaltenkatalogsangezeigt. Falls kein <Field Name="TypeShortDescription">-Element vorhanden ist, wird "TypeDisplayName" verwendet. "TypeShortDescription" sollte eine lokalisierbare Zeichenfolge sein.
UserCreatable	Optionaler Boolean-Wert. Der Standardwert ist TRUE, wodurch es Benutzern ermöglicht wird, Felder dieses Feldtyps zu Listen hinzuzufügen. Wird dieser Wert auf FALSE festgelegt, kann dieser Feldtyp in Listenschemas verwendet werden; der Feldtyp wird den Benutzern jedoch nicht im Abschnitt Name und Typ der Seiten Neue Websitespalte und Spalte erstellen angezeigt.

Beispiel

Das folgende Beispiel definiert einen benutzerdefinierten Feldtyp.

Wichtig
Das RenderPattern-Element ist veraltet. Es wird hier lediglich aufgeführt, um das Debuggen benutzerdefinierter Felder zu unterstützen, die ursprünglich für frühere Version von SharePoint Foundation entwickelt wurden.

  <FieldType>
    <Field Name="TypeName">SocialSecurityNumber</Field>
    <Field Name="ParentType">Text</Field>
    <Field Name="TypeDisplayName">Social Security Number</Field>
    <Field Name="TypeShortDescription">Social Security Number (123456789, 123-45-6789)</Field>
    <Field Name="AllowBaseTypeRendering">TRUE</Field>
    <Field Name="FieldTypeClass">
      AdventureWorks.FieldTypes.SPFieldSSN, AdventureWorks.FieldTypes.SPFieldSSN,
      Version=1.0.0.0,Culture=neutral,PublicKeyToken=90734cc53324b79c
    </Field>
    <RenderPattern Name="DisplayPattern">
        <Column HTMLEncode="TRUE" /> 
        <Column HTMLEncode="TRUE" UseRelatedField="TRUE"/> 
    </RenderPattern>
  </FieldType>