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

Definição

Espaço de Nomes:
Microsoft.VisualBasic
Assemblagem:
Microsoft.VisualBasic.dll

Guarda ou cria uma entrada de aplicação no registo do Windows. A My funcionalidade proporciona-lhe maior produtividade e desempenho nas operações de registo do que SaveSetting. Para obter mais informações, veja Registry.

public:
 static void SaveSetting(System::String ^ AppName, System::String ^ Section, System::String ^ Key, System::String ^ Setting);
public static void SaveSetting(string AppName, string Section, string Key, string Setting);
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

Required. String que contém o nome da aplicação ou projeto ao qual a definição se aplica.

Section
String

Required. String expressão contendo o nome da secção onde a definição de chave está a ser guardada.

Key
String

Required. String expressão contendo o nome da definição de chave que está a ser guardada.

Setting
String

Required. Expressão contendo o valor ao qual Key está a ser definido.

Exceções

ArgumentException

O registo de chaves não pôde ser criado, ou o utilizador não está logado.

Exemplos

O exemplo seguinte usa primeiro a função SaveSetting para fazer entradas no registo Windows da aplicação MyApp, e depois usa a função DeleteSetting para as remover.

' 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")

Observações

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

Se a definição da chave não puder ser guardada por qualquer motivo, ocorre um erro.

SaveSetting requer que um utilizador esteja iniciado sessão, uma vez que opera sob a chave do HKEY_LOCAL_USER registo, que não está ativa até que o utilizador inicie sessão interativamente.

As definições do registo que devem ser acedidas a partir de um processo não interativo (como Mtx.exe) devem ser armazenadas sob as HKEY_LOCAL_MACHINE\Software\ ou as HKEY_USER\DEFAULT\Software chaves do registo.

SaveSetting requer Write e CreateRegistryPermission.

Aplica-se a

Ver também