Partilhar via


Microsoft.VisualStudio.Settings Namespace

Classes

CrossProcessMutexFactory
ExternalSettingsManager

Uma implementação da classe que permite que os SettingsManager aplicativos acessem configurações do Visual Studio ou de um shell isolado, que é selecionado por seu AppID.

IdleStateChangedEventArgs

Argumentos para uma alteração no estado ocioso do aplicativo.

ListMerger

Manipula operações de mesclagem para definir coleções.

NamedVersionedString

Um valor de configuração serializado como uma cadeia de caracteres junto com um nome, versão e sinalizador local do computador associados.

SerializedSetting
ServiceHubPubSubTopic
ServiceUploadParameters
ServiceUploadResult
SettingNameTooLongException

Essa exceção é gerada a partir da tentativa de criar uma configuração cujo nome excede o limite de ISettingsManager comprimento imposto pelo servidor de configurações de roaming (atualmente 128 caracteres).

SettingsEventArgs

Argumentos de evento para um evento de configurações.

SettingsListChangedEventArgs

EventArgs descrevendo uma alteração para um ISettingsList.

SettingsManager

Essa é a classe de gateway a ser acessada para as configurações armazenadas dentro do Visual Studio. Ele fornece duas funcionalidades básicas. Ele permite pesquisar propriedades e coleções dentro dos escopos. Ele entrega as SettingsStore classes e WritableSettingsStore para manipulação adicional das coleções e propriedades dentro dos escopos.

SettingsManagerFactory

Uma classe de fábrica que constrói um ISettingsManager.

SettingsStore

Classe abstrata para leitura/enumeração das coleções e propriedades do escopo selecionado. Ele é obtido do GetReadOnlySettingsStore(SettingsScope) método .

Nos métodos dessa classe, se o caminho da coleção for fornecido como a cadeia de caracteres vazia (""), ele indicará a coleção de nível superior. Se o nome da propriedade for uma cadeia de caracteres vazia, ele indicará a propriedade padrão da coleção.

As coleções podem conter propriedades e subcoleções. Os caminhos de subcoleções são descritos com os separadores, como diretórios no sistema de arquivos. Da mesma forma, o separador é o caractere '' (barra invertida). O exemplo de um caminho de subcoleção seria: "Coleção Raiz\Coleção Interna\Coleção Folha".

SettingTooLargeException

Essa exceção é gerada (de , ISettingsListetc.) quando um valor de configuração é fornecido cuja representação serializada excede o limite de ISettingsManagertamanho no servidor de configurações de roaming (atualmente 1 MB).

StoreLogPropertyDefinition

Uma maneira não genérica de se referir a um StoreLogPropertyDefinition<T>e também ao local em que as propriedades conhecidas são definidas.

StoreLogPropertyDefinition<T>

Uma propriedade de log do repositório sem um valor atribuído.

StoreLogPropertyInstance

Uma maneira não genérica de se referir a um StoreLogPropertyInstance<T>.

StoreLogPropertyInstance<T>

Uma propriedade de log do repositório com um valor específico.

StringWithMachineLocalFlag

Um valor de configuração serializado como uma cadeia de caracteres junto com um sinalizador que indica se o valor contém conteúdo local do computador.

VersionedString

Um valor de configuração serializado como uma cadeia de caracteres junto com uma versão associada e um sinalizador local do computador.

WritableSettingsStore

Classe abstrata para ler e gravar as coleções e propriedades do escopo selecionado. Ele é obtido do GetWritableSettingsStore(SettingsScope) método .

Essa classe é derivada de SettingsStore, portanto, herda todas as funcionalidades dela. Ele adiciona habilidades de manipulação de propriedade e coleção sobre ela.

Interfaces

IAsyncStringStorage

Armazena e recupera cadeias de caracteres. Usado como uma abstração sobre o serviço de configurações nas simulações de hub e teste de unidade.

ICrossProcessLockFactory
IInteropLogger
IListMerger

Manipula operações de mesclagem para definir coleções.

IRemoteDefaultsStore
ISettingNameTranslator

Converte entre nomes privados e nomes compartilhados. Isso permite que um aplicativo isole suas configurações de outros aplicativos inserindo um prefixo ou sufixo.

ISettingsChangeSuppressor

Permite o bloqueio temporário de alterações nas configurações que foram modificadas desde uma determinada versão.

ISettingsList

Uma coleção de configurações. A coleção é ordenada, mas o servidor é independente da ordem. Os itens só podem ser adicionados na frente, mas removidos de qualquer lugar. A coleção é preservada pelo servidor na ordem em que foi criada. As chaves são tratadas como não diferenciam maiúsculas de minúsculas.

ISettingsManager

Armazena e recupera configurações, bem como manipula a sincronização entre aplicativos e computadores.

ISettingsManager2
ISettingsManager4
ISettingsManagerHost

Funcionalidade fornecida pelo aplicativo que cria um ISettingsManager por meio de CreateInstance(ISettingsManagerHost).

ISettingsManagerHost2
ISettingsManagerHost3
ISettingsManagerHost4
ISettingsManagerHost5
ISettingsService

A API pública apresentada pelo módulo de serviço. Os implementadores devem esperar que uma instância separada seja criada para (pelo menos) cada cliente ou (no máximo) cada solicitação de cliente.

ISettingsSubset

Um subconjunto de configurações (uma única configuração ou todas as configurações que correspondem a um padrão curinga) para o qual se pode assinar eventos de alteração.

IStoreUpdateLogger

Um agente para configurações armazena registros de atualização.

IStoreUpdateLoggerWithAmbientContext

Adiciona contexto ambiente a um IStoreUpdateLogger. O contexto ambiente é implementado por meio do SetContext(StoreLogPropertyInstance[]) método , que permite que o chamador forneça propriedades que serão definidas em todos os eventos emitidos dentro do contexto de execução atual até que o retornado IDisposable seja descartado.

IStringStorage

Armazena e recupera cadeias de caracteres. Usado como uma abstração sobre as simulações de registro e teste de unidade.

IStringStorage2

Enumerações

ApplicationDataFolder

Essa enumeração é usada para especificar a pasta que o Visual Studio usa para manter vários arquivos para diferentes finalidades, como arquivos de cache, arquivos de backup ou arquivos de modelo.

EnclosingScopes

Essa enumeração é retornada como resultado de uma chamada de consulta para os métodos GetPropertyScope ou GetCollectionScope da classe SettingsManager para aprender os escopos delimitador da propriedade ou coleção fornecida. Essa é uma enumeração de sinalizadores, o que significa que é possível que mais de um sinalizador de enumeração possa ser definido para os escopos correspondentes.

GetValueResult

O resultado de uma operação para recuperar um valor do repositório de configurações.

ServiceUploadResultKind
SettingsEvent

Evento de configurações que pode ser acionado pelo serviço de configurações.

SettingsListOperation

Uma operação executada em um ISettingsList.

SettingsScope

Essa enumeração é usada para especificar o escopo das configurações recuperadas da classe SettingsManager.

SettingsType

Tipos de dados das propriedades armazenadas dentro das coleções.

Delegados

AsyncEventHandler

Um manipulador para eventos assíncronos que retorna um Task

CharSpanProcessorDelegate

Processa um intervalo de caracteres.

CollectionChangedAsyncEventHandler

Um manipulador para alterações em um ISettingsList que retorna um Task para que ele possa ser assíncrono.

LockedStorageCreatorDelegate<T>

Um delegado que cria um objeto stoage, usado pelo construtor da fábrica de armazenamento.

NonLockedStorageCreatorDelegate<T>

Um delegado que cria um objeto de armazenamento, usado pelo construtor da fábrica de armazenamento.

PropertyChangedAsyncEventHandler

Um manipulador de eventos semelhante ao que retorna um Task para PropertyChangedEventHandler que o manipulador possa ser assíncrono.

StoreUpdatedEventHandler

Um manipulador para eventos gerados por StoreUpdated que retorna um Task para que possa ser assíncrono.