PersonalizationDictionary 类

定义

命名空间:

System.Web.UI.WebControls.WebParts

程序集:

System.Web.dll

封装基本验证规则，这些规则指示是在 User 还是 Shared 范围内将一段自定义数据视为可个性化。

public ref class PersonalizationDictionary : System::Collections::IDictionary

public class PersonalizationDictionary : System.Collections.IDictionary

type PersonalizationDictionary = class
    interface IDictionary
    interface ICollection
    interface IEnumerable

Public Class PersonalizationDictionary
Implements IDictionary

继承

Object

PersonalizationDictionary

实现

ICollection IDictionary IEnumerable

注解

PersonalizationDictionary实例是对象的集合 PersonalizationEntry ，由个性化设置范围和对象值组成。 这些项在对象中分配有一个键 PersonalizationDictionary 。

一种很好的做法是使用方法将所有属性添加到字典 Save 中，而不考虑页面的作用域。 .NET Framework 以适当的方式保存信息;例如，当页面处于范围内时，将保存共享数据 Shared 。 但是，保存 Web 部件值时，不会保存共享属性，页面处于 User 范围内，并且 WebPart 控件是在范围内与页面一起添加的 Shared 。

构造函数

PersonalizationDictionary()	初始化 PersonalizationDictionary 类的新实例。
PersonalizationDictionary(Int32)	使用提供的参数初始化 PersonalizationDictionary 类的新实例。

属性

Count	获取字典中的项数。
IsFixedSize	获取个性化设置字典的大小是否固定。
IsReadOnly	获取个性化设置字典是否是只读的。
IsSynchronized	获取个性化设置字典是否是同步的。
Item[String]	获取或设置个性化设置字典中的一个项。
Keys	获取对包含个性化设置字典的键的 ICollection 对象的引用。
SyncRoot	获取一个对象，该对象可用于同步对个性化设置字典的访问。
Values	获取对包含个性化设置字典中的值的 ICollection 对象的引用。

方法

Add(String, PersonalizationEntry)	向个性化设置字典添加个性化设置项。
Clear()	移除所有来自当前 PersonalizationDictionary 对象的自定义状态信息。
Contains(String)	返回一个值，该值指示个性化设置字典中是否已包含一条具有相同键的自定义状态信息。
CopyTo(DictionaryEntry[], Int32)	将个性化设置字典状态项作为 DictionaryEntry 实例复制到指定数组。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetEnumerator()	返回一个枚举数，该枚举数可用于循环访问个性化设置字典中的各项。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
Remove(String)	根据提供的键移除一个自定义状态项。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

显式接口实现

ICollection.CopyTo(Array, Int32)	实现 CopyTo(Array, Int32) 类的 PersonalizationDictionary 方法。
IDictionary.Add(Object, Object)	实现 Add(Object, Object) 类的 PersonalizationDictionary 方法。
IDictionary.Contains(Object)	实现 Contains(Object) 类的 PersonalizationDictionary 方法。
IDictionary.Item[Object]	获取或设置 Item[Object] 类的 PersonalizationDictionary 属性值。
IDictionary.Remove(Object)	实现 Remove(Object) 类的 PersonalizationDictionary 方法。
IEnumerable.GetEnumerator()	实现 GetEnumerator() 类的 PersonalizationDictionary 方法。

扩展方法

Cast<TResult>(IEnumerable)	将 IEnumerable 的元素强制转换为指定的类型。
OfType<TResult>(IEnumerable)	根据指定类型筛选 IEnumerable 的元素。
AsParallel(IEnumerable)	启用查询的并行化。
AsQueryable(IEnumerable)	将 IEnumerable 转换为 IQueryable。

另请参阅

• SqlPersonalizationProvider
• IDictionary
• ICollection
• ASP.NET Web 部件控件
• Web 部件个性化概述
• 演练：使用用户控件实现 Web 部件个性化设置
• Web 部件个性化