Interaction.SaveSetting メソッド

.NET Framework クラス ライブラリ リファレンス

Interaction.SaveSetting メソッド

Windows レジストリにアプリケーションのエントリを保存または作成します。My 機能を使用すると、SaveSetting を使用した場合より生産性とパフォーマンスが向上します。詳細については、「My.Computer.Registry オブジェクト」を参照してください。

名前空間: Microsoft.VisualBasic
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Shared Sub SaveSetting
 ( _
    AppName As String, _
    Section As String, _
    Key As String, _
    Setting As String _
)

Visual Basic (使用法)

Dim AppName As String
Dim Section As String
Dim Key As String
Dim Setting As String

Interaction.SaveSetting(AppName, Section, Key, Setting)

C#

public static void SaveSetting
 (
    string AppName,
    string Section,
    string Key,
    string Setting
)

C++

public:
static void SaveSetting (
    String^ AppName, 
    String^ Section, 
    String^ Key, 
    String^ Setting
)

J#

public static void SaveSetting
 (
    String AppName, 
    String Section, 
    String Key, 
    String Setting
)

JScript

public static function SaveSetting
 (
    AppName : String, 
    Section : String, 
    Key : String, 
    Setting : String
)

パラメータ

AppName

必須。設定を適用するアプリケーションまたはプロジェクトの名前が含まれている String 式です。

Section

必須。キーの設定を保存するセクションの名前を含む String 式です。

Key

必須。保存するキー設定の名前を含む String 式です。

Setting

必須。Key に設定する値を含む式です。

解説

詳細については、Visual Basic のトピック「SaveSetting 関数」を参照してください。

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 では、Write および Create のレジストリ アクセス許可が必要です。

使用例

次に示す例では、まず SaveSetting 関数を使用して Windows レジストリに MyApp アプリケーションのエントリを作成した後、DeleteSetting 関数を使用してそのエントリを削除します。

Visual Basic

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Interaction クラス
Interaction メンバ
Microsoft.VisualBasic 名前空間
RegistryPermission Class
その他の技術情報
SaveSetting 関数
DeleteSetting 関数
GetAllSettings 関数
GetSetting 関数
一般的なレジストリ タスク