PropertySchema-Element (Feldtypen)

Artikel
04/08/2023

Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

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

<PropertySchema>
</PropertySchema>

Wichtig

In diesem Thema wird Markup beschrieben, das in einer veralteten Methode zum Rendern benutzerdefinierter Feldtypeigenschaften verwendet wurde. Es wird nur bereitgestellt, um das Debuggen von benutzerdefinierten Feldtypeigenschaften zu unterstützen, die für frühere Versionen von SharePoint Foundation entwickelt wurden. Informationen zur empfohlenen Methode finden Sie unter Custom Field Type Property Rendering.

Elemente und Attribute

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

Attribute

Keine

Untergeordnete Elemente

Fields-Element (Field Types Property Schema)

Übergeordnete Elemente

FieldType-Element (Field Types)

Hinweise

Benutzerdefinierte Feldtypen können spezielle Eigenschaften aufweisen, deren Wert je nach Feldtyp von einer Spalte zu einer anderen Spalte variiert, die auf demselben Feldtyp basiert. Stellen Sie sich einen benutzerdefinierten Feldtyp für reguläre Ausdrücke vor, der Zeichenfolgenwerte enthalten soll, die einem bestimmten regulären Ausdruck entsprechen, z ^(\d{3})\d{3}-\d{4}$ . B. für amerikanische Telefonnummern.

Anstatt separate feldtypen für reguläre Ausdrücke für britische Nummernnummern, Amerikanische Sozialversicherungsnummern, chinesische Telefonnummern usw. zu erstellen, ist es effizienter, einen einzelnen Feldtyp für reguläre Ausdrücke zu erstellen und Benutzern, die Spalten basierend auf dem Feldtyp erstellen, das Festlegen des regulären Ausdrucks zu ermöglichen, der spaltenweise abgeglichen werden muss. 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 "Brasilianisches PostBox" erstellt, würde den regulären Ausdruck seiner 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 dies im Abschnitt Zusätzliche Spalteneinstellungen auf der Seite Neue Websitespalte und auf der Seite Spalte erstellen . Das PropertySchema-Element in der fldtypes*.xml Datei ist der Ort, an dem solche Variableneigenschaften deklariert werden und ein Standardrenderingschema erhalten. Optional können ihnen auch Standardwerte zugewiesen werden.

Hinweis

Wenn Sie die Variableneigenschaften des benutzerdefinierten Feldtyps im PropertySchema-Element definieren, rendert SharePoint Foundation diese Eigenschaften automatisch basierend auf dem Schema.

Beispiel

Im folgenden Beispiel wird ein Eigenschaftenschema für einen benutzerdefinierten Feldtyp namens RegularExpressionMatch definiert. Das Schema deklariert ein Feld, das von Spaltenerstellern verwendet werden kann, wenn sie eine Spalte auf dem Feldtyp basieren. Der Zweck des Felds besteht darin, es einem Spaltenersteller zu ermöglichen, einen anderen regulären Ausdruck für jede Spalte festzulegen, die auf dem Feldtyp RegularExpressionMatch basiert.

Das Feld DisplayName und ein bearbeitbares Textfeld werden im Abschnitt Zusätzliche Spalteneinstellungen auf der Seite Neue Websitespalte und auf der Seite Spalte erstellen angezeigt. Das MaxLength-Attribut legt die maximale Länge des regulären Ausdrucks in Zeichen fest, und displaySize legt die Größe des Felds fest, in dem er enthalten ist. 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 diesem Beispiel wurde kein Standardwert festgelegt, aber wenn der Entwickler des Feldtyps wusste, dass er in den meisten Fällen zum Erstellen von Spalten mit amerikanischen Telefonnummern verwendet würde, könnte der Entwickler den Standardwert auf <Default>^(\d{3})\d{3}-\d{4}$</Default>festlegen.

Das folgende Codebeispiel wurde aus Gründen der Übersichtlichkeit bearbeitet.

<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>

Freigeben über