C# Class AutoQuery.Systems.Profile

Retrieves a copy of itself.

This method needs to be implemented by derived classes.

Retrieves a copy of itself and makes it read-only.

This method serves as a convenient way to pass a read-only copy of the profile to methods that are not allowed to modify it.

Retrieves a DataSet object containing every section, entry, and value in the profile.

The returned DataSet will be named using the Name property. It will contain one table for each section, and each entry will be represented by a column inside the table. Each table will contain only one row where the values will stored corresponding to each column (entry).

This method serves as a convenient way to extract the profile's data to this generic medium known as the DataSet. This allows it to be moved to many different places, including a different type of profile object (eg., INI to XML conversion).

This method calls GetSectionNames, GetEntryNames, and GetValue of the derived class, so check the documentation to see what other exceptions may be raised.

Retrieves the names of all the entries inside a section.

This method needs to be implemented by derived classes. Check the documentation to see what other exceptions derived versions may raise.

Retrieves the names of all the sections.

This method needs to be implemented by derived classes. Check the documentation to see what exceptions derived versions may raise.

Retrieves the bool value of an entry inside a section, or a default value if the entry does not exist.

Note: Boolean values are stored as "True" or "False".

This method calls GetValue(section, entry) of the derived class, so check its documentation to see what other exceptions may be raised.

Retrieves the double value of an entry inside a section, or a default value if the entry does not exist.

This method calls GetValue(section, entry) of the derived class, so check its documentation to see what other exceptions may be raised.

Retrieves the integer value of an entry inside a section, or a default value if the entry does not exist.

This method calls GetValue(section, entry) of the derived class, so check its documentation to see what other exceptions may be raised.

Retrieves the value of an entry inside a section.

This method needs to be implemented by derived classes. Check the documentation to see what other exceptions derived versions may raise.

Retrieves the string value of an entry inside a section, or a default value if the entry does not exist.

This method calls GetValue(section, entry) of the derived class, so check its documentation to see what other exceptions may be raised.

Determines if an entry exists inside a section.

This method calls GetEntryNames of the derived class, so check its documentation to see what other exceptions may be raised.

Determines if a section exists.

Removes an entry from a section.

This method needs to be implemented by derived classes. Check the documentation to see what other exceptions derived versions may raise. See IProfile.RemoveEntry for additional remarks.

Removes a section.

This method needs to be implemented by derived classes. Check the documentation to see what other exceptions derived versions may raise. See IProfile.RemoveSection for additional remarks.

Writes the data of every table from a DataSet into this profile.

Each table in the DataSet represents a section of the profile. Each column of each table represents an entry. And for each column, the corresponding value of the first row is the value to be passed to SetValue. Note that only the first row is imported; additional rows are ignored.

This method serves as a convenient way to take any data inside a generic DataSet and write it to any of the available profiles.

This method calls SetValue of the derived class, so check its documentation to see what other exceptions may be raised.

Sets the value for an entry inside a section.

This method needs to be implemented by derived classes. Check the documentation to see what other exceptions derived versions may raise. See IProfile.SetValue for additional remarks.

Raises the Changed event.

This method should be invoked after a change to the profile has been made so that the Changed event is raised, giving a chance to the handlers to be notified of the change.

Raises the Changing event.

This method should be invoked prior to making a change to the profile so that the Changing event is raised, giving a chance to the handlers to prevent the change from happening (by setting e.Cancel to true). This method calls each individual handler associated with the Changing event and checks the resulting e.Cancel flag. If it's true, it stops and does not call of any remaining handlers since the change needs to be prevented anyway.

Initializes a new instance of the Profile class by setting the Name to DefaultName.

Initializes a new instance of the Profile class based on another Profile object.

Initializes a new instance of the Profile class by setting the Name to a value.

Raises either the Changing or Changed event.

This method may be used by derived classes as a convenient alternative to calling OnChanging and OnChanged. For example, a typical call to OnChanging would require four lines of code, which this method reduces to two.

Verifies the given entry name is not null and trims it.

This method may be used by derived classes to make sure that a valid entry name has been passed, and to make any necessary adjustments to it before passing it to the corresponding APIs.

Verifies the given section name is not null and trims it.

This method may be used by derived classes to make sure that a valid section name has been passed, and to make any necessary adjustments to it before passing it to the corresponding APIs.

Verifies the Name property is not empty or null.

This method may be used by derived classes to make sure that the APIs are working with a valid Name (file name)

Verifies the ReadOnly property is not true.

This method may be used by derived classes as a convenient way to validate that modifications to the profile can be made.