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

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

Interaction.vb

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

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
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

SupportedOSPlatformAttribute

Exceções

ArgumentException

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.

Confira também

• DeleteSetting(String, String, String)
• GetAllSettings(String, String)
• GetSetting(String, String, String, String)
• RegistryPermission
• leitura e gravação no Registro (Visual Basic)