PersonalizationDictionary.Add(String, PersonalizationEntry) Método
Definição
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.
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 único de uma informação do estado.
- value
- PersonalizationEntry
Uma informação de estado para ser adicionada ao dicionário de personalização. Este valor pode ser null.
Exceções
key é um duplicado de uma chave já presente no dicionário.
-ou-
key é ou uma corda vazia ("") ou o corte key resulta numa cadeia vazia.
-ou-
value não é um PersonalizationEntry.
Observações
Pode chamar este método, colocar várias informações de estado personalizadas no objeto de estado e especificar o âmbito associado ao valor do estado. Quando um WebPartManager controlo está dentro Shared do âmbito, pode adicionar informações de nome e estado associadas ao Shared âmbito ou User ao âmbito. No User âmbito do âmbito, pode adicionar informações de nome e estado associadas apenas ao User âmbito.
É uma boa prática, no entanto, adicionar todas as propriedades ao dicionário incluindo Save propriedades com User ou Shared âmbito, independentemente do âmbito da página.
O .NET Framework só guarda as propriedades com o âmbito Shared quando apropriado. Por outras palavras, as propriedades partilhadas não são guardadas quando um WebPart controlo que foi inicialmente adicionado no Shared âmbito é posteriormente guardado enquanto a página está dentro User do âmbito. Num cenário oposto, se um WebPart controlo for adicionado à página no User âmbito e o controlo for posteriormente guardado enquanto a página está no Shared âmbito, valores personalizados de propriedades partilhadas são guardados (juntamente com propriedades personalizadas com âmbito do utilizador). Para detalhes sobre dados de personalização e como as propriedades partilhadas e com âmbito de utilizador são afetadas pelo âmbito de personalização da página, consulte o tópico Web Parts Personalization View .
Como em qualquer coleção, este método incrementa a contagem da coleção em um e quaisquer enumeradores atualmente ativos na coleção devem ser invalidados.