Freigeben über


Microsoft.VisualStudio.Settings Namespace

Klassen

CrossProcessMutexFactory
ExternalSettingsManager

Eine Implementierung der SettingsManager-Klasse, die es Anwendungen ermöglicht, auf Einstellungen in Visual Studio oder von einer isolierten Shell zuzugreifen, von denen der jeweilige von seinem AppID ausgewählt werden.

IdleStateChangedEventArgs

Argumente für eine Änderung des Leerlaufzustands der Anwendung.

ListMerger

Verarbeitet Zusammenführungsvorgänge zum Festlegen von Sammlungen.

NamedVersionedString

Ein Einstellungswert, der als Zeichenfolge zusammen mit einem zugeordneten Namen, einer Version und einem lokalen Computerflag serialisiert wurde.

SerializedSetting
ServiceHubPubSubTopic
ServiceUploadParameters
ServiceUploadResult
SettingNameTooLongException

Diese Ausnahme wird ausgelöst ISettingsManager , wenn Versucht wird, eine Einstellung zu erstellen, deren Name die vom Server für Roamingeinstellungen festgelegte Längenbeschränkung (derzeit 128 Zeichen) überschreitet.

SettingsEventArgs

Ereignisargumente für ein Einstellungsereignis.

SettingsListChangedEventArgs

EventArgsbeschreibt eine Änderung an .ISettingsList

SettingsManager

Dies ist die Gatewayklasse, die für die in Visual Studio gespeicherten Einstellungen zu erreichen ist. Es bietet zwei grundlegende Funktionen. Es ermöglicht die Suche nach Eigenschaften und Sammlungen innerhalb der Bereiche. Sie übergibt die SettingsStore Klassen und WritableSettingsStore zur weiteren Bearbeitung der Auflistungen und Eigenschaften innerhalb der Bereiche.

SettingsManagerFactory

Eine Factoryklasse, die eine ISettingsManagererstellt.

SettingsStore

Abstrakte Klasse zum Lesen/Aufzählen der Auflistungen und Eigenschaften des ausgewählten Bereichs. Es wird von der GetReadOnlySettingsStore(SettingsScope)-Methode abgerufen.

Wenn der Auflistungspfad in den Methoden dieser Klasse als leere Zeichenfolge ("") angegeben wird, kennzeichnet er die Auflistung der obersten Ebene. Wenn der Eigenschaftenname eine leere Zeichenfolge ist, wird die Standardeigenschaft der Auflistung angegeben.

Auflistungen können Eigenschaften und Untersammlungen enthalten. Untersammlungspfade werden mit den Trennzeichen wie Verzeichnissen im Dateisystem beschrieben. Ebenso ist das Trennzeichen "" (Schrägstrich). Ein Beispiel für einen Untersammlungspfad wäre: "Stammsammlung\Interne Sammlung\Blattsammlung".

SettingTooLargeException

Diese Ausnahme wird ausgelöst (von ISettingsManager, ISettingsListusw.), wenn ein Einstellungswert angegeben wird, dessen serialisierte Darstellung die Größenbeschränkung auf dem Server für Roamingeinstellungen (derzeit 1 MB) überschreitet.

StoreLogPropertyDefinition

Eine nicht generische Methode zum Verweisen auf einen StoreLogPropertyDefinition<T>und den Ort, an dem die bekannten Eigenschaften definiert sind.

StoreLogPropertyDefinition<T>

Eine Speicherprotokolleigenschaft ohne zugewiesenen Wert.

StoreLogPropertyInstance

Eine nicht generische Methode, um auf einen StoreLogPropertyInstance<T>zu verweisen.

StoreLogPropertyInstance<T>

Eine Speicherprotokolleigenschaft mit einem bestimmten Wert.

StringWithMachineLocalFlag

Ein Einstellungswert, der als Zeichenfolge serialisiert ist, zusammen mit einem Flag, das angibt, ob der Wert computerlokalen Inhalt enthält.

VersionedString

Ein Einstellungswert, der zusammen mit einer zugeordneten Version und einem lokalen Computerflag als Zeichenfolge serialisiert wird.

WritableSettingsStore

Abstrakte Klasse für das Lesen und Schreiben der Auflistungen und Eigenschaften des ausgewählten Bereichs. Es wird von der GetWritableSettingsStore(SettingsScope)-Methode abgerufen.

Diese Klasse wird vom SettingsStore abgeleitet, sodass sie alle Funktionen von ihr erbt. Darüber hinaus werden Eigenschaften- und Sammlungsbearbeitungsfunktionen hinzugefügt.

Schnittstellen

IAsyncStringStorage

Speichert und ruft Zeichenfolgen ab. Wird als Abstraktion für den Einstellungsdienst in den Hub- und Komponententest-Mocks verwendet.

ICrossProcessLockFactory
IInteropLogger
IListMerger

Verarbeitet Zusammenführungsvorgänge zum Festlegen von Sammlungen.

IRemoteDefaultsStore
ISettingNameTranslator

Übersetzt zwischen privaten Namen und freigegebenen Namen. Dadurch kann eine Anwendung ihre Einstellungen von anderen Apps isolieren, indem sie ein Präfix oder Suffix einfügt.

ISettingsChangeSuppressor

Ermöglicht das vorübergehende Blockieren von Änderungen an Einstellungen, die seit einer bestimmten Version geändert wurden.

ISettingsList

Eine Sammlung von Einstellungen. Die Sammlung ist sortiert, aber der Server ist auftragsunabhängig. Elemente können nur an der Vorderseite hinzugefügt, aber von überall entfernt werden. Die Sammlung wird vom Server in der Reihenfolge beibehalten, in der sie erstellt wurde. Bei Schlüsseln wird die Groß-/Kleinschreibung nicht beachtet.

ISettingsManager

Speichert und ruft Einstellungen ab und behandelt die Synchronisierung zwischen Anwendungen und Computern.

ISettingsManager2
ISettingsManager4
ISettingsManagerHost

Funktionen, die von der Anwendung bereitgestellt werden, die eine ISettingsManager über CreateInstance(ISettingsManagerHost)erstellt.

ISettingsManagerHost2
ISettingsManagerHost3
ISettingsManagerHost4
ISettingsManagerHost5
ISettingsService

Die öffentliche API, die vom Dienstmodul präsentiert wird. Implementierer sollten erwarten, dass für (mindestens) jeden Client oder (höchstens) jede Clientanforderung ein separater instance erstellt wird.

ISettingsSubset

Eine Teilmenge der Einstellungen (entweder eine einzelne Einstellung oder alle Einstellungen, die einem Wildcardmuster entsprechen), für die Änderungsereignisse abonniert werden können.

IStoreUpdateLogger

Eine Protokollierung für Einstellungen speichert Updatedatensätze.

IStoreUpdateLoggerWithAmbientContext

Fügt einem Umgebungskontext IStoreUpdateLoggerhinzu. Der Umgebungskontext wird über die SetContext(StoreLogPropertyInstance[]) -Methode implementiert, die es dem Aufrufer ermöglicht, Eigenschaften anzugeben, die für alle im aktuellen Ausführungskontext ausgegebenen Ereignisse festgelegt werden, bis das zurückgegebene IDisposable gelöscht wird.

IStringStorage

Speichert und ruft Zeichenfolgen ab. Wird als Abstraktion für die Registrierungs- und Komponententest-Mocks verwendet.

IStringStorage2

Enumerationen

ApplicationDataFolder

Diese Enumeration wird verwendet, um den Ordner anzugeben, den Visual Studio verwendet, um verschiedene Dateien für verschiedene Zwecke zu speichern, beispielsweise Cachedateien, Sicherungsdateien oder Vorlagendateien.

EnclosingScopes

Diese Enumeration wird als Ergebnis eines Abfrageaufrufs der GetPropertyScope- oder GetCollectionScope-Methoden der SettingsManager-Klasse zurückgegeben, um die einschließenden Bereiche der bereitgestellten Eigenschaft oder Auflistung zu lernen. Dies ist eine Flags-Enumeration, was bedeutet, dass mehrere Enumerationsflags für die entsprechenden Bereiche festgelegt werden können.

GetValueResult

Das Ergebnis eines Vorgangs zum Abrufen eines Werts aus dem Einstellungsspeicher.

ServiceUploadResultKind
SettingsEvent

Einstellungsereignis, das möglicherweise vom Einstellungsdienst ausgelöst wird.

SettingsListOperation

Ein Vorgang, der für eine ISettingsListausgeführt wird.

SettingsScope

Diese Enumeration wird verwendet, um den Bereich der Einstellungen anzugeben, der von der SettingsManager-Klasse abgerufen wird.

SettingsType

Datentypen der Eigenschaften, die innerhalb der Auflistungen gespeichert werden.

Delegaten

AsyncEventHandler

Ein Handler für asynchrone Ereignisse, der eine zurückgibt Task

CharSpanProcessorDelegate

Verarbeitet eine Zeichenspanne.

CollectionChangedAsyncEventHandler

Ein Handler für Änderungen an, ISettingsList der einen Task zurückgibt, damit es asynchron sein kann.

LockedStorageCreatorDelegate<T>

Ein Delegat, der ein Stoage-Objekt erstellt, das vom Konstruktor der Speicherfactory verwendet wird.

NonLockedStorageCreatorDelegate<T>

Ein Delegat, der ein Speicherobjekt erstellt, das vom Konstruktor der Speicherfactory verwendet wird.

PropertyChangedAsyncEventHandler

Ein Ereignishandler ähnlich dem PropertyChangedEventHandler gibt einen zurück Task , sodass der Handler asynchron sein kann.

StoreUpdatedEventHandler

Ein Handler für Ereignisse, die von ausgelöst werden StoreUpdated , der einen Task zurückgibt, damit er asynchron sein kann.