PersonalizationAdministration.ResetState Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Сбрасывает данные персонализации в базовом хранилище данных с учетом элементов, содержащихся в коллекции.
public:
static int ResetState(System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ data);
public static int ResetState (System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection data);
static member ResetState : System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection -> int
Public Shared Function ResetState (data As PersonalizationStateInfoCollection) As Integer
Параметры
Коллекция объектов PersonalizationStateInfo, которые указывают, какие данные следует сбросить.
Возвращаемое значение
Количество строк, для которых был выполнен сброс.
Исключения
data
имеет значение null
.
data
является пустой коллекцией.
-или-
Элемент коллекции представляет null
.
-или-
Значению пути для экземпляра UserPersonalizationStateInfo в коллекции соответствует null
или пустая строка ("").
-или-
Значению user
для экземпляра UserPersonalizationStateInfo в коллекции соответствует null
или пустая строка либо оно содержит запятые.
-или-
Поставщик, указанный в конфигурации в качестве поставщика персонализации, имеет неправильный тип.
-или-
Длина строки для любого параметра превышает 256 символов.
При попытке создания и инициализации нового экземпляра одного из настроенных поставщиков персонализации получено исключение конфигурации.
-или-
Не удалось найти поставщик персонализации по умолчанию (определяется в конфигурации).
Поставщик по умолчанию указывает, что число удаленных строк было отрицательным числом.
Комментарии
Этот метод сбрасывает данные персонализации в базовом хранилище данных на PersonalizationStateInfo основе объектов, содержащихся в коллекции. Этот метод можно использовать для выборочного удаления сочетания общих и пользовательских данных на основе содержимого коллекции. SharedPersonalizationStateInfo объекты указывают, что общие данные для страницы будут сброшены; UserPersonalizationStateInfo объекты указывают, что данные для конкретной страницы будут сброшены.
Примечание
Этот метод не гарантирует, что все сбросы происходят в рамках одной транзакции, так как сбор указывает на случайные наборы данных персонализации.
Не является ошибкой, если коллекция содержит объекты, ссылающиеся на несуществующие данные.