PersonalizationDictionary.Add(String, PersonalizationEntry) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Adiciona entradas de personalização ao dicionário de personalização.
public:
virtual void Add(System::String ^ key, System::Web::UI::WebControls::WebParts::PersonalizationEntry ^ value);public virtual void Add (string key, System.Web.UI.WebControls.WebParts.PersonalizationEntry value);abstract member Add : string * System.Web.UI.WebControls.WebParts.PersonalizationEntry -> unit
override this.Add : string * System.Web.UI.WebControls.WebParts.PersonalizationEntry -> unitPublic Overridable Sub Add (key As String, value As PersonalizationEntry)Parâmetros
- key
- String
O identificador exclusivo de uma parte das informações de estado.
- value
- PersonalizationEntry
Uma parte das informações de estado a ser adicionada ao dicionário de personalização. Este valor pode ser null.
Exceções
key é uma duplicata de uma chave que já está no dicionário.
- ou -
key é uma cadeia de caracteres vazia ("") ou cortar key resulta em uma cadeia de caracteres vazia.
- ou -
value não é um PersonalizationEntry.
Comentários
Você pode chamar esse método, inserir várias partes de informações de estado personalizadas no objeto de estado e especificar o escopo associado ao valor de estado. Quando um WebPartManager controle está no Shared escopo, você pode adicionar informações de nome e estado associadas ao Shared escopo ou User escopo. No User escopo, você pode adicionar informações de nome e estado associadas somente ao User escopo.
No entanto, é uma boa prática adicionar todas as propriedades ao dicionário usando a Save inclusão de propriedades com User ou Shared escopo, independentemente do escopo da página.
O .NET Framework salva apenas as propriedades com Shared escopo quando apropriado. Em outras palavras, as propriedades compartilhadas não são salvas quando um WebPart controle que foi inicialmente adicionado no Shared escopo é salvo posteriormente enquanto a página está no User escopo. Em um cenário oposto, se um WebPart controle tiver sido adicionado à página no User escopo e o controle for salvo posteriormente enquanto a página estiver no Shared escopo, os valores de propriedade compartilhada personalizada serão salvos (juntamente com as propriedades personalizadas no escopo do usuário). Para obter detalhes sobre os dados de personalização e como as propriedades compartilhadas e no escopo do usuário são afetadas pelo escopo de personalização da página, consulte o tópico visão geral da personalização de Web Parts .
Assim como ocorre com qualquer coleção, esse método incrementa a contagem de coleções em um e todos os enumeradores atualmente ativos na coleção devem ser invalidados.