Condividi tramite


Microsoft.VisualStudio.Settings Spazio dei nomi

Classi

CrossProcessMutexFactory
ExternalSettingsManager

Implementazione della classe SettingsManager che consente alle applicazioni di accedere alle impostazioni da Visual Studio o da una shell isolata; in entrambi i casi, è possibile effettuare la selezione tramite il relativo AppID.

IdleStateChangedEventArgs

Argomenti per una modifica nello stato di inattività dell'applicazione.

ListMerger

Gestisce le operazioni di unione per l'impostazione delle raccolte.

NamedVersionedString

Valore di impostazione serializzato come stringa insieme a un nome, una versione e un flag locale del computer associati.

SerializedSetting
ServiceHubPubSubTopic
ServiceUploadParameters
ServiceUploadResult
SettingNameTooLongException

Questa eccezione viene generata quando ISettingsManager si tenta di creare un'impostazione il cui nome supera il limite di lunghezza imposto dal server delle impostazioni di roaming (attualmente 128 caratteri).

SettingsEventArgs

Argomenti dell'evento per un evento delle impostazioni.

SettingsListChangedEventArgs

EventArgs descrizione di una modifica a un oggetto ISettingsList.

SettingsManager

Questa è la classe gateway da raggiungere per le impostazioni archiviate in Visual Studio. Offre due funzionalità di base. Consente di cercare proprietà e raccolte all'interno degli ambiti. Distribuisce le SettingsStore classi e WritableSettingsStore per un'ulteriore manipolazione delle raccolte e delle proprietà all'interno degli ambiti.

SettingsManagerFactory

Classe factory che costruisce un oggetto ISettingsManager.

SettingsStore

Classe astratta per la lettura/enumerazione delle raccolte e delle proprietà dell'ambito selezionato. Viene ottenuta dal metodo GetReadOnlySettingsStore(SettingsScope).

Nei metodi di questa classe se il percorso della raccolta viene fornito come stringa vuota ("") indica la raccolta di livello superiore. Se il nome della proprietà è una stringa vuota, indica la proprietà predefinita dell'insieme.

Le raccolte possono contenere proprietà e raccolte secondarie. I percorsi delle raccolte secondarie vengono descritti con i separatori, ad esempio le directory nel file system. Analogamente, il separatore è '' (barra rovesciata). Un esempio di percorso di raccolta secondaria è: "Root Collection\Internal Collection\Leaf Collection".

SettingTooLargeException

Questa eccezione viene generata (da ISettingsManager, ISettingsListe così via) quando viene assegnato un valore di impostazione la cui rappresentazione serializzata supera il limite di dimensioni nel server delle impostazioni di roaming (attualmente 1 MB).

StoreLogPropertyDefinition

Un modo non generico per fare riferimento a un StoreLogPropertyDefinition<T>oggetto e anche alla posizione in cui sono definite le proprietà note.

StoreLogPropertyDefinition<T>

Proprietà del log dell'archivio senza un valore assegnato.

StoreLogPropertyInstance

Un modo non generico per fare riferimento a un oggetto StoreLogPropertyInstance<T>.

StoreLogPropertyInstance<T>

Proprietà del log dell'archivio con un valore specifico.

StringWithMachineLocalFlag

Valore di impostazione serializzato come stringa insieme a un flag che indica se il valore contiene contenuto locale del computer.

VersionedString

Valore di impostazione serializzato come stringa insieme a una versione associata e a un flag locale del computer.

WritableSettingsStore

Classe astratta per la lettura e la scrittura delle raccolte e delle proprietà dell'ambito selezionato. Viene ottenuta dal metodo GetWritableSettingsStore(SettingsScope).

Questa classe è derivata da SettingsStore, quindi eredita tutte le funzionalità da essa. Aggiunge le capacità di manipolazione delle proprietà e delle raccolte sopra di esso.

Interfacce

IAsyncStringStorage

Archivia e recupera le stringhe. Usato come astrazione sul servizio delle impostazioni nell'hub e gli unit test simulati.

ICrossProcessLockFactory
IInteropLogger
IListMerger

Gestisce le operazioni di unione per l'impostazione delle raccolte.

IRemoteDefaultsStore
ISettingNameTranslator

Converte tra nomi privati e nomi condivisi. In questo modo un'applicazione può isolare le impostazioni da altre app inserendo un prefisso o un suffisso.

ISettingsChangeSuppressor

Consente il blocco temporaneo delle modifiche alle impostazioni modificate da una determinata versione.

ISettingsList

Raccolta di impostazioni. La raccolta è ordinata, ma il server è indipendente dall'ordine. Gli elementi possono essere aggiunti solo nella parte anteriore, ma rimossi da qualsiasi posizione. La raccolta viene mantenuta dal server nell'ordine in cui è stata creata. Le chiavi vengono considerate senza distinzione tra maiuscole e minuscole.

ISettingsManager

Archivia e recupera le impostazioni e gestisce la sincronizzazione tra applicazioni e computer.

ISettingsManager2
ISettingsManager4
ISettingsManagerHost

Funzionalità fornite dall'applicazione che crea un ISettingsManager oggetto tramite CreateInstance(ISettingsManagerHost).

ISettingsManagerHost2
ISettingsManagerHost3
ISettingsManagerHost4
ISettingsManagerHost5
ISettingsService

API pubblica presentata dal modulo del servizio. Gli implementatori devono prevedere la creazione di un'istanza separata per ogni client o (al massimo) per ogni richiesta client.

ISettingsSubset

Un subset di impostazioni (una singola impostazione o tutte le impostazioni corrispondenti a un criterio con caratteri jolly) per cui è possibile sottoscrivere gli eventi di modifica.

IStoreUpdateLogger

Un logger per le impostazioni archivia i record di aggiornamento.

IStoreUpdateLoggerWithAmbientContext

Aggiunge il contesto di ambiente a un oggetto IStoreUpdateLogger. Il contesto di ambiente viene implementato tramite il SetContext(StoreLogPropertyInstance[]) metodo , che consente al chiamante di fornire proprietà che verranno impostate su tutti gli eventi generati all'interno del contesto di esecuzione corrente fino all'eliminazione dell'oggetto restituito IDisposable .

IStringStorage

Archivia e recupera le stringhe. Usato come astrazione sul Registro di sistema e sui mock unit test.

IStringStorage2

Enumerazioni

ApplicationDataFolder

Questa enumerazione viene utilizzata per specificare la cartella utilizzata da Visual Studio per conservare vari file per scopi diversi, ad esempio i file di cache, i file di backup o i file modello.

EnclosingScopes

Questa enumerazione viene restituita come risultato di una chiamata di query ai metodi GetPropertyScope o GetCollectionScope della classe SettingsManager per apprendere gli ambiti di inclusione della proprietà o della raccolta fornita. Si tratta di un'enumerazione flag che significa che è possibile impostare più flag di enumerazione per gli ambiti corrispondenti.

GetValueResult

Risultato di un'operazione per recuperare un valore dall'archivio delle impostazioni.

ServiceUploadResultKind
SettingsEvent

Evento delle impostazioni che può essere generato dal servizio impostazioni.

SettingsListOperation

Operazione eseguita su un oggetto ISettingsList.

SettingsScope

Questa enumerazione viene utilizzata per specificare l'ambito delle impostazioni recuperate dalla classe SettingsManager.

SettingsType

Tipi di dati delle proprietà archiviate nelle raccolte.

Delegati

AsyncEventHandler

Gestore per gli eventi asincroni che restituisce un oggetto Task

CharSpanProcessorDelegate

Elabora un intervallo di caratteri.

CollectionChangedAsyncEventHandler

Gestore per le modifiche a un oggetto che restituisce un ISettingsList oggetto Task in modo che possa essere asincrono.

LockedStorageCreatorDelegate<T>

Delegato che crea un oggetto stoage, utilizzato dal costruttore della factory di archiviazione.

NonLockedStorageCreatorDelegate<T>

Delegato che crea un oggetto di archiviazione, utilizzato dal costruttore della factory di archiviazione.

PropertyChangedAsyncEventHandler

Un gestore eventi simile a PropertyChangedEventHandler quello che restituisce un oggetto Task in modo che il gestore possa essere asincrono.

StoreUpdatedEventHandler

Gestore per gli eventi generati da StoreUpdated che restituisce un oggetto Task in modo che possa essere asincrono.