ISettingsReader.SubscribeToChanges Método

Referência

Definição

Namespace:: Microsoft.VisualStudio.Utilities.UnifiedSettings

Assembly:: Microsoft.VisualStudio.Utilities.dll

Pacote:: Microsoft.VisualStudio.Utilities v17.12.40391

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.

Registra um retorno de chamada a ser invocado quando os valores efetivos das configurações são alterados. Observe que uma configuração pode ser alterada sem afetar seu valor efetivo se a configuração for substituída em um escopo de prioridade mais alta , por exemplo, se uma alteração de configuração for aplicada ao escopo do "usuário" (prioridade mais baixa), mas a mesma configuração também for personalizada no escopo "workspace" (prioridade mais alta), a alteração não afetará o valor efetivo.

public IDisposable SubscribeToChanges (Action<Microsoft.VisualStudio.Utilities.UnifiedSettings.SettingsUpdate> handler, params string[] monikerPatterns);

abstract member SubscribeToChanges : Action<Microsoft.VisualStudio.Utilities.UnifiedSettings.SettingsUpdate> * string[] -> IDisposable

Public Function SubscribeToChanges (handler As Action(Of SettingsUpdate), ParamArray monikerPatterns As String()) As IDisposable

Parâmetros

handler: Action<SettingsUpdate>

O retorno de chamada a ser invocado quando as configurações forem alteradas.

monikerPatterns: String[]

Uma coleção de monikers de configuração (como "environment.general.visualExperience.colorTheme") ou prefixos + curinga (como "environment.general.*") que representa as configurações que dispararão esse retorno de chamada.

Retornos

IDisposable

Um objeto que cancelará o registro desse manipulador quando for descartado.

Exceções

ArgumentNullException

Gerado se handler ou monikerPatterns for nulo.

ArgumentException

Lançada se monikerPatterns estiver vazia.

Aplica-se a

Partilhar via