Navigation

	Home Page
	Index
	All Pages

Quick Search
Advanced Search »

Contributor Links

	Create a new Page
	Administration
	File Management
	Login/Logout
	Your Profile

Other Wiki Sections

Software

Chapter 05: Input Validation and Site Navigation - MCTS Exam 70-515

Table of Contents [Hide/Show]    Lesson 1: Input Validation       Common Properties       Validation Controls       Page Members    Lesson 2: Site Navigation       Client-Side Navigation       Cross-Page Posting       Client-Side Browser Redirect       Server-Side Transfer       SiteMap Files and the SiteMap Class    Lesson 3: Web Parts       Controls       Creation       Enabling User Arrangement and Editing       Connecting Web Parts with Static Connections       Enabling Dynamic Connections       Personalization

Lesson 1: Input Validation¶

Common Properties¶

• ControlToValidate property
• ErrorMessage property — text displayed in a ValidationSummary control when validation fails
• Text property — text displayed in the validation control when validation fails
• Display property — None, Static, or Dynamic
• ValidationGroup property
  

Validation Controls¶

• RequiredFieldValidator
• CompareValidator — compares the value of a control to another control - OR - does a data type check
• RangeValidator
• RegularExpressionValidator
• CustomValidator
• ValidationSummary
  

Page Members¶

• Validators property — collection of all validation controls on the page
• Validate method — called automatically after the page has loaded to set the IsValid property
• IsValid property — True only if ALL validation controls report valid input; False otherwise
  

Lesson 2: Site Navigation¶

Client-Side Navigation¶

• Done via hyperlinks or JavaScript code
  

Cross-Page Posting¶

• A control/form are configured to post back to a different page
• Use the Page.PreviousPage property with the FindControl method to access the controls of interest on the previous page.
  

Client-Side Browser Redirect¶

• Server code sends a Response.Redirect
  

Server-Side Transfer¶

• Server code transfers control to another page (e.g. via Server.Transfer)
  

SiteMap Files and the SiteMap Class¶

• A .sitemap file is an XML hierarchy of <siteMapNode> nodes representing the navigational structure of your website.
• The SiteMap class provides programmatic access to the sitemap.
• To display the sitemap to users, use a SiteMapDataSource with navigation control(s).
• Navigation controls include: Menu, TreeView, and SiteMapPath.
  

Lesson 3: Web Parts¶

Controls¶

Control	Description	Hosted Within
WebPartManager	invisible control required on every page that includes Web Parts	(not applicable)
WebPart	A component of pre-defined functionality that can be added to, removed from, and moved around on a web page by the developer or the user.	WebPartZone
CatalogPart	UI for managing a group of available Web Parts	CatalogZone
PageCatalogPart	similar to CatalogPart, but only groups those Web Parts that are part of a specific page; can be used, for example, to return a Web Part to a page on which it's been closed.	CatalogZone
EditorPart	allows user customizations	EditorZone
DeclarativeCatalogPart	allows developer to declare Web Parts available to a page or the entire site	(not applicable)

Creation¶

• Add a user control to a WebPartZone (inside its ZoneTemplate declaration)
• Add a standard ASP.NET control to a WebPartZone: for example a Label, which is used as a content container
• Create your own custom control derived from the WebPart class
  

Enabling User Arrangement and Editing¶

Change the display mode of the page via the WebPartManager control's DisplayMode property, which has the following settings.

Display Mode	Description
BrowseDisplayMode	Default mode in which users view content
DesignDisplayMode	Enables dragging of web parts
EditDisplayMode	Enabled dragging and editing (title, size, direction, appearance, and zone). Requires an EditorZone cotnrol, plus either an AppearanceEditorPart and LayoutEditorPart control, on the page
CatalogDisplayMode	Enabled adding of web parts. Requires a CatalogZone control on the page
ConnectDisplayMode	Enables connecting controls via a ConnectionZone control on the page

Connecting Web Parts with Static Connections¶

1. Create a provider web part (either a user control, or derived from WebPart class)

2. Create a public method in the provider web part decorated with the ConnectionProvider attribute and which returns the value the consumer web part will receive, like the example below.

public partial class Provider : System.Web.UI.UserControl
{
  string _textBoxValue = "";
  [ConnectionProvider("TextBox provider", "GetTextBoxValue")]
  string GetTextBoxValue()
  {
    return _textBoxValue;
  }
  protected void Button1_Click(object sender, EventArgs e)
  {
    _textBoxValue = TextBoxProvider.Text;
  }
}

3. Create a consumer web part (either a user control, or derived from WebPart class)

4. Create a public method decorated with the ConnectionConsumer attribute, and that accepts the same data type that the provider's ConnectionProvider method returns, like the following example.

public partial class Consumer : System.Web.UI.UserControl
{
  [ConnectionConsumer("TextBox consumer", "ShowTextBoxValue")]
  void ShowTextBoxValue(string textBoxValue)
  {
    LabelConsumer.Text = textBoxValue;
  }
}

5. Create a web page with a WebPartManager and at least one WebPartZone container.

6. Add the provider and consumer web parts to the WebPartZone container(s).

7. Add the asp:WebPartConnection to the StaticConnections section of your WebPartManager control. The WebPartConnection should have the following properties set. Note that you should have one WebPartConnection control for each pair of connected controls.

Property	Description
ID	Unique identifier
ProviderID	ID of the provider control
ProviderConnectionPointID	Name of the provider method
ConsumerID	ID of the consumer control
ConsumerConnectionPointID	Name of the consumer method

WebPartConnection Example

<asp:WebPartManager ID="WebPartManager1" runat="server">
  <StaticConnections>
    <asp:webPartConnection
      ID="conn1"
      ProviderID="Provider1"
      ProviderConnectionPointID="GetTextBoxValue"
      ConsumerID="Consumer1"
      ConsumerConnectionPointID="ShowTextBoxValue" 
      />
  </StaticConnections>
</asp:WebPartManager>

Enabling Dynamic Connections¶

1. Create a page with a provider and consumer connection, as in the previous section.

2. Optionally create a static connection (as in the previous section), which will act as the default connection.

3. Add a ConnectionsZone control to the web page.

4. Add a control to enable the user to enter connect mode.

Personalization¶

• Personalization of Web Parts is done via the ASPNETDB SQL Server database.
  

• To store custom personalization data, define a public property on the control and decorate it with the Personalizable attribute. This will store the personalization data for each user.
  

• To enable shared personalization, which will allow personalization changes made by one user to be viewed by others, make the
  following change to your web.config file: within /system.web/authorization add a node for lt;allow verbs="enterSharedScope" users="SomeUser" roles="admin" />
  

• To disable personalization for a page, set the WebPartManager.Personalization.Enabled attribute to false, like this.
  

<asp:WebPartManager runat="server">
  <Personalization Enabled="False" />
</asp:WebPartManager>