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 melhor produtividade e desempenho em operações do Registro do que o 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

Obrigatórios. Expressão String que contém o nome do aplicativo ou do projeto a que a configuração se aplica.

Section

String

Obrigatórios. Expressão String que contém o nome da seção na qual a configuração de chave está sendo salva.

Key

String

Obrigatórios. Expressão String que contém o nome da configuração de chave que está sendo salva.

Setting

String

Obrigatórios. Expressão que contém o valor para o 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 SaveSetting função para fazer entradas no Registro do Windows para o MyApp aplicativo e, em seguida, usa a DeleteSetting função 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 SaveSetting função 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 HKEY_LOCAL_USER Registro, 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 nas chaves do HKEY_LOCAL_MACHINE\Software\ registro ou 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
• Lendo e gravando a partir do Registro (Visual Basic)