Elemente zur Definition von Daten
Letzte Änderung: Freitag, 26. März 2010
Gilt für: SharePoint Foundation 2010
CAML (Collaborative Application Markup Language) weist zwei Hauptelementtypen auf: einen Typ für das Rendern von Seiten und einen Typ für das Rendern von Feldern und die Schemadefinition. Die CAML-Elemente zum Rendern von Feldern dienen zum Rendern einzelner Feldwerte. Diese können in Feldtypdefinitionen oder, was häufiger der Fall ist, in der Datei FldTypes.xml im Ordner \\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATES\XML vorkommen.
Rendern von Feldern und Schemadefinition
Ein Feld ist eine Spalte oder ein Attribut mit Informationen, die ein Benutzer einer Liste hinzufügen kann. Jede Liste in einer Website, die auf Microsoft SharePoint Foundation basiert, weist in der Datenbank gespeicherte Metadaten auf. Das Format des Schemas ist eine XML-Struktur wie die folgende:
<Fields>
<Field Type="Counter" Name="ID"/>
...other field definitions...
</Fields>
Zum Vereinfachen der Implementierung der verschiedenen Feldtypen und zum Zulassen eines höheren Grads an Flexibilität beim Rendern der verschiedenen Felder enthält FldTypes.xml Informationen zum Rendern und Verhalten der einzelnen Feldtypen. Das Field-Element rendert je nach Datentyp des betreffenden Felds unterschiedliche HTML, und FldTypes.xml definiert die Datentypen und Rendermuster für jeden Feldtyp. In der folgenden Tabelle wird das in dieser Datei verwendete Schema beschrieben.
Name |
Datentyp |
Beschreibung |
|---|---|---|
Column2Suffix |
Text |
Enthält Text zum Anfügen an den Basisspaltennamen, um ColumnName2 von ColumnName abzuleiten (für zweispaltige Felder wie URL). |
DisplayPattern |
Note |
Enthält die HTML-Vorlage zum Rendern des Felds im Anzeigemodus einer Ansicht oder eines Formulars. |
EditPattern |
Note |
Enthält die HTML-Vorlage zum Generieren des Formularsteuerelements Bearbeiten zum Bearbeiten des Felds. |
HeaderPattern |
Note |
Enthält die HTML-Vorlage zum Anzeigen der Überschrift einer Tabellenansichtsspalte. |
InternalType |
Text |
Bestimmt das Verhalten des Column-Elements beim Rendern von Daten aus der SharePoint Foundation-Datenbank und des Postbacks der Daten in die Datenbank. Kann einen der folgenden Werte haben: Text, Note, Number, Currency, Integer, Boolean, DateTime, Threading, Lookup, Choice, URL, Counter oder DisplayOnly. Beachten Sie, dass es für den Feldtyp DisplayOnly keine eigene Speichermöglichkeit gibt. |
Name |
Text |
Enthält den Namen des internen Datentyps gemäß dem Verweis in einem Type-Attribut des Field-Elements: <Field Type="Name"/>. Beispiele sind Text, Note, Number usw. |
NewPattern |
Note |
Enthält die HTML-Vorlage zum Generieren des Formulars Neu zum Bearbeiten des Ausgangswerts eines Felds. |
PreviewDisplayPattern |
Note |
Gibt an, wie Felder gerendert werden, wenn ein Anzeigeformular in Microsoft SharePoint Designer bearbeitet wird. |
PreviewEditPattern |
Note |
Gibt an, wie Felder gerendert werden, wenn ein Bearbeitungsformular in Microsoft SharePoint Designer bearbeitet wird. |
PreviewNewPattern |
Note |
Gibt an, wie Felder gerendert werden, wenn ein neues Formular in Microsoft SharePoint Designer bearbeitet wird. |
Sortable |
Text |
Gibt an, ob ein Feld sortiert werden kann. Kann TRUE oder FALSE sein. |
TypeName |
Text |
Gibt einen Namen in der Definition eines Feldtyps an. |
SQLType |
Text |
Bestimmt den zugrunde liegenden SQL-Datentyp für ein bestimmtes Feld. Beispiele sind nvarchar(255), Memo, Integer und Float. Dient zum Generieren des entsprechenden SQL-Codes (CREATE TABLE) zum Erstellen eines Felds dieses Typs. |
SQLType2 |
Text |
Gibt, falls nicht leer, den Typ einer sekundären Spalte an, die für das aktuelle Feld erstellt werden soll (ein Beispiel finden Sie unter dem Feldtyp URL). |
Anzeigemodi und -muster
Alle Anzeigemodi (Display, Edit und New) enthalten eine Definition, wie die einzelnen Felddatentypen, die von SharePoint Foundation unterstützt werden, gerendert werden sollen.
Für jeden Anzeigemodus gibt es ein Anzeigemuster bzw. einen CAML-Renderausdruck. Einige CAML-Elemente werden spezifisch in Anzeigemustern verwendet. Andere können in beiden Kontexten, d. h. für das Rendern von Seiten oder von Feldern, verwendet werden. Sie werden aber hauptsächlich zum Rendern von Feldern genutzt. Die folgenden spezifischen CAML-Renderelemente dienen zum Erstellen von Vorlagen, die sowohl statische HTML als auch Daten sowie Metadaten des zu rendernden Felds enthalten können.
Element |
Beschreibung |
|---|---|
Gibt den Rohdatenwert eines bestimmten Felds zurück. |
|
Dient zum Rendern eines Feldtyps vom Typ Link. |
|
Dient als Escapezeichen für bestimmte Zeichen in Zeichenfolgen. |
|
Wird in HeaderPattern-Abschnitten von FldTypes.xml zum Anzeigen von Dropdownmenüs für Filter angezeigt. |
|
Gibt den Microsoft Office-Namespace "urn:schemas-microsoft-com:office:office#" zurück. |
|
Wird in berechneten Feldern zum Verweisen auf die einzelnen Felder und in Ansichten zum Bestimmen verwendet, welche Felder vorhanden sind. |
|
Gibt die URL der Bilddatei zurück, die zum Angeben der Sortierung einer Spalte verwendet wird. |
|
Gibt die Sortierrichtung für eine Liste, wobei Asc oder Desc basierend darauf, ob das Feld sortiert wurde, gerendert wird, und die aktuelle Standardsortierrichtung des Felds zurück. |
|
Lässt bedingtes Rendern basierend auf dem Vergleich zweier CAML-Ausdrücke zu. |
|
Gibt TRUE zurück, wenn das Element als neu eingestuft wird. |
|
Gibt den HTTP-Pfad zu den Bilderverzeichnissen des Projekts zurück. |
|
Schneidet Text auf eine angegebene Größe ab. |
|
Überträgt Gebietsschemainformationen des Servers an den Client, damit Datumsangaben und Zahlen ordnungsgemäß angezeigt und bearbeitet werden können. |
|
Wird an beliebiger Stelle verwendet, um die absolute, codierte URL der aktuellen Seite zurückzugeben. |
|
Gibt die Eigenschaft aus dem aktuellen ForEach-Kontext zurück. |
|
Dient zum Rendern von Text vom Server, der als Zeichenfolge in Anführungszeichen interpretiert werden muss. |
|
Rendert das aktuelle Datum samt Uhrzeit im ISO-Format. |