Easy-to-follow video tutorials help you learn software, creative, and business skills.Become a member

Adding public properties to a web control

From: ASP.NET Essential Training

Video: Adding public properties to a web control

In order to make your code more reusable, it's possible to declare public properties that are members of your user controls, and then set the values of these properties when you use the control in a page. For this demonstration, I'm going to use existing file HeaderWithProps.ascx. This is the same file that I was working on previously under the name Header.ascx. Notice that it has two ASP panel components, each resulting in a visual presentation. The first panel has the image, the second one the menu. In the one page that's left in this website that doesn't use the existing control, I still have the existing content, plus I also have an h1, a heading 1 that displays a heading at the top of the page. I would like to make that presentation a part of the control, but I would like to make the text within the heading 1 tags dynamic.

Adding public properties to a web control

In order to make your code more reusable, it's possible to declare public properties that are members of your user controls, and then set the values of these properties when you use the control in a page. For this demonstration, I'm going to use existing file HeaderWithProps.ascx. This is the same file that I was working on previously under the name Header.ascx. Notice that it has two ASP panel components, each resulting in a visual presentation. The first panel has the image, the second one the menu. In the one page that's left in this website that doesn't use the existing control, I still have the existing content, plus I also have an h1, a heading 1 that displays a heading at the top of the page. I would like to make that presentation a part of the control, but I would like to make the text within the heading 1 tags dynamic.

So I can change it when I use the control in a page. Here are the steps. The first part is to declare a public variable that's a member of the component. You can do this with either C# or Visual Basic. I'm going to demonstrate it in C#, but the code is much the same in VB. I'll declare variable starting off with the access modifier, public, then I'll set the data type which will be a string and then the variable name, which I'll call heading. Then optionally, you can set an initial or default value by adding the equals assignment operator and then a string that you want to use if a value is not passed in. I'll use the default string of page heading. That way if I use the control later on, and I've forgotten to set the heading value, I'll see this default value and it will remind me I need to set it.

Now to present that value to the user, I'm going to combine some very simple HTML and an ASP.NET expression that outputs the value of the variable to the page. I'll create a pair of heading 1 tags at the bottom of the page. Then I'll add an output expression, starting with less than, percent, and the equals operator and the variable heading. Notice that Visual Web Developer already knows about the property and allows me to select it from the list. So that's the completed control with a public property. I'll save those changes by pressing Ctrl+S. Next, I'll register the control globally so that it's available to the entire website.

I will go to my web.config file. This is the file where I have previously registered a control named header. I'm going to select and copy the Add element that registered that control. I'll select the line and press Ctrl+C and then clear the selection and press Ctrl+V to create a second version of the tag. I will change the tag name to HeaderWithProps to match the file in which it is defined. I'll set the source attribute to HeaderWithProps.ascx to reference the source code file. Then I'll press Ctrl+S again, saving this file.

Now, I'll return to the title's page. I'll select everything starting with the first Div tag set, continuing through the ASP panel element and this time selecting the h1 tag set as well. And I'll delete all that content because all of these content is part of the control. Now I'll put in an instance of the control. I'll start with the less than character and then start typing cu or customControls. Notice that Visual Web Developer now knows about both controls that have been registered globally in the web.config file.

Select the file HeaderWithProps. I'll add the runat="server" attribute and then I'll set the value of that heading property. I'll pass it in as a simple attribute and I'll set the heading for this particular page as Title List. That's it. I'll save the changes and I'll run the page without debugging. And now the entire heading of my website is completely reusable. The top image banner, the menu and the heading, and I'll be able to pass in a different text value into the heading for each page on which I use the control.

So that's the basic look at how to create your own user controls, how to make them configurable with public properties, how to register them globally for the whole website, and then how to use these controls on individual web pages passing values into the properties to customize their behavior and appearance.

Show transcript

This video is part of

Image for ASP.NET Essential Training
ASP.NET Essential Training

79 video lessons · 50702 viewers

David Gassner
Author

 
Expand all | Collapse all
  1. 18m 44s
    1. Welcome
      1m 42s
    2. Prerequisites
      2m 21s
    3. Using the exercise files
      1m 32s
    4. Upgrading exercise file websites for ASP.NET 4.5 (NEW)
      2m 40s
    5. What's new in ASP.NET 4 (NEW)
      3m 48s
    6. What's new in ASP.NET 4.5 (NEW)
      3m 23s
    7. What's new in this course update (NEW)
      3m 18s
  2. 33m 34s
    1. Understanding how ASP.NET works
      5m 52s
    2. Installing Microsoft Visual Web Developer 2008
      3m 43s
    3. Installing Visual Studio Express 2012 for web (NEW)
      2m 12s
    4. Hello World: Creating your first ASP.NET web site
      4m 28s
    5. Creating pages with dynamic output
      7m 39s
    6. Understanding the development web server
      4m 49s
    7. Exploring the development environment
      4m 51s
  3. 40m 2s
    1. Understanding Microsoft SQL Server
      5m 47s
    2. Installing SQL Server Express
      6m 51s
    3. Exploring SQL Server Management Studio Basic
      4m 23s
    4. Creating a new database
      8m 51s
    5. Connecting to the database in ASP.NET
      5m 35s
    6. Testing SQL queries
      3m 53s
    7. Presenting a dataset in an ASP.NET page
      4m 42s
  4. 25m 31s
    1. Understanding ASP.NET web form pages
      5m 51s
    2. Separating presentation and logic with code files
      4m 17s
    3. Adding web form controls to a page
      5m 25s
    4. Handling postback data in a web form page
      5m 50s
    5. Using data binding expressions
      4m 8s
  5. 48m 37s
    1. Creating a testing environment
      4m 40s
    2. Declaring and using a simple variable
      6m 14s
    3. Declaring and using a complex object
      6m 16s
    4. Using loops
      6m 52s
    5. Using functions
      9m 25s
    6. Using trace statements
      4m 47s
    7. Debugging with breakpoints
      5m 45s
    8. Commenting code
      4m 38s
  6. 17m 43s
    1. Creating web controls
      5m 53s
    2. Registering a user control on a web form page
      3m 25s
    3. Registering controls globally in the web.config file
      3m 53s
    4. Adding public properties to a web control
      4m 32s
  7. 19m 7s
    1. Understanding Cascading Style Sheets (CSS)
      5m 36s
    2. Attaching external CSS files
      3m 12s
    3. Defining a CSS selector
      6m 10s
    4. Using CSS class selectors in server controls
      4m 9s
  8. 30m 34s
    1. Presenting data with the GridView control
      5m 49s
    2. Controlling GridView paging and appearance
      5m 46s
    3. Editing data with the GridView control
      6m 57s
    4. Presenting data with the DataList control
      5m 42s
    5. Formatting data with binding expressions
      6m 20s
  9. 36m 46s
    1. Using the DetailsView control
      7m 33s
    2. Inserting data with the DetailsView control
      6m 36s
    3. Redirecting page requests
      9m 39s
    4. Creating an update page
      6m 20s
    5. Linking to update pages from the list page
      4m 3s
    6. Deleting database records
      2m 35s
  10. 22m 15s
    1. Customizing forms with item editing templates
      6m 7s
    2. Adding validator controls to a form
      6m 40s
    3. Controlling the validation error message display
      6m 24s
    4. Using the ValidationSummary control
      3m 4s
  11. 29m 49s
    1. Creating a query with joined tables
      8m 6s
    2. Replacing control style properties with CSS
      5m 50s
    3. Creating a CSS file for printing
      3m 14s
    4. Suppressing elements in printed web pages
      5m 47s
    5. Selecting data for a report
      6m 52s
  12. 11m 14s
    1. Understanding ViewState and managing postbacks
      4m 36s
    2. Using session variables
      6m 38s
  13. 20m 57s
    1. Turning on forms authentication
      1m 51s
    2. Creating a page to log in users
      4m 18s
    3. Creating a page to set up new users
      4m 6s
    4. Understanding the security database
      3m 27s
    5. Configuring security in the web.config file
      2m 59s
    6. Creating a page to log out users
      4m 16s
  14. 27m 56s
    1. Installing IIS on Windows XP
      6m 32s
    2. Installing ASP.NET 3.5 on Windows XP
      1m 39s
    3. Deploying a site on Windows XP
      5m 9s
    4. Installing Information Internet Services (IIS) on Windows Vista, Windows 7, and Windows 8
      1m 56s
    5. Configuring ASP.NET 3.5 on Windows Vista
      2m 15s
    6. Deploying an application on Windows Vista
      3m 29s
    7. Scripting a database for deployment
      3m 36s
    8. Exporting database scripts in SQL Server Management Studio 2012 (NEW)
      3m 20s
  15. 2m 0s
    1. Where to go from here
      2m 0s

Start learning today

Get unlimited access to all courses for just $25/month.

Become a member
Sometimes @lynda teaches me how to use a program and sometimes Lynda.com changes my life forever. @JosefShutter
@lynda lynda.com is an absolute life saver when it comes to learning todays software. Definitely recommend it! #higherlearning @Michael_Caraway
@lynda The best thing online! Your database of courses is great! To the mark and very helpful. Thanks! @ru22more
Got to create something yesterday I never thought I could do. #thanks @lynda @Ngventurella
I really do love @lynda as a learning platform. Never stop learning and developing, it’s probably our greatest gift as a species! @soundslikedavid
@lynda just subscribed to lynda.com all I can say its brilliant join now trust me @ButchSamurai
@lynda is an awesome resource. The membership is priceless if you take advantage of it. @diabetic_techie
One of the best decision I made this year. Buy a 1yr subscription to @lynda @cybercaptive
guys lynda.com (@lynda) is the best. So far I’ve learned Java, principles of OO programming, and now learning about MS project @lucasmitchell
Signed back up to @lynda dot com. I’ve missed it!! Proper geeking out right now! #timetolearn #geek @JayGodbold
Share a link to this course

What are exercise files?

Exercise files are the same files the author uses in the course. Save time by downloading the author's files instead of setting up your own files, and learn by following along with the instructor.

Can I take this course without the exercise files?

Yes! If you decide you would like the exercise files later, you can upgrade to a premium account any time.

Become a member Download sample files See plans and pricing

Please wait... please wait ...
Upgrade to get access to exercise files.

Exercise files video

How to use exercise files.

Learn by watching, listening, and doing, Exercise files are the same files the author uses in the course, so you can download them and follow along Premium memberships include access to all exercise files in the library.


Exercise files

Exercise files video

How to use exercise files.

For additional information on downloading and using exercise files, watch our instructional video or read the instructions in the FAQ .

This course includes free exercise files, so you can practice while you watch the course. To access all the exercise files in our library, become a Premium Member.

Join now Already a member? Log in

Are you sure you want to mark all the videos in this course as unwatched?

This will not affect your course history, your reports, or your certificates of completion for this course.


Mark all as unwatched Cancel

Congratulations

You have completed ASP.NET Essential Training.

Return to your organization's learning portal to continue training, or close this page.


OK
Become a member to add this course to a playlist

Join today and get unlimited access to the entire library of video courses—and create as many playlists as you like.

Get started

Already a member ?

Become a member to like this course.

Join today and get unlimited access to the entire library of video courses.

Get started

Already a member?

Exercise files

Learn by watching, listening, and doing! Exercise files are the same files the author uses in the course, so you can download them and follow along. Exercise files are available with all Premium memberships. Learn more

Get started

Already a Premium member?

Exercise files video

How to use exercise files.

Ask a question

Thanks for contacting us.
You’ll hear from our Customer Service team within 24 hours.

Please enter the text shown below:

The classic layout automatically defaults to the latest Flash Player.

To choose a different player, hold the cursor over your name at the top right of any lynda.com page and choose Site preferences from the dropdown menu.

Continue to classic layout Stay on new layout
Exercise files

Access exercise files from a button right under the course name.

Mark videos as unwatched

Remove icons showing you already watched videos if you want to start over.

Control your viewing experience

Make the video wide, narrow, full-screen, or pop the player out of the page into its own window.

Interactive transcripts

Click on text in the transcript to jump to that spot in the video. As the video plays, the relevant spot in the transcript will be highlighted.

Learn more, save more. Upgrade today!

Get our Annual Premium Membership at our best savings yet.

Upgrade to our Annual Premium Membership today and get even more value from your lynda.com subscription:

“In a way, I feel like you are rooting for me. Like you are really invested in my experience, and want me to get as much out of these courses as possible this is the best place to start on your journey to learning new material.”— Nadine H.

Thanks for signing up.

We’ll send you a confirmation email shortly.


Sign up and receive emails about lynda.com and our online training library:

Here’s our privacy policy with more details about how we handle your information.

Keep up with news, tips, and latest courses with emails from lynda.com.

Sign up and receive emails about lynda.com and our online training library:

Here’s our privacy policy with more details about how we handle your information.

   
submit Lightbox submit clicked
Terms and conditions of use

We've updated our terms and conditions (now called terms of service).Go
Review and accept our updated terms of service.