/// <summary>
/// This method occurs when the admin clicks on the ShowActiveButton and is for showing the current active survey words in the SurveyWordListView.
/// </summary>
/// <param name="sender">Contains a reference to the control/object that raised the event.</param>
/// <param name="e">Contains the event data.</param>
protected void ShowActiveButton_Click(object sender, EventArgs e)
{
SurveyWordListView.DataSourceID = "ActiveSurveyWordODS"; // show the current active survey words on the ListView
SurveyWordListView.DataBind();
ClearSearchButton_Click(null, EventArgs.Empty); // this is to clear the search when switching from active to archived words
ShowActiveButton.Visible = false;
ShowArchivedButton.Visible = true;
}
/// <summary>
/// This method is for adding a new survey word to the database when the admin clicks on the "Add Word" button.
/// </summary>
/// <param name="sender">Contains a reference to the control/object that raised the event.</param>
/// <param name="e">Contains the event data.</param>
protected void AddWordButton_Click(object sender, EventArgs e)
{
string newWord = AddWordTextBox.Text.Trim().ToLower();
int adminID = Convert.ToInt32(Session["adminID"]); // get the adminID for the admin who is currently logged in
MessageUserControl.TryRun(() =>
{
PotentialSurveyWordController sysmgr = new PotentialSurveyWordController();
sysmgr.AddWord(newWord, adminID); // send the new survey word and adminID data to the AddWord method in the PotentialSurveyWordController
SurveyWordListView.DataBind();
AddWordTextBox.Text = ""; // set the add word text field back to blank text
}, "Success", "Successfully added the new survey word: \"" + newWord + "\""); // display a success message if the survey word was added correctly
}
/// <summary>
/// This button on click method is to clear the search field and return to a ListView with full results for the admin.
/// </summary>
/// <param name="sender">Contains a reference to the control/object that raised the event.</param>
/// <param name="e">Contains the event data.</param>
protected void ClearSearchButton_Click(object sender, EventArgs e)
{
// this check is to determine whether to clear the search for active or archived words depending on the current ODS
if (SurveyWordListView.DataSourceID == "SearchActiveSurveyWordODS")
{
SurveyWordListView.DataSourceID = "ActiveSurveyWordODS";
}
else if (SurveyWordListView.DataSourceID == "SearchArchivedSurveyWordODS")
{
SurveyWordListView.DataSourceID = "ArchivedSurveyWordODS";
}
SurveyWordListView.DataBind(); // rebind the ListView with the appropraite ODS
SearchWordTextBox.Text = ""; // clear the search word textbox
}
/// <summary>
/// This method is for when the admin clicks the "Search" button. Survey words in the ListView are returned and now showing matching the search string that was entered.
/// </summary>
/// <param name="sender">Contains a reference to the control/object that raised the event.</param>
/// <param name="e">Contains the event data.</param>
protected void SearchWordButton_Click(object sender, EventArgs e)
{
string searchWord = SearchWordTextBox.Text.Trim();
MessageUserControl.TryRun(() =>
{
Regex validWord = new Regex("^[a-zA-Z]+$");
if (searchWord == "") // check if the search is empty and display an error
{
throw new Exception("The search field cannot be empty.");
}
else if (searchWord.Length > 8) // check that the length of the search is a maximum of 8 characters and display an error
{
throw new Exception("The search field can only be a maximum of 8 characters in length.");
}
else if (!validWord.IsMatch(searchWord)) // check that there is only alphabetical letters and no spaces in the search and display an error
{
throw new Exception("Please enter only alphabetical letters and no spaces in the search field.");
}
else // now rebind the list view with the correct ODS to filter the survey words to match the searchWord
{
// this check is to determine whether to search for active or archived words depending on the current ODS
if (SurveyWordListView.DataSourceID == "ActiveSurveyWordODS")
{
SurveyWordListView.DataSourceID = "SearchActiveSurveyWordODS";
}
else if (SurveyWordListView.DataSourceID == "ArchivedSurveyWordODS")
{
SurveyWordListView.DataSourceID = "SearchArchivedSurveyWordODS";
}
SurveyWordListView.DataBind(); // rebind the ListView with the appropraite ODS
if (SurveyWordListView.Items.Any() == false) // check if any results were returned and display error message to the admin if no results were returned
{
throw new Exception("No results were found. To clear the search results and try again, click on the \"Clear Search\" Button.");
}
}
}, "Success", "Found the following results for \"" + searchWord + "\". To clear the search results, click on the \"Clear Search\" Button.");
}
