| public static WritePrivateProfileString ( string section, string key, string val, string path ) : void | ||
| section | string | The section containing the value to be written. |
| key | string | The key of the value to be written. |
| val | string | The vaue to write. |
| path | string | The absolute path of the INI file. |
| return | void | |
/// <summary>
/// Undoes the edit made to the spcified key.
/// </summary>
/// <param name="p_strSettingsFileName">The name of the settings file to unedit.</param>
/// <param name="p_strSection">The section in the Ini file to unedit.</param>
/// <param name="p_strKey">The key in the Ini file to unedit.</param>
public void UneditIni(string p_strSettingsFileName, string p_strSection, string p_strKey)
{
string strKey = InstallLog.GetModKey(Mod);
string strCurrentOwnerKey = InstallLog.GetCurrentIniEditOwnerKey(p_strSettingsFileName, p_strSection, p_strKey);
//if we didn't edit the value, then leave it alone
if (!strKey.Equals(strCurrentOwnerKey))
{
return;
}
if (!TouchedFiles.Contains(p_strSettingsFileName))
{
TouchedFiles.Add(p_strSettingsFileName);
TransactionalFileManager.Snapshot(p_strSettingsFileName);
}
//if we did edit the value, replace if with the value we overwrote.
// if we didn't overwrite a value, then just delete it.
// writing null effectively deletes the value, so if
// strPreviousValue is null, indicating we didn't overwrite a value,
// we still write it
string strPreviousValue = InstallLog.GetPreviousIniValue(p_strSettingsFileName, p_strSection, p_strKey);
IniMethods.WritePrivateProfileString(p_strSection, p_strKey, strPreviousValue, p_strSettingsFileName);
InstallLog.RemoveIniEdit(Mod, p_strSettingsFileName, p_strSection, p_strKey);
}
/// <summary>
/// Sets the specified value in the specified Ini file to the given value.
/// </summary>
/// <remarks>
/// This method writes the given value in the specified Ini value, if it is owned
/// by the mod being upgraded. If the specified Ini edit is not owned by the mod
/// being upgraded, the Ini edit is archived in the install log.
///
/// If the Ini edit was not previously installed by the mod, then the normal install
/// rules apply, including confirming overwrite if applicable.
/// </remarks>
/// <param name="p_strSettingsFileName">The name of the settings file to edit.</param>
/// <param name="p_strSection">The section in the Ini file to edit.</param>
/// <param name="p_strKey">The key in the Ini file to edit.</param>
/// <param name="p_strValue">The value to which to set the key.</param>
/// <returns><c>true</c> if the value was set; <c>false</c>
/// if the user chose not to overwrite the existing value.</returns>
public override bool EditIni(string p_strSettingsFileName, string p_strSection, string p_strKey, string p_strValue)
{
IList <IMod> lstInstallers = InstallLog.GetIniEditInstallers(p_strSettingsFileName, p_strSection, p_strKey);
if (lstInstallers.Contains(Mod, ModComparer.Filename))
{
if (!ModComparer.Filename.Equals(lstInstallers[lstInstallers.Count - 1], Mod))
{
InstallLog.ReplaceIniEdit(Mod, p_strSettingsFileName, p_strSection, p_strKey, p_strValue);
}
else
{
if (!TouchedFiles.Contains(p_strSettingsFileName))
{
TouchedFiles.Add(p_strSettingsFileName);
TransactionalFileManager.Snapshot(p_strSettingsFileName);
}
IniMethods.WritePrivateProfileString(p_strSection, p_strKey, p_strValue, p_strSettingsFileName);
}
IniEdit iniEdit = new IniEdit(p_strSettingsFileName, p_strSection, p_strKey);
OriginallyInstalledEdits.Remove(iniEdit);
return(true);
}
return(base.EditIni(p_strSettingsFileName, p_strSection, p_strKey, p_strValue));
}
/// <summary>
/// Sets the specified value in the specified Ini file to the given value.
/// </summary>
/// <param name="p_strSettingsFileName">The name of the settings file to edit.</param>
/// <param name="p_strSection">The section in the Ini file to edit.</param>
/// <param name="p_strKey">The key in the Ini file to edit.</param>
/// <param name="p_strValue">The value to which to set the key.</param>
/// <returns><c>true</c> if the value was set; <c>false</c>
/// if the user chose not to overwrite the existing value.</returns>
public virtual bool EditIni(string p_strSettingsFileName, string p_strSection, string p_strKey, string p_strValue)
{
if (m_booDontOverwriteAllIni)
{
return(false);
}
if (!TouchedFiles.Contains(p_strSettingsFileName))
{
TouchedFiles.Add(p_strSettingsFileName);
TransactionalFileManager.Snapshot(p_strSettingsFileName);
}
IMod modOldMod = InstallLog.GetCurrentIniEditOwner(p_strSettingsFileName, p_strSection, p_strKey);
string strOldValue = IniMethods.GetPrivateProfileString(p_strSection, p_strKey, null, p_strSettingsFileName);
if (!m_booOverwriteAllIni)
{
string strMessage = null;
if (modOldMod != null)
{
strMessage = String.Format("Key '{{0}}' in section '{{1}}' of {{2}} has already been overwritten by '{0}'\n" +
"Overwrite again with this mod?\n" +
"Current value '{{3}}', new value '{{4}}'", modOldMod.ModName);
}
else
{
strMessage = "The mod wants to modify key '{0}' in section '{1}' of {2}.\n" +
"Allow the change?\n" +
"Current value '{3}', new value '{4}'";
}
switch (m_dlgOverwriteConfirmationDelegate(String.Format(strMessage, p_strKey, p_strSection, p_strSettingsFileName, strOldValue, p_strValue), false, false))
{
case OverwriteResult.YesToAll:
m_booOverwriteAllIni = true;
break;
case OverwriteResult.NoToAll:
m_booDontOverwriteAllIni = true;
break;
case OverwriteResult.Yes:
break;
default:
return(false);
}
}
//if we are overwriting an original value, back it up
if ((modOldMod == null) && (strOldValue != null))
{
InstallLog.LogOriginalIniValue(p_strSettingsFileName, p_strSection, p_strKey, strOldValue);
}
IniMethods.WritePrivateProfileString(p_strSection, p_strKey, p_strValue, p_strSettingsFileName);
InstallLog.AddIniEdit(Mod, p_strSettingsFileName, p_strSection, p_strKey, p_strValue);
return(true);
}