ISettingsWriter Interfaz
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Los cambios realizados a través de esta API no surten efecto hasta RequestCommit(String) que se llame a . En ese momento, pueden aprobarse o rechazarse inmediatamente o es posible que deban esperar a la aprobación del usuario. El ámbito en el que se conservan los cambios puede determinarse por el usuario. RequestCommit(String) se puede llamar varias veces.
public interface ISettingsWriter : Microsoft.VisualStudio.Utilities.UnifiedSettings.ISettingsReadertype ISettingsWriter = interface
interface ISettingsReaderPublic Interface ISettingsWriter
Implements ISettingsReader- Implementaciones
Métodos
| Commit(String) |
Obsoletos.
Este método es desusado. En su lugar, use RequestCommit(String). Confirma todos los cambios en cola. Esto puede requerir la aprobación del usuario para completarse. En ese caso, este método devolverá inmediatamente y la confirmación se completará más adelante una vez que el usuario lo haya aprobado. |
| EnqueueArrayChange<T>(String, IReadOnlyList<T>) |
Coloca en cola un cambio en el valor de una configuración de matriz. El usuario puede seleccionar el ámbito de destino durante el proceso de aprobación. La validación se realizará a menos que la configuración no esté registrada. |
| EnqueueChange<T>(String, T) |
Poner en cola un cambio en el valor de una configuración. El usuario puede seleccionar el ámbito de destino durante el proceso de aprobación. La validación se realizará a menos que la configuración no esté registrada. Esto equivale a llamar a EnqueueChange<T>(String, T, SettingWriteOptions) con None. |
| EnqueueChange<T>(String, T, SettingWriteOptions) |
Poner en cola un cambio en el valor de una configuración. El usuario puede seleccionar el ámbito de destino durante el proceso de aprobación. La validación se realizará a menos que la configuración no esté registrada. |
| GetArray<T>(String, SettingReadOptions) |
Obtiene el valor efectivo de una configuración de matriz o el valor predeterminado si no está personalizado. (Heredado de ISettingsReader) |
| GetArrayOrThrow<T>(String) |
Obtiene una configuración de matriz. Si no hay ningún valor persistente, el valor persistente no es válido o el valor persistente no se puede convertir en una matriz de |
| GetValue<T>(String, SettingReadOptions) |
Obtiene el valor efectivo de una configuración que no es de matriz o el valor predeterminado si no está personalizado. (Heredado de ISettingsReader) |
| GetValueOrThrow<T>(String) |
Obtiene una configuración que no es de matriz. Si no hay ningún valor persistente, el valor persistente no es válido o el valor persistente no se puede convertir en |
| RequestCommit(String) |
Solicita una confirmación de todos los cambios en cola. Esto puede requerir la aprobación del usuario para completarse. En ese caso, este método devolverá inmediatamente y la confirmación se completará más adelante una vez que el usuario lo haya aprobado. El usuario aplicará los cambios en el ámbito seleccionado. |
| SubscribeToChanges(Action<SettingsUpdate>, String[]) |
Registra una devolución de llamada que se va a invocar cuando cambian los valores efectivos de la configuración. Tenga en cuenta que una configuración puede cambiar sin afectar a su valor efectivo si la configuración se invalida en un ámbito de prioridad superior, por ejemplo, si se aplica un cambio de configuración al ámbito "usuario" (prioridad inferior), pero la misma configuración también se personaliza en el ámbito de "área de trabajo" (prioridad más alta), el cambio no afectará al valor efectivo. (Heredado de ISettingsReader) |