GetPrivateProfileString(String,String,String,StringBuilder,Int32,String) Method

Managed version of GetPrivateProfileString
No COM Interop is used
If the file does not exist or the value is not in the file, the defaultValue is used.
See: http://msdn.microsoft.com/en-us/library/windows/desktop/ms724348%28v=vs.85%29.aspx

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#
C++/CLI

Public Overloads Shared Function GetPrivateProfileString( _
   ByVal sectionName As String, _
   ByVal settingName As String, _
   ByVal defaultValue As String, _
   ByVal returnedBuffer As StringBuilder, _
   ByVal size As Integer, _
   ByVal filePath As String _
) As Integer

Dim sectionName As String
Dim settingName As String
Dim defaultValue As String
Dim returnedBuffer As StringBuilder
Dim size As Integer
Dim filePath As String
Dim value As Integer
 
value = IniReaderWriter.GetPrivateProfileString(sectionName, settingName, defaultValue, returnedBuffer, size, filePath)

public static int GetPrivateProfileString( 
   string sectionName,
   string settingName,
   string defaultValue,
   StringBuilder returnedBuffer,
   int size,
   string filePath
)

public:
static int GetPrivateProfileString( 
   String^ sectionName,
   String^ settingName,
   String^ defaultValue,
   StringBuilder^ returnedBuffer,
   int size,
   String^ filePath
)

Parameters

sectionName: The INI Section Name. Use GLOBAL for the global section.
settingName: The INI Setting Name
defaultValue: The default value if there is no value
returnedBuffer: StrinbBuilder Output of the string
size: The number of buffer characters (not used but here for backward compatibility)
filePath: The path to the INI file

Return Value

Number of characters returned

Exceptions

Exception	Description
System.ArgumentNullException	Occurs when sectionName, settingName or filePath is null

Example

string expectedValue = "This is a test";
IniReaderWriter.WritePrivateProfileString("MySection", "MySettingName", expectedValue, "MySettingsFile.ini");
 
StringBuilder actualValue= new StringBuilder();
 
int numberOfCharactersReturned = IniReaderWriter.GetPrivateProfileString("MySection", "MySettingName", string.Empty, actualValue, 255, "MySettingsFile.ini");
Console.WriteLine(actualValue);

VB.NET

Dim expectedValue As String = "This is a test"
IniReaderWriter.WritePrivateProfileString("MySection", "MySettingName", expectedValue, "MySettingsFile.ini")
 
Dim actualValue As New StringBuilder()
 
Dim numberOfCharactersReturned As Integer = IniReaderWriter.GetPrivateProfileString("MySection", "MySettingName", String.Empty, actualValue, 255, "MySettingsFile.ini")
Console.WriteLine(actualValue)

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

IniReaderWriter Class
IniReaderWriter Members
Overload List