System.PrivateProfileString[String, String, String] Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Returns or sets a string in a settings file or the Windows registry.
public:
property System::String ^ PrivateProfileString[System::String ^, System::String ^, System::String ^] { System::String ^ get(System::String ^ FileName, System::String ^ Section, System::String ^ Key); void set(System::String ^ FileName, System::String ^ Section, System::String ^ Key, System::String ^ value); };
public string PrivateProfileString[string FileName, string Section, string Key] { get; set; }
member this.PrivateProfileString(string * string * string) : string with get, set
Public Property PrivateProfileString(FileName As String, Section As String, Key As String) As String
Parameters
- FileName
- String
Required String. The file name for the settings file. If there's no path specified, the Windows folder is assumed.
- Section
- String
Required String. The name of the section in the settings file that contains Key
. In a Windows settings file, the section name appears between brackets before the associated keys (don't include the brackets with Section
). If you're returning the value of an entry from the Windows registry, Section
should be the complete path to the subkey, including the subtree (for example, "HKEY_CURRENT_USER\Software\Microsoft\Office\version \Word\Options").
- Key
- String
Required String. The key setting or registry entry value you want to retrieve. In a Windows settings file, the key name is followed by an equal sign (=) and the setting. If you're returning the value of an entry from the Windows registry, Key
should be the name of an entry in the subkey specified by Section
(for example, "STARTUP-PATH").
Property Value
Remarks
You can write code that uses a settings file to store and retrieve settings. For example, you can store the name of the active document when you quit Word so that it can be reopened automatically the next time you start Microsoft Word. A settings file is a text file with information arranged like the information in the Windows 3.x WIN.INI file.