Microsoft.VisualStudio.Settings Spazio dei nomi

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.

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

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

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

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).

Argomenti dell'evento per un evento delle impostazioni.

EventArgs descrizione di una modifica a un oggetto ISettingsList.

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.

Classe factory che costruisce un oggetto ISettingsManager.

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".

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).

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

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

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

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

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

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

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.

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

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

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.

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

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.

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

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

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.

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.

Un logger per le impostazioni archivia i record di aggiornamento.

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 .

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

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.

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.

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

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

Operazione eseguita su un oggetto ISettingsList.

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

Tipi di dati delle proprietà archiviate nelle raccolte.

Gestore per gli eventi asincroni che restituisce un oggetto Task

Elabora un intervallo di caratteri.

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

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

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

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

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