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 para uma informação de estado.
- value
- PersonalizationEntry
Uma parte das informações de estado a serem adicionadas ao dicionário de personalização. Este valor pode ser null.
Exceções
key é uma duplicata de uma chave já no dicionário.
- ou -
key é uma cadeia de caracteres vazia ("") ou o corte resulta key em uma cadeia de caracteres vazia.
- ou -
value não é um PersonalizationEntry.
Comentários
Você pode chamar esse método, colocar 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 ao escopo. No User escopo, você pode adicionar informações de nome e estado associadas apenas ao User escopo.
No entanto, é uma boa prática adicionar todas as propriedades ao dicionário usando Save a inclusão de propriedades com User ou Shared escopo, independentemente do escopo da página.
O .NET Framework salva apenas as propriedades com o escopo Shared 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 foi adicionado à página no User escopo e o controle é salvo posteriormente enquanto a página está no Shared escopo, os valores de propriedade compartilhada personalizados são salvos (juntamente com propriedades personalizadas no escopo do usuário). Para obter detalhes sobre os dados de personalização e como as propriedades compartilhadas e com escopo de 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 acontece com qualquer coleção, esse método incrementa a contagem de coleções por um e todos os enumeradores atualmente ativos na coleção devem ser invalidados.
