Column-Element (Ansicht)
Letzte Änderung: Samstag, 3. April 2010
Gilt für: SharePoint Foundation 2010
Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen
Gibt den Rohdatenwert für ein bestimmtes Feld zurück – im Gegensatz zur vom Field-Element bereitgestellten formatierten Version. Im Falle eines Lookup-Felds gibt Column den lokalen Wert (eine ID-Nummer in der Liste, die auf eine andere Liste verweist) zurück, während das LookupColumn-Element die Daten aus der Fremdtabelle zurückgibt.
<Column
AutoHyperLink = "TRUE" | "FALSE"
AutoHyperLinkNoEncoding = "TRUE" | "FALSE"
AutoNewLine = "TRUE" | "FALSE"
Default = "Text"
Format="DateTime"
HTMLEncode = "TRUE" | "FALSE"
Name = "Text"
ShowField = "Text"
StripWS = "TRUE" | "FALSE"
SubColumnNumber = Integer
URLEncode = "TRUE" | "FALSE"
URLEncodeAsURL = "TRUE" | "FALSE">
</Column>
Attribute
Attribut |
Beschreibung |
|---|---|
AutoHyperLink |
Optionaler Boolean-Wert. Ist TRUE, falls Text mit <A>-Tags umschlossen werden soll, wenn es sich bei dem Text anscheinend um einen Hyperlink handelt (z. B. www.microsoft.com). |
AutoHyperLinkNoEncoding |
Optionaler Boolean-Wert. Ist TRUE, falls Text mit <A>-Tags umschlossen werden soll, wenn es sich bei dem Text anscheinend um einen Hyperlink handelt (z. B. www.microsoft.com), jedoch ohne HTML-Codierung. |
AutoNewLine |
Optionaler Boolean-Wert. Ergibt TRUE, um <BR>-Tags in den Textstream einzufügen und mehrere Leerzeichen durch ein geschütztes Leerzeichen ( ) zu ersetzen. |
Default |
Optionaler Text-Wert. Rendert den diesem Attribut zugeordneten Text, wenn der von einer Auswahl zurückgegebene Wert eine leere Zeichenfolge ist (""). |
Format |
Optionaler Text-Wert. Steuert die Datumsformate für Datumsfelder. Zu den unterstützten Formaten gehören DateTime, DateOnly, TimeOnly, ISO8601, ISO8601Basic und ISO8601Gregorian. |
HTMLEncode |
Optionaler Boolean-Wert. Ist TRUE, wenn eingebettete Zeichen konvertiert werden, sodass sie als Text im Browser angezeigt werden. Mit anderen Worten werden Zeichen, die mit HTML-Tags verwendet werden können, in Entitäten konvertiert. |
Name |
Optionaler Text-Wert. Ermöglicht, dass das Column-Element außerhalb des Feldrenderingkontexts verwendet wird, indem eine ID bereitgestellt wird (z. B. <Column Name="ID"/>). |
ShowField |
Optionaler Text-Wert. Das ShowField-Attribut kann auf den anzuzeigenden Spaltennamen festgelegt werden. Standardmäßig wird ein HyperlinkText aus der Title-Spalte des Datensatzes in der externen Liste angezeigt. Mit dem ShowField-Attribut kann dieser jedoch ü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. |
StripWS |
Optionaler Boolean-Wert. Ist TRUE, um Leerzeichen vom Anfang und Ende des vom Element zurückgegebenen Werts zu entfernen. |
SubColumnNumber |
Optionaler Integer-Wert. |
URLEncode |
Optionaler Boolean-Wert. Ist TRUE, um Sonderzeichen wie Leerzeichen in das UTF-8-Format zu konvertieren. (Ein Beispiel: %c3%ab für das Zeichen ë.) |
URLEncodeAsURL |
Optionaler Boolean-Wert. Ähnlich wie URLEncode, mit TRUE wird jedoch angegeben, dass es sich bei der zu codierenden Zeichenfolge um eine Pfadkomponente einer URL handelt, sodass die Schrägstriche ("/") nicht codiert werden. |
Untergeordnete Elemente
Keine |
Übergeordnete Elemente
Zahlreiche |
Vorkommen
Mindestvorkommen: 0 Maximum: Unbegrenzt (1 innerhalb von Limit) |
Hinweise
Beachten Sie, dass bei einem leeren Column-Element (<Column/>) die aktuelle Einstellung der DisplayMode-Variablen eine Rolle spielt. Der Anzeigemodus wird implizit entsprechend dem aktuell verwendeten Befehl festgelegt. Wenn eine Ansicht oder ein Element angezeigt wird, wird DisplayMode auf Display festgelegt. Wenn ein Element aus einem Formular erstellt wird, wird DisplayMode auf New festgelegt. Wenn ein vorhandenes Element bearbeitet wird, wird DisplayMode auf Edit festgelegt. Die DisplayMode-Variable kann durch direktes Festlegen auf der Seite überschrieben werden, z. B. durch <SetVar Name="DisplayMode">Edit</SetVar>.
Beim Rendern eines Datumsfelds oder eines Zahlenfelds mithilfe von <Column/> werden die Daten im Gebietsschema des Servers gerendert, da numerische Daten von <Column/> nach den gebietsschemaspezifischen Regeln des Servers gerendert werden.