BaseFieldControl.DisplayTemplateName-Eigenschaft

Ruft ab oder legt den Namen der Vorlage, die zum Rendern des BaseFieldControl -Objekts im Anzeigemodus steuern verwendet werden kann. d. h., wenn es nicht in einem Formular neu oder bearbeiten ist.

Namespace:  Microsoft.SharePoint.WebControls
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaration
Public Overridable Property DisplayTemplateName As String
    Get
    Set
'Usage
Dim instance As BaseFieldControl
Dim value As String

value = instance.DisplayTemplateName

instance.DisplayTemplateName = value

public virtual string DisplayTemplateName { get; set; }

Eigenschaftswert

Typ: System.String
Eine String , die eine Renderingvorlage benennt.

Hinweise

Mit der Standardimplementierung ist der Standardwert der DisplayTemplateNameein Nullverweis (Nothing in Visual Basic). Wenn sie auf einen Null-Wert festgelegt ist und DisplayTemplate nicht explizit festgelegt wurde, gibt DisplayTemplate die ITemplate mit dem Namen von DisplayTemplateNamezurück. Aber wenn DisplayTemplatewurde festgelegt, wird der standardmäßigen get -Accessor den Wert der DisplayTemplateNameignoriert.

Hinweise für Vererber

Mit ihren Standardimplementierungen ist es möglich, für DisplayTemplate auf eine andere Vorlage als die festgelegt werden, die durch DisplayTemplateNameheißt. Daher mit die Implementierungen, sollten bei Ihrem Code DisplayTemplate, legt es auch DisplayTemplateName auf den Namen des der gleichen ITemplatefestlegen. Auf ähnliche Weise, wenn Ihr Code DisplayTemplateNamefestlegt, sollten auch DisplayTemplate auf der gleichen ITemplatefestgelegt. Wenn logische Konsistenz auf diese Weise nicht erzwungen, und die beiden Eigenschaften haben inkonsistente Werte am Renderingzeit, DisplayTemplate bestimmt die Vorlage, die zum Rendern des Felds verwendet wird.

Wenn Sie eine Vorlage für das Rendern im Anzeigemodus verwenden möchten, haben Sie die Überschreibung von der get -Accessor der ControlTemplateDisplayTemplate zurück, wenn der im Steuerelementmodus Anzeige ist. Alternativ kann der Außerkraftsetzung der CreateChildControlsTemplateName auf DisplayTemplateName festgelegt, wenn der im Steuerelementmodus Anzeige ist.

Siehe auch

Referenz

BaseFieldControl Klasse

BaseFieldControl-Member

Microsoft.SharePoint.WebControls-Namespace

Weitere Ressourcen

Patterns of Custom Field Rendering

Custom Field Types

Walkthrough: Creating a Custom Field Type