/// <summary> /// Writes a configuration using the specified encryption engine to the specified path /// </summary> /// <param name="encryptionEngine">The encryption engine to use while writing the configuration, null if no encryption is desired</param> /// <param name="configuration">The confiruration to write</param> /// <param name="path">The path to write it to</param> /// <returns></returns> public static bool WriteConfiguration(FileEncryptionEngine encryptionEngine, XmlConfiguration configuration, string path) { Stream stream = null; ConfigurationEngine.ResetLastException(); try { if (configuration != null) { if (configuration.HasUnpersistedChanges()) { configuration.AcceptChanges(); stream = (encryptionEngine != null ? encryptionEngine.CreateEncryptorStream(path) : new FileStream(path, FileMode.Create, FileAccess.Write, FileShare.None)); XmlConfigurationWriter writer = new XmlConfigurationWriter(); writer.Write(configuration, stream, false); configuration.SetHasUnpersistedChanges(false); } return(true); } } catch (System.Exception systemException) { System.Diagnostics.Trace.WriteLine(systemException); _lastException = systemException; } finally { try { if (stream != null) { stream.Close(); } } catch { } } return(false); }
/// <summary> /// Writes a configuration using the specified encryption engine to the specified path /// </summary> /// <param name="encryptionEngine">The encryption engine to use while writing the configuration, null if no encryption is desired</param> /// <param name="configuration">The confiruration to write</param> /// <param name="path">The path to write it to</param> /// <returns></returns> public static bool WriteConfiguration(FileEncryptionEngine encryptionEngine, XmlConfiguration configuration, string path) { Stream stream = null; ConfigurationEngine.ResetLastException(); try { if (configuration != null) { if (configuration.HasUnpersistedChanges()) { configuration.AcceptChanges(); stream = (encryptionEngine != null ? encryptionEngine.CreateEncryptorStream(path) : new FileStream(path, FileMode.Create, FileAccess.Write, FileShare.None)); XmlConfigurationWriter writer = new XmlConfigurationWriter(); writer.Write(configuration, stream, false); configuration.SetHasUnpersistedChanges(false); } return true; } } catch(System.Exception systemException) { System.Diagnostics.Trace.WriteLine(systemException); _lastException = systemException; } finally { try { if (stream != null) stream.Close(); } catch { } } return false; }
/// <summary> /// Reads or creates an XmlConfiguration from a name, path, and/or a handler function to provide structure to a new configuration. /// </summary> /// <param name="name">The name that will be given to the configuration</param> /// <param name="path">The path to the file where the configuration is stored</param> /// <param name="configuration">The configuration that will be returned after creation or reading has finished</param> /// <param name="encryptionEngine">The encryption engine to use when reading the file</param> /// <param name="handler">The event handler to call if structure is needed for a new configuration</param> /// <returns>True if a configuration was created or read</returns> public static bool ReadOrCreateConfiguration( bool verbose, string name, string path, out XmlConfiguration configuration, FileEncryptionEngine encryptionEngine, XmlConfigurationEventHandler handler) { configuration = null; Trace.WriteLineIf(verbose, "'Configuration Engine': Checking to see if the path '" + path + "' exists."); /// if the file exists, we need to try and read it if (System.IO.File.Exists(path)) { Trace.WriteLineIf(verbose, "'Configuration Engine': The path '" + path + "' exists."); try { /// but first see if we have permissions to read it using(SecurityAccessRight right = new SecurityAccessRight(path)) { Trace.WriteLineIf(verbose, "'Configuration Engine': Checking to see if the path '" + path + "' has read access."); /// if we don't have rights to the file if (!right.AssertReadAccess()) { Trace.WriteLineIf(verbose, "'Configuration Engine': The path '" + path + "' does not have write access."); Trace.WriteLineIf(verbose, "'Configuration Engine': Prompting for user intervention for the path '" + path + "'."); /// prompt to see what we should do about this DialogResult result = ExceptionEngine.DisplayException( null, "Read access denied - Unable to read from file", MessageBoxIcon.Error, MessageBoxButtons.AbortRetryIgnore, null, "Read access has been denied for the '" + name + "'.", "Ignoring this exception will result in a default set of options to be loaded in the '" + name + "' for this application instance.", "If the file has write access enabled, it will be overwritten with the loaded options when the application exits.", "WARNING: Aborting this operation will exit the application!"); switch(result) { case DialogResult.Abort: Trace.WriteLineIf(verbose, "'Configuration Engine': Aborting attempt to read from the path '" + path + "' because of user intervention."); return false; case DialogResult.Retry: Trace.WriteLineIf(verbose, "'Configuration Engine': Retrying attempt to read from the path '" + path + "' because of user intervention."); return ConfigurationEngine.ReadOrCreateConfiguration(verbose, name, path, out configuration, encryptionEngine, handler); case DialogResult.Ignore: Trace.WriteLineIf(verbose, "'Configuration Engine': Ignoring attempt to read from the path '" + path + "' because of user intervention."); return true; //break; }; } else { Trace.WriteLineIf(verbose, "'Configuration Engine': The path '" + path + "' has read access, preparing to read the configuration."); /// rights to read the file /// ask the configuration engine to read our configuration file for us into our configuration if (!ConfigurationEngine.ReadConfiguration(encryptionEngine, out configuration, path)) { Trace.WriteLineIf(verbose, "'Configuration Engine': Failed to read the configuration, throwing last exception from the ConfigurationEngine."); throw ConfigurationEngine.LastException; } /// let the configuration know where it lives // configuration.Path = path; /// ensure that the configuration has no changes visible if (configuration != null) { Trace.WriteLineIf(verbose, "'Configuration Engine': Succeeded in reading the configuration, accepting changes ."); configuration.AcceptChanges(); } return true; } } } catch(System.Exception systemException) { Trace.WriteLineIf(verbose, "'Configuration Engine': An unexpected exception was encountered while reading the configuration, dumping exception."); System.Diagnostics.Trace.WriteLine(systemException); Trace.WriteLineIf(verbose, "'Configuration Engine': Prompting for user intervention for the path '" + path + "'."); /// failed for some reason reading the file /// prompt to see what we should do about this DialogResult result = ExceptionEngine.DisplayException( null, "Exception encountered - Unable to read from file", MessageBoxIcon.Error, MessageBoxButtons.AbortRetryIgnore, systemException, "An exception was encountered while trying to read '" + name + "'.", "Ignoring this exception will result in a default set of options to be loaded in the '" + name + "' for this application instance.", "If the file has write access enabled, it will be overwritten with the loaded options when the application exits.", "WARNING: Aborting this operation will exit the application!"); switch(result) { case DialogResult.Abort: Trace.WriteLineIf(verbose, "'Configuration Engine': Aborting attempt to read from the path '" + path + "' because of user intervention."); return false; case DialogResult.Retry: Trace.WriteLineIf(verbose, "'Configuration Engine': Retrying attempt to read from the path '" + path + "' because of user intervention."); return ConfigurationEngine.ReadOrCreateConfiguration(verbose, name, path, out configuration, encryptionEngine, handler); case DialogResult.Ignore: Trace.WriteLineIf(verbose, "'Configuration Engine': Ignoring attempt to read from the path '" + path + "' because of user intervention."); break; }; } } else { Trace.WriteLineIf(verbose, "'Configuration Engine': The path '" + path + "' does not exist."); } /// if for some reason the configuration hasn't been loaded yet if (configuration == null) { Trace.WriteLineIf(verbose, "'Configuration Engine': Creating new configuration named '" + name + "'."); configuration = new XmlConfiguration(); configuration.ElementName = name; Trace.WriteLineIf(verbose, "'Configuration Engine': Checking for formatting callback for the configuration named '" + name + "'."); if (handler != null) { Trace.WriteLineIf(verbose, "'Configuration Engine': Formatting callback found for the configuration named '" + name + "', calling formatting callback to apply structure to the configuration."); try { XmlConfigurationEventArgs e = new XmlConfigurationEventArgs(configuration, XmlConfigurationElementActions.None); handler(null, e); configuration = e.Element; } catch(System.Exception systemException) { Trace.WriteLineIf(verbose, "'Configuration Engine': An unexpected exception was encountered while reading the configuration named '" + name + "', dumping exception."); System.Diagnostics.Trace.WriteLine(systemException); } } } Trace.WriteLineIf(verbose, "'Configuration Engine': Setting the path for the configuration named '" + name + "' and accepting changes to the configuration."); /// let the configuration know where it lives configuration.Path = path; /// ensure that the configuration has no changes visible configuration.AcceptChanges(); return true; }
/// <summary> /// Writes a configuration to a path using the specified encryption engine. Takes windows security into account and checks for write access before trying to write to the path. /// </summary> /// <param name="path"></param> /// <param name="configuration"></param> /// <param name="encryptionEngine"></param> /// <returns></returns> public static bool WriteConfiguration(bool verbose, string path, XmlConfiguration configuration, FileEncryptionEngine encryptionEngine) { try { Trace.WriteLineIf(verbose, "'Configuration Engine': Checking to see if the path '" + path + "' exists."); /// if the file exists, we need to try and read it if (System.IO.File.Exists(path)) { Trace.WriteLineIf(verbose, "'Configuration Engine': The path '" + path + "' exists."); /// but first see if we have permissions to read it using(SecurityAccessRight right = new SecurityAccessRight(path)) { Trace.WriteLineIf(verbose, "'Configuration Engine': Checking to see if the path '" + path + "' has write access."); /// if we don't have rights to the file if (!right.AssertWriteAccess()) { Trace.WriteLineIf(verbose, "'Configuration Engine': The path '" + path + "' does not have write access."); Trace.WriteLineIf(verbose, "'Configuration Engine': Prompting for user intervention for the path '" + path + "'."); if (verbose) { /// prompt to see what we should do about this DialogResult result = ExceptionEngine.DisplayException( null, "Write access denied - Unable to write to file", MessageBoxIcon.Error, MessageBoxButtons.AbortRetryIgnore, null, "Write access has been denied for the file '" + path + "'.", "Ignoring this exception may result in a loss of data if any options in this file were changed."); switch(result) { case DialogResult.Abort: Trace.WriteLineIf(verbose, "'Configuration Engine': Aborting attempt to write to the path '" + path + "' because of user intervention."); return false; case DialogResult.Retry: Trace.WriteLineIf(verbose, "'Configuration Engine': Retrying attempt to write to the path '" + path + "' because of user intervention."); return ConfigurationEngine.WriteConfiguration(verbose, path, configuration, encryptionEngine); case DialogResult.Ignore: Trace.WriteLineIf(verbose, "'Configuration Engine': Ignoring attempt to write to the path '" + path + "' because of user intervention."); return true; //break; }; } else { /// it failed, but we're not in verbose mode so who cares? return true; } } else { Trace.WriteLineIf(verbose, "'Configuration Engine': The path '" + path + "' has write access, preparing to write the configuration."); /// rights to write to the file /// ask the configuration engine to write our configuration file for us into our configuration if (!ConfigurationEngine.WriteConfiguration(encryptionEngine, configuration, path)) { Trace.WriteLineIf(verbose, "'Configuration Engine': Failed to write the configuration, throwing last exception from the ConfigurationEngine."); throw ConfigurationEngine.LastException; } /// ensure that the configuration has no changes visible if (configuration != null) { Trace.WriteLineIf(verbose, "'Configuration Engine': Succeeded in writing the configuration, accepting changes ."); configuration.AcceptChanges(); } return true; } } } else { Trace.WriteLineIf(verbose, "'Configuration Engine': The path '" + path + "' does not exist, preparing to write the configuration for the first time."); /// ask the configuration engine to write our configuration file for us into our configuration if (!ConfigurationEngine.WriteConfiguration(encryptionEngine, configuration, path)) { Trace.WriteLineIf(verbose, "'Configuration Engine': Failed to write the configuration, throwing last exception from the ConfigurationEngine."); throw ConfigurationEngine.LastException; } /// ensure that the configuration has no changes visible if (configuration != null) { Trace.WriteLineIf(verbose, "'Configuration Engine': Succeeded in writing the configuration, accepting changes ."); configuration.AcceptChanges(); } return true; } } catch(System.Exception systemException) { Trace.WriteLineIf(verbose, "'Configuration Engine': An unexpected exception was encountered while writing the configuration, dumping exception."); System.Diagnostics.Trace.WriteLine(systemException); Trace.WriteLineIf(verbose, "'Configuration Engine': Prompting for user intervention for the path '" + path + "'."); if (verbose) { /// failed for some reason writing the file /// prompt to see what we should do about this DialogResult result = ExceptionEngine.DisplayException( null, "Exception encountered - Unable to write to file", MessageBoxIcon.Error, MessageBoxButtons.AbortRetryIgnore, systemException, "An exception was encountered while trying to write to the file '" + path + "'.", "Ignoring this exception may result in a loss of data if any options in this file were changed"); switch(result) { case DialogResult.Abort: Trace.WriteLineIf(verbose, "'Configuration Engine': Aborting attempt to write to the path '" + path + "' because of user intervention."); return false; case DialogResult.Retry: Trace.WriteLineIf(verbose, "'Configuration Engine': Retrying attempt to write to the path '" + path + "' because of user intervention."); return ConfigurationEngine.WriteConfiguration(verbose, path, configuration, encryptionEngine); case DialogResult.Ignore: Trace.WriteLineIf(verbose, "'Configuration Engine': Ignoring attempt to write to the path '" + path + "' because of user intervention."); return true; }; } } return true; }
/// <summary> /// Reads or creates an XmlConfiguration from a name, path, and/or a handler function to provide structure to a new configuration. /// </summary> /// <param name="name">The name that will be given to the configuration</param> /// <param name="path">The path to the file where the configuration is stored</param> /// <param name="configuration">The configuration that will be returned after creation or reading has finished</param> /// <param name="encryptionEngine">The encryption engine to use when reading the file</param> /// <param name="handler">The event handler to call if structure is needed for a new configuration</param> /// <returns>True if a configuration was created or read</returns> public static bool ReadOrCreateConfiguration( bool verbose, string name, string path, out XmlConfiguration configuration, FileEncryptionEngine encryptionEngine, XmlConfigurationEventHandler handler) { configuration = null; Trace.WriteLineIf(verbose, "'Configuration Engine': Checking to see if the path '" + path + "' exists."); /// if the file exists, we need to try and read it if (System.IO.File.Exists(path)) { Trace.WriteLineIf(verbose, "'Configuration Engine': The path '" + path + "' exists."); try { /// but first see if we have permissions to read it using (SecurityAccessRight right = new SecurityAccessRight(path)) { Trace.WriteLineIf(verbose, "'Configuration Engine': Checking to see if the path '" + path + "' has read access."); /// if we don't have rights to the file if (!right.AssertReadAccess()) { Trace.WriteLineIf(verbose, "'Configuration Engine': The path '" + path + "' does not have write access."); Trace.WriteLineIf(verbose, "'Configuration Engine': Prompting for user intervention for the path '" + path + "'."); /// prompt to see what we should do about this DialogResult result = ExceptionEngine.DisplayException( null, "Read access denied - Unable to read from file", MessageBoxIcon.Error, MessageBoxButtons.AbortRetryIgnore, null, "Read access has been denied for the '" + name + "'.", "Ignoring this exception will result in a default set of options to be loaded in the '" + name + "' for this application instance.", "If the file has write access enabled, it will be overwritten with the loaded options when the application exits.", "WARNING: Aborting this operation will exit the application!"); switch (result) { case DialogResult.Abort: Trace.WriteLineIf(verbose, "'Configuration Engine': Aborting attempt to read from the path '" + path + "' because of user intervention."); return(false); case DialogResult.Retry: Trace.WriteLineIf(verbose, "'Configuration Engine': Retrying attempt to read from the path '" + path + "' because of user intervention."); return(ConfigurationEngine.ReadOrCreateConfiguration(verbose, name, path, out configuration, encryptionEngine, handler)); case DialogResult.Ignore: Trace.WriteLineIf(verbose, "'Configuration Engine': Ignoring attempt to read from the path '" + path + "' because of user intervention."); return(true); //break; } ; } else { Trace.WriteLineIf(verbose, "'Configuration Engine': The path '" + path + "' has read access, preparing to read the configuration."); /// rights to read the file /// ask the configuration engine to read our configuration file for us into our configuration if (!ConfigurationEngine.ReadConfiguration(encryptionEngine, out configuration, path)) { Trace.WriteLineIf(verbose, "'Configuration Engine': Failed to read the configuration, throwing last exception from the ConfigurationEngine."); throw ConfigurationEngine.LastException; } /// let the configuration know where it lives // configuration.Path = path; /// ensure that the configuration has no changes visible if (configuration != null) { Trace.WriteLineIf(verbose, "'Configuration Engine': Succeeded in reading the configuration, accepting changes ."); configuration.AcceptChanges(); } return(true); } } } catch (System.Exception systemException) { Trace.WriteLineIf(verbose, "'Configuration Engine': An unexpected exception was encountered while reading the configuration, dumping exception."); System.Diagnostics.Trace.WriteLine(systemException); Trace.WriteLineIf(verbose, "'Configuration Engine': Prompting for user intervention for the path '" + path + "'."); /// failed for some reason reading the file /// prompt to see what we should do about this DialogResult result = ExceptionEngine.DisplayException( null, "Exception encountered - Unable to read from file", MessageBoxIcon.Error, MessageBoxButtons.AbortRetryIgnore, systemException, "An exception was encountered while trying to read '" + name + "'.", "Ignoring this exception will result in a default set of options to be loaded in the '" + name + "' for this application instance.", "If the file has write access enabled, it will be overwritten with the loaded options when the application exits.", "WARNING: Aborting this operation will exit the application!"); switch (result) { case DialogResult.Abort: Trace.WriteLineIf(verbose, "'Configuration Engine': Aborting attempt to read from the path '" + path + "' because of user intervention."); return(false); case DialogResult.Retry: Trace.WriteLineIf(verbose, "'Configuration Engine': Retrying attempt to read from the path '" + path + "' because of user intervention."); return(ConfigurationEngine.ReadOrCreateConfiguration(verbose, name, path, out configuration, encryptionEngine, handler)); case DialogResult.Ignore: Trace.WriteLineIf(verbose, "'Configuration Engine': Ignoring attempt to read from the path '" + path + "' because of user intervention."); break; } ; } } else { Trace.WriteLineIf(verbose, "'Configuration Engine': The path '" + path + "' does not exist."); } /// if for some reason the configuration hasn't been loaded yet if (configuration == null) { Trace.WriteLineIf(verbose, "'Configuration Engine': Creating new configuration named '" + name + "'."); configuration = new XmlConfiguration(); configuration.ElementName = name; Trace.WriteLineIf(verbose, "'Configuration Engine': Checking for formatting callback for the configuration named '" + name + "'."); if (handler != null) { Trace.WriteLineIf(verbose, "'Configuration Engine': Formatting callback found for the configuration named '" + name + "', calling formatting callback to apply structure to the configuration."); try { XmlConfigurationEventArgs e = new XmlConfigurationEventArgs(configuration, XmlConfigurationElementActions.None); handler(null, e); configuration = e.Element; } catch (System.Exception systemException) { Trace.WriteLineIf(verbose, "'Configuration Engine': An unexpected exception was encountered while reading the configuration named '" + name + "', dumping exception."); System.Diagnostics.Trace.WriteLine(systemException); } } } Trace.WriteLineIf(verbose, "'Configuration Engine': Setting the path for the configuration named '" + name + "' and accepting changes to the configuration."); /// let the configuration know where it lives configuration.Path = path; /// ensure that the configuration has no changes visible configuration.AcceptChanges(); return(true); }
/// <summary> /// Writes a configuration to a path using the specified encryption engine. Takes windows security into account and checks for write access before trying to write to the path. /// </summary> /// <param name="path"></param> /// <param name="configuration"></param> /// <param name="encryptionEngine"></param> /// <returns></returns> public static bool WriteConfiguration(bool verbose, string path, XmlConfiguration configuration, FileEncryptionEngine encryptionEngine) { try { Trace.WriteLineIf(verbose, "'Configuration Engine': Checking to see if the path '" + path + "' exists."); /// if the file exists, we need to try and read it if (System.IO.File.Exists(path)) { Trace.WriteLineIf(verbose, "'Configuration Engine': The path '" + path + "' exists."); /// but first see if we have permissions to read it using (SecurityAccessRight right = new SecurityAccessRight(path)) { Trace.WriteLineIf(verbose, "'Configuration Engine': Checking to see if the path '" + path + "' has write access."); /// if we don't have rights to the file if (!right.AssertWriteAccess()) { Trace.WriteLineIf(verbose, "'Configuration Engine': The path '" + path + "' does not have write access."); Trace.WriteLineIf(verbose, "'Configuration Engine': Prompting for user intervention for the path '" + path + "'."); if (verbose) { /// prompt to see what we should do about this DialogResult result = ExceptionEngine.DisplayException( null, "Write access denied - Unable to write to file", MessageBoxIcon.Error, MessageBoxButtons.AbortRetryIgnore, null, "Write access has been denied for the file '" + path + "'.", "Ignoring this exception may result in a loss of data if any options in this file were changed."); switch (result) { case DialogResult.Abort: Trace.WriteLineIf(verbose, "'Configuration Engine': Aborting attempt to write to the path '" + path + "' because of user intervention."); return(false); case DialogResult.Retry: Trace.WriteLineIf(verbose, "'Configuration Engine': Retrying attempt to write to the path '" + path + "' because of user intervention."); return(ConfigurationEngine.WriteConfiguration(verbose, path, configuration, encryptionEngine)); case DialogResult.Ignore: Trace.WriteLineIf(verbose, "'Configuration Engine': Ignoring attempt to write to the path '" + path + "' because of user intervention."); return(true); //break; } ; } else { /// it failed, but we're not in verbose mode so who cares? return(true); } } else { Trace.WriteLineIf(verbose, "'Configuration Engine': The path '" + path + "' has write access, preparing to write the configuration."); /// rights to write to the file /// ask the configuration engine to write our configuration file for us into our configuration if (!ConfigurationEngine.WriteConfiguration(encryptionEngine, configuration, path)) { Trace.WriteLineIf(verbose, "'Configuration Engine': Failed to write the configuration, throwing last exception from the ConfigurationEngine."); throw ConfigurationEngine.LastException; } /// ensure that the configuration has no changes visible if (configuration != null) { Trace.WriteLineIf(verbose, "'Configuration Engine': Succeeded in writing the configuration, accepting changes ."); configuration.AcceptChanges(); } return(true); } } } else { Trace.WriteLineIf(verbose, "'Configuration Engine': The path '" + path + "' does not exist, preparing to write the configuration for the first time."); /// ask the configuration engine to write our configuration file for us into our configuration if (!ConfigurationEngine.WriteConfiguration(encryptionEngine, configuration, path)) { Trace.WriteLineIf(verbose, "'Configuration Engine': Failed to write the configuration, throwing last exception from the ConfigurationEngine."); throw ConfigurationEngine.LastException; } /// ensure that the configuration has no changes visible if (configuration != null) { Trace.WriteLineIf(verbose, "'Configuration Engine': Succeeded in writing the configuration, accepting changes ."); configuration.AcceptChanges(); } return(true); } } catch (System.Exception systemException) { Trace.WriteLineIf(verbose, "'Configuration Engine': An unexpected exception was encountered while writing the configuration, dumping exception."); System.Diagnostics.Trace.WriteLine(systemException); Trace.WriteLineIf(verbose, "'Configuration Engine': Prompting for user intervention for the path '" + path + "'."); if (verbose) { /// failed for some reason writing the file /// prompt to see what we should do about this DialogResult result = ExceptionEngine.DisplayException( null, "Exception encountered - Unable to write to file", MessageBoxIcon.Error, MessageBoxButtons.AbortRetryIgnore, systemException, "An exception was encountered while trying to write to the file '" + path + "'.", "Ignoring this exception may result in a loss of data if any options in this file were changed"); switch (result) { case DialogResult.Abort: Trace.WriteLineIf(verbose, "'Configuration Engine': Aborting attempt to write to the path '" + path + "' because of user intervention."); return(false); case DialogResult.Retry: Trace.WriteLineIf(verbose, "'Configuration Engine': Retrying attempt to write to the path '" + path + "' because of user intervention."); return(ConfigurationEngine.WriteConfiguration(verbose, path, configuration, encryptionEngine)); case DialogResult.Ignore: Trace.WriteLineIf(verbose, "'Configuration Engine': Ignoring attempt to write to the path '" + path + "' because of user intervention."); return(true); } ; } } return(true); }