PropertySchema-Element (Feldtypen)

Letzte Änderung: Freitag, 9. April 2010

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente

Wichtig

In diesem Thema wird Markup beschrieben, das in einer veralteten Methode zum Rendern benutzerdefinierter Feldtypeigenschaften verwendet wurde. Die Beschreibung dient ausschließlich zur Unterstützung beim Debuggen benutzerdefinierter Feldtypeigenschaften, die in früheren Versionen von SharePoint Foundation entwickelt wurden. Weitere Informationen zur empfohlenen Methode finden Sie unter Rendern der Eigenschaften von benutzerdefinierten Feldtypen.

Stellt das Schema spezieller, variabler Eigenschaften eines benutzerdefinierten Feldtyps dar, wobei jede Eigenschaft als ein Field-Element definiert ist.

<PropertySchema>
</PropertySchema>

Attribute

Attribut	Beschreibung
Keine

Untergeordnete Elemente

Fields-Element (Feldtypeigenschaften-Schema)

Übergeordnete Elemente

FieldType-Element (Feldtypen)

Hinweise

Benutzerdefinierte Feldtypen verfügen möglicherweise über spezielle Eigenschaften, deren Wert zwischen verschiedenen, auf demselben Feldtyp basierenden Spalten variiert. Betrachten Sie einen benutzerdefinierten Feldtyp für reguläre Ausdrücke, der String-Werte enthalten soll, die einem bestimmten regulären Ausdruck entsprechen, z. B. ^(\d{3})\d{3}-\d{4}$ für amerikanische Telefonnummern. Statt separate benutzerdefinierte Feldtypen für reguläre Ausdrücke für britische Autokennzeichen, amerikanische Sozialversicherungsnummern, chinesische Telefonnummern usw. zu erstellen, ist es effizienter, einen einzelnen Feldtyp für reguläre Ausdrücke zu erstellen und Benutzern beim Erstellen von Spalten dieses Feldtyps zu ermöglichen, den mit jeder Spalte zu vergleichenden regulären Ausdruck festzulegen. Beispielsweise würde ein Benutzer, der eine Spalte "US-Telefonnummer" erstellt, den regulären Ausdruck der Spalte auf die obige Zeichenfolge festlegen. Ein anderer Benutzer, der eine Spalte "Brasilianische Postleitzahl" erstellt, würde den regulären Ausdruck der Spalte auf ^\d{5}\-\d{3}$ festlegen.

Zu diesem Zweck muss das benutzerdefinierte Feld über eine RegularExpression-Eigenschaft verfügen, die beim Erstellen einer neuen Spalte in einem bearbeitbaren Steuerelement auf der Benutzeroberfläche gerendert wird. In SharePoint Foundation befindet sich dieses im Abschnitt Zusätzliche Spalteneinstellungen der Seite Neue Websitespalte und der Seite Spalte erstellen. Im PropertySchema-Element in der Datei fldtypes*.xml werden solche variablen Eigenschaften deklariert und erhalten ein Standardrenderingschema zugewiesen. Optional können ihnen auch Standardwerte zugewiesen werden.

Hinweis
Wenn Sie die variablen Eigenschaften des benutzerdefinierten Feldtyps im PropertySchema-Element definieren, werden die betreffenden Eigenschaften von SharePoint Foundation automatisch auf der Grundlage des Schemas gerendert.

Beispiel

Im folgenden Beispiel wird ein Eigenschaftsschema für einen benutzerdefinierten Feldtyp mit dem Namen "RegularExpressionMatch" definiert. In dem Schema wird ein Feld deklariert, das Spaltenersteller verwenden können, wenn sie eine Spalte basierend auf dem Feldtyp erstellen. Das Feld soll einem Spaltenersteller ermöglichen, unterschiedliche reguläre Ausdrücke für die einzelnen Spalten festzulegen, die er auf dem RegularExpressionMatch-Feldtyp basiert.

Der DisplayName-Wert und ein bearbeitbares Text-Feld werden im Abschnitt Zusätzliche Spalteneinstellungen der Seite Neue Websitespalte und der Seite Spalte erstellen angezeigt. Im MaxLength-Attribut wird die maximale Länge des regulären Ausdrucks in Zeichen und in DisplaySize die Größe des ihn enthaltenden Felds festgelegt. Benutzer können den Fensterinhalt in dem Feld verschieben, um den Rest des regulären Ausdrucks anzuzeigen, wenn er länger als DisplaySize ist.

In dem Beispiel wird kein Standardwert festgelegt, aber wenn der Entwickler des Feldtyps wüsste, dass der Feldtyp vorwiegend für Spalten mit amerikanischen Telefonnummern verwendet wird, könnte er <Default>^(\d{3})\d{3}-\d{4}$</Default> als Standardwert festlegen.

Hinweis: Das folgende Codebeispiel wurde zur Veranschaulichung vereinfacht.

<FieldType>
  <Field Name="TypeName">RegularExpressionMatch</Field>
  …
  <PropertySchema>
    <Fields>
      <Field Name="RegularExpression" 
             DisplayName="Regular Expression To Match" 
             MaxLength="500" 
             DisplaySize="100" 
             Type="Text">
        <Default></Default>
      </Field>
    </Fields>
  </PropertySchema>
  …
</FieldType>

Siehe auch

Konzepte

Benutzerdefinierte Feldtypen

Gewusst wie: Erstellen einer benutzerdefinierten Feldklasse

Rendern der Eigenschaften von benutzerdefinierten Feldtypen

Vorgehensweise: Erstellen einer benutzerdefinierten Feldtypdefinition