TemplateBasedControl.CustomTemplate-Eigenschaft

Artikel
2015-05-06

Dient zum Abrufen oder festlegen eine benutzerdefinierte Vorlage.

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

Syntax

'Declaration
<PersistenceModeAttribute(PersistenceMode.InnerProperty)> _
<TemplateContainerAttribute(GetType(TemplateBasedControl))> _
Public Property CustomTemplate As ITemplate
    Get
    Set
'Usage
Dim instance As TemplateBasedControl
Dim value As ITemplate

value = instance.CustomTemplate

instance.CustomTemplate = value

[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
[TemplateContainerAttribute(typeof(TemplateBasedControl))]
public ITemplate CustomTemplate { get; set; }

Eigenschaftswert

Typ: System.Web.UI.ITemplate
Ein ITemplate -Objekt, das das Steuerelement gerendert wird.

Hinweise

Die Eigenschaften CustomTemplate und CustomAlternateTemplate sind mit dem [PersistenceMode(PersistenceMode.InnerProperty)] -Attribut markiert. Dies bedeutet, dass die ITemplate -Objekte, die sie zurückgeben, werden kompiliert und im TemplateBasedControl -Objekt als geschachtelter Tag beibehalten. Es gibt mehrere Vorteile der Verwendung von vorkompilierter Vorlagen. Beispielsweise können sie zu einer Seite in einem visuellen Designer wie Microsoft SharePoint Designer oder Visual Studio hinzugefügt werden durch Ziehen und Ablegen aus der Toolbox in Designer. Aber es auch Nachteile gibt. Weitere Informationen finden Sie unter Patterns of Custom Field Rendering, Web User Controls and Web Custom Controlsund PersistenceModeAttribute.