Column2-Element (View)

Letzte Änderung: Freitag, 30. Mai 2008

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen

Wird beim Rendern eines Hyperlinks verwendet. In Microsoft SharePoint Foundation werden Hyperlinks als zwei separate Werte gespeichert: der eigentliche URL-Wert als der eine, der beschreibende Text als der andere Wert. In einem Link-Feld gibt <Column/> den Wert der URL und <Column2/> den beschreibenden Text des Hyperlinks zurück.

<Column2
  AutoHyperLink = "TRUE" | "FALSE"
  AutoHyperLinkNoEncoding = "TRUE" | "FALSE"
  AutoNewLine = "TRUE" | "FALSE"
  Default = "Text"
  ExpandXML = "TRUE" | "FALSE"
  HTMLEncode = "TRUE" | "FALSE"
  Name = "Text"
  ShowField = "Text"
  StripWS = "TRUE" | "FALSE"
  URLEncode = "TRUE" | "FALSE"
  URLEncodeAsURL = "TRUE" | "FALSE">
</Column2>

Attribute

Attribut

Beschreibung

AutoHyperLink

Optionaler Boolean-Wert. TRUE, um Text in <A>-Tags zu setzen, wenn es sich um einen Link handeln könnte (z. B. www.microsoft.com).

AutoHyperLinkNoEncoding

Optionaler Boolean-Wert. TRUE, um Text in <A>-Tags zu setzen, wenn es sich um einen Link handeln könnte (z. B. www.microsoft.com), aber ohne HTML-Codierung.

AutoNewLine

Optionaler Boolean-Wert. TRUE, um <BR>-Tags in den Textstream einzufügen und mehrere Leerzeichen durch ein geschütztes Leerzeichen (&nbsp;) zu ersetzen.

Default

Optionaler Text-Wert. Rendert den diesem Attribut zugewiesenen Text, wenn von einer Auswahl eine leere Zeichenfolge ("") als Wert zurückgegeben wurde.

ExpandXML

Optionaler Boolean-Wert. TRUE, um den gerenderten Inhalt erneut den CAML-Interpreter (Collaborative Application Markup Language) durchlaufen zulassen, damit CAML als CAML rendern kann.

HTMLEncode

Optionaler Boolean-Wert. TRUE, um eingebettete Zeichen zu konvertieren, damit sie im Browser als Text dargestellt werden. In anderen Worten werden Zeichen, die mit HTML-Tags verwechselt werden könnten, in Entitäten konvertiert.

Name

Optionaler Text-Wert. Ermöglicht die Verwendung des Column-Elements außerhalb des Feldrenderingkontexts durch Angabe einer ID (z. B. <Column Name="ID"/>).

ShowField

Optionaler Text-Wert. Das ShowField-Attribut kann auf den Spaltennamen festgelegt werden, der angezeigt werden soll. Standardmäßig wird ein Texthyperlink aus der Title-Spalte des Datensatzes in der externen Liste angezeigt. Mit dem ShowField-Attribut kann dieses Verhalten jedoch außer Kraft gesetzt und ein anderes Feld aus der externen Liste angezeigt werden.

Die folgenden Datentypen sind als Ziel eines ShowField-Attributs zulässig: Text, Choice und Counter.

StripWS

Optionaler Boolean-Wert. TRUE, um Leerzeichen am Anfang und Ende des Werts zu entfernen, der vom Element zurückgegeben wird.

URLEncode

Optionaler Boolean-Wert. TRUE, um Sonderzeichen wie Leerzeichen in das UTF-8-Format mit Anführungszeichen zu konvertierten (z. B. "%c3%ab" für das Zeichen "ë").

URLEncodeAsURL

Optionaler Boolean-Wert. Wie URLEncode, aber TRUE, um anzugeben, dass es sich bei der zu codierenden Zeichenfolge um eine Pfadkomponente einer URL handelt, damit Schrägstriche ("/") nicht codiert werden.

Untergeordnete Elemente

Keines

Übergeordnete Elemente

Zahlreiche

Vorkommen

Mindestvorkommen: 0

Maximum: Unbegrenzt

Beispiel

Mit der folgenden Switch-Anweisung wird der Column2-Wert ausgewertet und, falls er leer ist, die HTML-Codierung des Column-Elementwerts (also der URL) auf TRUE festgelegt. Andernfalls wird die HTML-Codierung des beschreibenden URL-Texts auf TRUE festgelegt.

<Switch>
  <Expr>
    <Column2/>
  </Expr>
  <Case Value="">
    <Column HTMLEncode="TRUE"/>
  </Case>
  <Default>
    <Column2 HTMLEncode="TRUE"/>
  </Default>
</Switch>

Siehe auch

Referenz

Column-Element (Ansicht)