WebPart.SaveProperties-Eigenschaft
Dient zum Abrufen oder Festlegen eines Werts, das angibt, ob die Eigenschaften eines Webparts geändert haben und am Ende des Renderings von Seiten beibehalten werden soll.
Namespace: Microsoft.SharePoint.WebPartPages
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
Protected Friend Property SaveProperties As Boolean
Get
Set
'Usage
Dim value As Boolean
value = Me.SaveProperties
Me.SaveProperties = value
protected internal bool SaveProperties { get; set; }
Eigenschaftswert
Typ: System.Boolean
true Wenn die Webparteigenschaften beibehalten werden soll; andernfalls false.
Hinweise
Die SaveProperties -Eigenschaft ist ursprünglich auf false am Anfang des Renderings von Seiten festgelegt. Diese Eigenschaft ist nur während der Seitenwiedergabe hilfreich. Beispielsweise hat diese Eigenschaft keine Auswirkungen, wenn ein Webpart über das Objektmodell zugegriffen wird.
Die SaveProperties -Eigenschaft kann für Webparts verwendet werden, wenn deren Eigenschaften ändern, nach der in einer Webpart-Seite gerendert wird. Nach eine Eigenschaft geändert wird, kann eine WebPart -Klasse die SaveProperties -Eigenschaft festlegen, um true , um anzugeben, dass die geänderten Eigenschaften gespeichert werden. Der Wert der SaveProperties -Eigenschaft wird von der Webpartinfrastruktur nach des System.Web.UI.Control.UnLoad -Ereignisses des Webparts gelesen, wo alle-Eigenschaft Werte abgefragt und in der SharePoint-Datenbank gespeichert werden. Wenn diese Eigenschaft nicht festgelegt ist, zurücksetzen die Eigenschaften auf ihre ursprünglichen Werte das nächste Mal das Webpart instanziiert wird.
Der Wert der SaveProperties -Eigenschaft wird ignoriert, es sei denn, ein Webpart aktiv gerendert wird. Beispielsweise hat Instanziieren eines neuen Webparts, ändern einen Eigenschaftswert und Einstellung SaveProperties für true keine Auswirkung. Von einem Webpart, das eine Eigenschaft zu speichern, die nach der zu rendernden geändert wurde, sollte die SaveProperties -Eigenschaft verwendet werden. Wenn eine Eigenschaft extern festgelegt ist, ist es die Verantwortung des externen Agents entweder speichern Sie das Webpart explizit oder während eines Renderingzyklus die SaveProperties -Eigenschaft im Namen des Webparts festgelegt.
Wenn die SaveProperties -Eigenschaft festgelegt ist, auf eine statische-Webpart (eines Webparts, die sich nicht in einer Zone befindet) oder für ein Webpart, in dem der Benutzer nicht über ausreichende Berechtigungen zum Speichern von Änderungen (z. B. einen anonymen Benutzer) verfügt, wird eine Ausnahme ausgelöst, wenn versucht wird, das Webpart zu speichern. Ein Webpart sollte die Permissions -Eigenschaft überprüfen Sie vor dem Anzeigen einer Benutzeroberfläche für das Speichern von Eigenschaftswerten und SaveProperties auf truefestlegen.
Ein Codebeispiel, bietet ein Beispiel dafür, wie Sie die SaveProperties -Eigenschaft verwendet, finden Sie unter WebPart.