PersonalizationAdministration.ResetUserState Método

Definição

Espaço de Nomes:: System.Web.UI.WebControls.WebParts

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Reinicia todo o estado por utilizador no armazenamento de dados subjacente para os parâmetros especificados.

Sobrecargas

Name	Description
ResetUserState(String)	Reinicia todo o estado por utilizador no armazenamento de dados subjacente para o caminho especificado.
ResetUserState(String[])	Reinicia todo o estado por utilizador no armazenamento de dados subjacente para os caminhos especificados.
ResetUserState(String, String)	Reinicia o estado por utilizador no armazenamento de dados subjacente para a combinação especificada de nome de utilizador e caminho.
ResetUserState(String, String[])	Redefine o estado por utilizador no armazenamento de dados subjacente da página e utilizadores especificados.

ResetUserState(String)

Reinicia todo o estado por utilizador no armazenamento de dados subjacente para o caminho especificado.

public:
 static int ResetUserState(System::String ^ path);

public static int ResetUserState(string path);

static member ResetUserState : string -> int

Public Shared Function ResetUserState (path As String) As Integer

Parâmetros

path: String

O caminho para a página associada à informação do estado de personalização a ser reiniciado.

Devoluções

Int32

O número de linhas que foram reiniciadas.

Exceções

ArgumentNullException

path é null.

ArgumentException

path é uma cadeia vazia ("").

-ou-

O fornecedor para um fornecedor de personalização definido em configuração não é do tipo correto.

-ou-

O comprimento da cadeia de qualquer parâmetro é superior a 256 caracteres.

ConfigurationErrorsException

Ocorreu uma exceção de configuração ao tentar criar e inicializar uma instância de um dos fornecedores de personalização configurados.

-ou-

O fornecedor de personalização padrão definido na configuração não foi encontrado.

HttpException

O fornecedor padrão indicava que o número de linhas eliminadas era um número negativo.

Observações

Este método devolve a contagem do número de linhas que foram reiniciadas. Não é erro tentar reiniciar um estado partilhado inexistente.

Ver também

Aplica-se a

ResetUserState(String[])

Reinicia todo o estado por utilizador no armazenamento de dados subjacente para os caminhos especificados.

public:
 static int ResetUserState(cli::array <System::String ^> ^ usernames);

public static int ResetUserState(string[] usernames);

static member ResetUserState : string[] -> int

Public Shared Function ResetUserState (usernames As String()) As Integer

Parâmetros

usernames: String[]

Um conjunto de nomes de utilizador cujos dados por utilizador devem ser reiniciados.

Devoluções

Int32

O número de linhas que foram reiniciadas.

Exceções

ArgumentNullException

usernames é null.

ArgumentException

usernames é um array de comprimento zero.

-ou-

Um membro de usernames é ou null, contém vírgulas, ou é uma sequência vazia ("") após aparar.

-ou-

O fornecedor para um fornecedor de personalização definido em configuração não é do tipo correto.

-ou-

O comprimento da cadeia de qualquer parâmetro é superior a 256 caracteres.

ConfigurationErrorsException

Ocorreu uma exceção de configuração ao tentar criar e inicializar uma instância de um dos fornecedores de personalização configurados.

-ou-

O fornecedor de personalização padrão definido na configuração não foi encontrado.

HttpException

O fornecedor padrão indicava que o número de linhas eliminadas era um número negativo.

Observações

Este método reinicia todo o estado por utilizador no armazenamento de dados subjacente associado aos utilizadores contidos no usernames parâmetro e devolve uma contagem do número de linhas que foram reiniciadas.

Não é erro tentar reiniciar um estado partilhado inexistente.

Ver também

Aplica-se a

ResetUserState(String, String)

Reinicia o estado por utilizador no armazenamento de dados subjacente para a combinação especificada de nome de utilizador e caminho.

public:
 static bool ResetUserState(System::String ^ path, System::String ^ username);

public static bool ResetUserState(string path, string username);

static member ResetUserState : string * string -> bool

Public Shared Function ResetUserState (path As String, username As String) As Boolean

Parâmetros

path: String

O caminho para a página associada à informação do estado de personalização a ser reiniciado.

username: String

O nome de utilizador associado aos dados de personalização a ser reiniciado.

Devoluções

Boolean

O número de linhas que foram reiniciadas.

Exceções

ArgumentNullException

path ou username é null.

ArgumentException

path ou username é um fio vazio ("") após aparar.

-ou-

username contém vírgulas.

-ou-

O fornecedor para um fornecedor de personalização definido em configuração não é do tipo correto.

-ou-

O comprimento da cadeia de qualquer parâmetro é superior a 256 caracteres.

ConfigurationErrorsException

Ocorreu uma exceção de configuração ao tentar criar e inicializar uma instância de um dos fornecedores de personalização configurados.

-ou-

O fornecedor de personalização padrão definido na configuração não foi encontrado.

HttpException

O fornecedor padrão indicava que o número de linhas eliminadas era um número negativo.

Observações

Não é erro tentar redefinir um estado inexistente do utilizador.

Ver também

Aplica-se a

ResetUserState(String, String[])

Redefine o estado por utilizador no armazenamento de dados subjacente da página e utilizadores especificados.

public:
 static int ResetUserState(System::String ^ path, cli::array <System::String ^> ^ usernames);

public static int ResetUserState(string path, string[] usernames);

static member ResetUserState : string * string[] -> int

Public Shared Function ResetUserState (path As String, usernames As String()) As Integer

Parâmetros

path: String

O caminho para a página associada à informação do estado de personalização a ser reiniciado.

usernames: String[]

Os nomes de utilizador associados aos dados de personalização a serem reiniciados.

Devoluções

Int32

O número de linhas que foram reiniciadas.

Exceções

ArgumentNullException

path ou usernames é null.

ArgumentException

path é um fio vazio ("") após aparar.

-ou-

Um membro de usernames é null, uma sequência vazia após aparar, ou contém vírgulas.

-ou-

usernames é um array de comprimento zero.

-ou-

O fornecedor para um fornecedor de personalização definido em configuração não é do tipo correto.

-ou-

O comprimento da cadeia de qualquer parâmetro é superior a 256 caracteres.

ConfigurationErrorsException

Ocorreu uma exceção de configuração ao tentar criar e inicializar uma instância de um dos fornecedores de personalização configurados.

-ou-

O fornecedor de personalização padrão definido na configuração não foi encontrado.

HttpException

O fornecedor padrão indicava que o número de linhas eliminadas era um número negativo.

Observações

Este método redefine o estado por utilizador no armazenamento de dados subjacente associado a cada utilizador contido no usernames parâmetro para a página especificado por path.

Não é erro tentar redefinir um estado inexistente do utilizador.

Ver também

Aplica-se a

Comentários

Esta página foi útil?