Partilhar via


Interaction.SaveSetting(String, String, String, String) Método

Definição

Salva ou cria uma entrada de aplicativo no Registro do Windows. O recurso My oferece maior produtividade e desempenho em operações de registro do que SaveSetting. Para obter mais informações, consulte Registry.

public:
 static void SaveSetting(System::String ^ AppName, System::String ^ Section, System::String ^ Key, System::String ^ Setting);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void SaveSetting (string AppName, string Section, string Key, string Setting);
public static void SaveSetting (string AppName, string Section, string Key, string Setting);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member SaveSetting : string * string * string * string -> unit
static member SaveSetting : string * string * string * string -> unit
Public Sub SaveSetting (AppName As String, Section As String, Key As String, Setting As String)

Parâmetros

AppName
String

Necessário. String expressão que contém o nome do aplicativo ou projeto ao qual a configuração se aplica.

Section
String

Necessário. String expressão que contém o nome da seção na qual a configuração da chave está sendo salva.

Key
String

Necessário. String expressão que contém o nome da configuração de chave que está sendo salva.

Setting
String

Necessário. Expressão que contém o valor ao qual Key está sendo definido.

Atributos

Exceções

Não foi possível criar o registro de chave ou o usuário não está conectado.

Exemplos

O exemplo a seguir primeiro usa a função SaveSetting para fazer entradas no Registro do Windows para o aplicativo MyApp e, em seguida, usa a função DeleteSetting para removê-las.

' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp", "Startup", "Left", "50")
' Remove Startup section and all its settings from registry.
DeleteSetting("MyApp", "Startup")
' Remove MyApp from the registry.
DeleteSetting("MyApp")

Comentários

A função SaveSetting adiciona a chave a HKEY_CURRENT_USER\Software\VB and VBA Program Settings.

Se a configuração da chave não puder ser salva por qualquer motivo, ocorrerá um erro.

SaveSetting requer que um usuário seja conectado, pois ele opera sob a chave do Registro HKEY_LOCAL_USER, que não está ativa até que um usuário faça logon interativamente.

As configurações do Registro que devem ser acessadas de um processo não interativo (como Mtx.exe) devem ser armazenadas no HKEY_LOCAL_MACHINE\Software\ ou nas chaves do registro HKEY_USER\DEFAULT\Software.

SaveSetting requer Write e CreateRegistryPermission.

Aplica-se a

Confira também