SaveSetting 関数
更新 : 2007 年 11 月
Windows レジストリに、アプリケーションの初期ファイルを保存または作成します。
My 機能では、SaveSetting よりも、レジストリ操作の生産性とパフォーマンスが高くなっています。詳細については、「My.Computer.Registry オブジェクト」を参照してください。
Public Sub SaveSetting( _
ByVal AppName As String, _
ByVal Section As String, _
ByVal Key As String, _
ByVal Setting As String _
)
パラメータ
AppName
必ず指定します。設定を適用するアプリケーション名またはプロジェクト名を含む文字列型 (String) の式を指定します。Section
必ず指定します。キー設定を保存するセクション名を含む文字列型 (String) の式を指定します。Key
必ず指定します。保存するキー設定名を含む文字列型 (String) の式を指定します。Setting
必ず指定します。Key が設定される値を含む式です。
例外
例外の種類 |
エラー番号 |
条件 |
---|---|---|
キーのレジストリを作成できませんでした。または、ユーザーがログインしていません。 |
非構造化エラー処理を使用する Visual Basic 6.0 アプリケーションをアップグレードする場合は、「エラー番号」列を参照してください(エラー番号を Number プロパティ (Err オブジェクト) と照らし合わせます)。しかし、可能な限り、このエラー処理は Visual Basic の構造化例外処理の概要 で置き換えてください。
解説
SaveSetting 関数は、キーを HKEY_CURRENT_USER\Software\VB and VBA Program Settings に追加します。
キー設定が保存できない場合、エラーが発生します。
SaveSetting は、ユーザーが対話形式でログオンするまでアクティブにならない HKEY_LOCAL_USER レジストリ キーのもとで動作するため、ユーザーがログオンしていることが必要条件です。
双方向でないプロセス (Mtx.exe など) からアクセスするレジストリの設定は、HKEY_LOCAL_MACHINE\Software\ または HKEY_USER\DEFAULT\Software レジストリ キーのいずれかに格納されます。
SaveSetting には、WriteReadCreate のレジストリ アクセス許可が必要です。
使用例
次の例は、最初に SaveSetting 関数を使用して、Windows のレジストリに MyApp アプリケーションのエントリを作成します。次に、DeleteSetting 関数を使用して、作成したエントリを削除します。
' 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")
スマート デバイス開発者のためのメモ
この関数はサポートされていません。
必要条件
名前空間 : Microsoft.VisualBasic
モジュール : Interaction
**アセンブリ :**Visual Basic ランタイム ライブラリ (Microsoft.VisualBasic.dll)