共用方式為


WebPart.SaveProperties property

取得或設定一個值,指出的網頁組件屬性是否已變更,以及是否應該保存結尾處的頁面轉譯。

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

Syntax

'宣告
Protected Friend Property SaveProperties As Boolean
    Get
    Set
'用途
Dim value As Boolean

value = Me.SaveProperties

Me.SaveProperties = value
protected internal bool SaveProperties { get; set; }

Property value

Type: System.Boolean
true如果應該保存的網頁組件屬性 ;否則,請false。

備註

SaveProperties屬性一開始是設定false頁面轉譯的開頭。此屬性只能在頁面轉譯期間很有用。例如,此屬性無效果透過物件模型在存取網頁組件時。

SaveProperties屬性可以用於網頁組件之後所轉譯的網頁組件頁面,其屬性變更時。屬性有所變更之後, WebPart類別可將SaveProperties屬性設true指定將會儲存變更的任何屬性。SaveProperties屬性的值已讀取的網頁組件基礎結構的網頁組件的System.Web.UI.Control.UnLoad事件發生之後,在其中點所有屬性值是查詢,並且儲存在 SharePoint 資料庫。如果未設定此屬性,屬性還原為其原始值具現化網頁組件中的下一次。

除非主動呈現網頁組件,則會忽略SaveProperties屬性的值。例如,產生新的網頁組件,變更屬性值,然後設定SavePropertiestrue就沒有作用。SaveProperties屬性應該使用網頁組件,需要儲存已經變更之後所轉譯的屬性。如果屬性從外部設定,最好是明確,或將SaveProperties屬性設定網頁組件代表轉譯週期期間外部代理程式的責任,即可選擇要將儲存網頁組件。

如果SaveProperties屬性設在靜態網頁組件 (網頁組件不位於區域),或其中使用者沒有足夠的權限,以儲存變更 (例如,針對匿名使用者) 的網頁組件時,儲存該網頁組件時,會擲回例外。網頁組件應該檢查Permissions屬性,顯示使用者介面,用於儲存屬性值和SaveProperties設true之前。

若要檢視提供如何使用SaveProperties屬性的範例程式碼範例,請參閱 < WebPart

請參閱

參照

WebPart class

WebPart members

Microsoft.SharePoint.WebPartPages namespace