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

Referência

Definição

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Origem:: Interaction.vb

Origem:: Interaction.vb

Origem:: Interaction.vb

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Aplica-se a

Compartilhar via