John.Wiley.and.Sons.Beginning.ASP.dot.NET.1.1.with.VB.dot.NET.2003.eBook DDU
Beginning ASP.NET 1.1
with VB.NET 2003
Chris Ullman
John Kauffman
Chris Hart
Dave Sussman
Wiley Publishing, Inc.
Beginning ASP.NET 1.1
with VB.NET 2003
Beginning ASP.NET 1.1
with VB.NET 2003
Chris Ullman
John Kauffman
Chris Hart
Dave Sussman
Wiley Publishing, Inc.
Beginning ASP.NET 1.1 with VB.NET 2003
Published by
Wiley Publishing, Inc.
10475 Crosspoint Boulevard
Indianapolis, IN 46256
www.wiley.com
Copyright © 2004 by Wiley Publishing, Inc., Indianapolis, Indiana
Published simultaneously in Canada
Library of Congress Card Number: 2003114198
ISBN: 0-7645-5707-6
Manufactured in the United States of America
10 9 8 7 6 5 4 3 2 1
1B/RW/RS/QU
No part of this publication may be reproduced, stored in a retrieval system or transmitted in any form or by
any means, electronic, mechanical, photocopying, recording, scanning or otherwise, except as permitted
under Sections 107 or 108 of the 1976 United States Copyright Act, without either the prior written permission of the Publisher, or authorization through payment of the appropriate per-copy fee to the Copyright
Clearance Center, 222 Rosewood Drive, Danvers, MA 01923, (978) 750-8400, fax (978) 646-8700. Requests to
the Publisher for permission should be addressed to the Legal Department, Wiley Publishing, Inc., 10475
Crosspoint Blvd., Indianapolis, IN 46256, (317) 572-3447, fax (317) 572-4447, Email:
[email protected].
LIMIT OF LIABILITY/DISCLAIMER OF WARRANTY: WHILE THE PUBLISHER AND AUTHOR
HAVE USED THEIR BEST EFFORTS IN PREPARING THIS BOOK, THEY MAKE NO REPRESENTATIONS OR WARRANTIES WITH RESPECT TO THE ACCURACY OR COMPLETENESS OF THE CONTENTS OF THIS BOOK AND SPECIFICALLY DISCLAIM ANY IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. NO WARRANTY MAY BE CREATED OR EXTENDED BY SALES REPRESENTATIVES OR WRITTEN SALES MATERIALS. THE
ADVICE AND STRATEGIES CONTAINED HEREIN MAY NOT BE SUITABLE FOR YOUR SITUATION.
YOU SHOULD CONSULT WITH A PROFESSIONAL WHERE APPROPRIATE. NEITHER THE PUBLISHER NOR AUTHOR SHALL BE LIABLE FOR ANY LOSS OF PROFIT OR ANY OTHER COMMERCIAL DAMAGES, INCLUDING BUT NOT LIMITED TO SPECIAL, INCIDENTAL, CONSEQUENTIAL,
OR OTHER DAMAGES.
For general information on our other products and services or to obtain technical support, please contact our
Customer Care Department within the U.S. at (800) 762-2974, outside the U.S. at (317) 572-3993 or fax (317)
572-4002.
Wiley also publishes its books in a variety of electronic formats. Some content that appears in print may not
be available in electronic books.
Trademarks: Wiley, the Wiley Publishing logo, Wrox, the Wrox logo, Programmer to Programmer, and
related trade dress are trademarks or registered trademarks of John Wiley & Sons, Inc. and/or its affiliates in
the United States and other countries, and may not be used without written permission. All other
trademarks are the property of their respective owners. Wiley Publishing, Inc. is not associated with any
product or vendor mentioned in this book.
About the Authors
Chris Ullman
Chris Ullman is a freelance web developer and technical author who has spent many years stewing in
ASP/ASP.NET, like a teabag left too long in the pot. Coming from a Computer Science background, he
started initially as a UNIX/Linux guru, who gravitated towards MS technologies during the summer of
ASP (1997). He cut his teeth on Wrox Press ASP guides, and since then he has written over 20 books,
most notably as lead author for Wrox's bestselling Beginning ASP/ASP.NET series, and has contributed
chapters to books on PHP, ColdFusion, JavaScript, Web Services, C#, XML and other Internet-related
technologies too esoteric to mention, now swallowed up in the quicksands of the dot.com boom.
Quitting Wrox as a full-time employee in August 2001, he branched out into VB6 programming and
ASP development maintaining a multitude of sites from http://www.cuasp.co.co.uk, his "work" site, to
http://www.atomicwise.com, a selection of his writings on music and art. He now divides his time
between being a human punchbag for his 26-month-old son Nye, composing electronic sounds on bits
of dilapidated old keyboards for his music project Open E, and tutoring his cats in the art of peaceful
co-existence, and not violently mugging each other on the stairs.
Chris Ullman contributed Chapters 1, 14, 15, 16, 17, and Appendix E to this book.
John Kauffman
John Kauffman was born in Philadelphia, the son of a chemist and a nurse. He received his degrees from
The Pennsylvania State University, the colleges of Science and Agriculture. His early research was for
Hershey foods in the genetics of the chocolate tree and the molecular biology of chocolate production.
Subsequently he moved to the Rockefeller University, where he cloned and sequenced DNA regions
which control the day and night cycles of plants.
Since 1997 John has written ten books, six of which have been on the Amazon Computer Best Seller List.
His specialty is programming web front-ends for enterprise-level databases.
In his spare time, John is an avid sailor and youth sailing coach. He represented the USA in the sailing
world championship of 1985 and assisted the Olympic teams of Belgium and China in 1996. He also
enjoys jazz music and drumming and manages to read the New Yorker from cover-to-cover each week.
My portions of this book are dedicated to the instructors of two drum and bugle corps. These men
taught me about precision, accuracy, and discipline: Ken Green and John Flowers of the Belvederes 1976
and Dennis DeLucia and Bobby Hoffman of the Bayonne Bridgemen 1978.
John Kauffman contributed Chapters 2, 3, 4, 5, 6, and Appendix B to this book.
Chris Hart
Chris Hart is a full-time .NET Developer and part-time author who lives in Birmingham (UK) with her
husband James. While she's most at home in the world of the web, she's recently been working with the
.NET Compact Framework. In her spare time, Chris spends much of her time playing with beta
technologies, then attempting to write about them.
Chris has contributed many chapters to a variety of books, including Beginning ASP.NET (Wrox Press),
Beginning Dynamic Websites with ASP.NET Web Matrix (Wrox Press), and most recently, A Programmer's
Guide to SQL (Apress).
When she gets away from computers, Chris enjoys travel, especially when it involves driving along
narrow winding roads to get to out-of-the-way parts of Scotland. She dreams of building her own house
somewhere where she can keep a cat.
Chris Hart contributed Chapters 10, 11, 12, 13, and Appendices C and D to this book.
Dave Sussman
Dave Sussman is a writer, trainer, and consultant living in the wilds of the Oxfordshire countryside. He's
been working with ASP.NET since before it was first released and still isn't bored with it. You can contact
him at [email protected].
Dave Sussman contributed Chapters 7, 8, and 9 to this book.
Credits
Authors
Project Coordinator
Chris Ullman
John Kauffman
Chris Hart
David Sussman
Mary Richards
Senior Acquisitions Editor
Senior Production Manager
Jim Minatel
Fred Bernardi
Vice President & Executive Group
Publisher
Editorial Manager
Project Manager
Ami Frank Sullivan
Mary Beth Wakefield
Richard Swadley
Book Producer
Vice President and Executive Publisher
Bob Ipsen
Vice President and Publisher
Joseph B. Wikert
Executive Editorial Director
Mary Bednarek
Peer Technical Services Pvt. Ltd.
Contents
Introduction
Who Is this Book For?
What Does this Book Cover?
How this Book Is Structured
What Do You Need to Use this Book?
Conventions
Source Code
Errata
p2p.wrox.com
Chapter 1: Getting Started with ASP.NET
What Is a Static Web Page?
How Are Static Web Pages Served?
Limitations of Static Web Pages
What Is a Web Server?
How Are Dynamic Web Pages Served?
Providing Dynamic Web Page Content
What Is ASP.NET?
How Does ASP.NET Differ from ASP?
Using VB.NET
I'm Still Confused about ASP, ASP.NET, and VB.NET
The Installation Process
Which Operating System Do You Have?
Prerequisites for Installing ASP.NET
Try It Out Installing MDAC 2.8
Installing ASP.NET and the .NET Framework
Try It Out Installing the .NET Framework Redistributable
Installing Web Matrix
Try It Out Installing Web Matrix
Configuring Web Matrix for .NET Framework 1.1
Try It Out Configuring Web Matrix
Running Web Matrix and Setting Up the Web Server
Try It Out Starting the Web Server
ASP.NET Test Example
Try It Out Your first ASP.NET Web Page
ASP.NET Troubleshooting
1
2
2
3
5
5
6
6
7
9
10
12
13
14
14
15
18
19
19
20
20
21
22
22
23
24
25
26
28
28
29
29
36
36
39
Contents
Program Not Found, or the Result of the ASP.NET Isn't Being Displayed,
or the Browser Tries To Download the File
Page Cannot Be Displayed: HTTP Error 403
Page Cannot Be Found: HTTP Error 404
Web Page Unavailable While Offline
I Just Get a Blank Page
The Page Displays the Message but Not the Time
I Get an Error Statement Citing a Server Error
I Have a Different Problem
Summary
Chapter 2: Anatomy of an ASP.NET
What Is .NET?
From Your Code to Machine Code
Introducing Two Intermediate Languages
Objects, Objects Everywhere
The .NET Base Classes
The Class Browser
How ASP.NET Works
Saving your ASP.NET Files with an ASPX Suffix
Inserting ASP.NET Code into Our Web Pages
Try It Out Inserting Server-Side (ASP.NET) Code
Try It Out Interweaving ASP.NET Output with HTML
ASP.NET in Action
Binding to a Database
Try It Out Binding to a Database
Binding to a Simple XML File
Try It Out Binding to a Simple XML Document
Summary
Exercises
Chapter 3: Server Controls and Variables
Forms
Web Pages, HTML Forms, and Web Forms
Response and Request in Non-ASP.NET Pages
Where ASP.NET Fits in with the .NET Framework
The Tag in ASP.NET
Using ASP.NET Server Controls
The Control
Try It Out Using the Control
The Control
Try It Out Using the Control
The Control
Try It Out Using the Control
x
39
41
41
42
42
43
43
44
44
45
45
47
48
48
50
51
52
52
52
54
59
60
61
61
63
64
66
67
69
70
70
71
73
74
75
75
77
79
79
82
83
Chapter
Title
Contents
The Control
Try It Out Using the Control
The and Controls
Try It Out Using the Control
The and Controls
84
85
87
88
89
Try It Out Using the Control
90
Storing Information in VB.NET Variables
92
Declaring Variables
Try It Out Using Variables
Simple Data Types
Numeric
Text Data Types
Other Data Types
Naming Variables
Naming Conventions
Variable Scope
Try It Out Creating Procedure- and Block-Level Variables
Constants
Conversion Functions
Arrays
Try It Out Using Arrays
Data Collections
ArrayList
Try It Out Using an ArrayList
Hashtables
Try It Out Hashtable
92
93
95
96
97
98
99
100
100
101
106
106
107
108
111
111
113
114
116
SortedList
118
Summary
Exercises
119
120
Chapter 4: Control Structures and Procedural Programming
Operators
Assignment Operator
Try It Out Performing a Calculation on an ASP.NET Page
Numeric Comparison Operators
Logical Operators
Try It Out Performing a Calculation on an ASP.NET Page
An Overview of Control Structures
Overview of Branching Structures
Overview of Looping Structures
Overview of Jumping Structures
Uses of Control Structures
Branching Structures in Detail
The If...Then Structure
Try It Out Using the If...Then Structure
121
122
122
123
127
128
130
132
133
133
134
135
136
136
140
xi
Contents
Select Case Structure
Try It Out Using Select Case
Looping Structures in Detail
The For...Next Structure
Try It Out Using For...Next
The Do While Structure
Try It Out Using Do While
The Do...Until Structure
The For...Each Structure
With…End With
Try It Out Using With...End With
Summary
Exercises
Chapter 5: Jumping Structures – Subroutines and Functions
Overview of Jumping Structures
Jumping Structures in Detail
Modularization
Subroutines
Passing Parameters
Try It Out Using Subroutines with Parameters
Web Controls as Parameters
Try It Out Using Web Controls as Parameters
Functions
Defining Functions
Calling Functions
A Function Exercise
Try It Out Using Functions
Passing Parameters by Reference and by Value
Passing Parameters by Value
Passing Parameters by Reference
Try It Out Passing Values by Value and by Reference
ByVal v/s ByRef: A Comparison
Modularization Best Practices
Summary
Exercises
Chapter 6: Event-Driven Programming and Postback
What Is an Event?
What Is Event-Driven Programming?
HTML Events Executed on the Browser
ASP.NET’s Trace Feature
ASP.NET Page Events
ASP.NET Web Controls Events
xii
144
146
148
148
150
152
154
156
157
157
158
159
160
161
162
162
163
164
167
168
171
172
174
175
175
177
178
182
183
184
184
187
187
188
189
191
192
192
194
195
197
199
Chapter
Title
Contents
The ASP.NET Button Control
Event-Driven Programming and Postback
Try It Out Demonstrating Event Reaction in HTML and ASP.NET
The IsPostBack Test
Try It Out Calculator
Summary
Exercises
Chapter 7: Objects
Classes and Instances
Properties, Methods, and Events
Objects in .NET
Why Use Objects
Defining Classes
Try It Out Creating a Class
Property Variables
Property Types
Try It Out Read-Only Properties
Initializing Objects
Try It Out Creating Another Constructor
Implementing Methods
Try It Out Adding Methods to a Class
Consolidating Overloaded Methods
Advanced Classes
Shared or Static Properties and Methods
Inheritance
Try It Out Inheritance
Interfaces
Try It Out Creating an Interface
.NET Objects
Namespaces
The Class Browser
Summary
Exercises
Chapter 8: Reading From Databases
Understanding Databases
Tables
Normalization
SQL and Stored Procedures
The Web Matrix Data Explorer
Try It Out Connecting to a Database
Creating Data Pages
Displaying Data Using the Data Explorer
201
201
202
204
205
209
210
213
214
214
214
215
216
217
222
223
224
225
226
227
227
231
232
232
233
234
238
239
245
245
246
247
248
249
249
250
251
252
253
253
255
256
xiii
Contents
Try It Out Creating a Grid
Displaying Data Using Web Matrix Template Pages
256
259
Try It Out Creating a Data Page
260
Displaying Data Using the Code Wizards
265
Try It Out Creating a Data Page
ADO.NET
The OleDbConnection Object
The OleDbCommand Object
Try It Out using Parameters
The OleDataAdapter Object
The DataSet Object
The DataReader Object
Try It Out Using a DataReader
Summary
Exercises
Chapter 9: Advanced Data Handling
265
274
276
277
278
283
283
283
284
286
286
287
More Data Objects
287
The DataTable Object
The DataRow Object
288
290
Try It Out The DataTable and DataRow Objects
Updating Databases
ADO.NET v/s ADO
Updating Data in a DataSet
Try It Out Adding, Editing, and Deleting Rows
Updating the Original Data Source
Try It Out Auto-Generated Commands
Updating the Database
Try It Out Updating the Database
Updating Databases Using a Command
Try It Out Executing Commands Directly
Summary
Exercises
290
293
293
294
294
301
302
305
306
310
310
313
313
Chapter 10: ASP.NET Server Controls
315
The Wrox United Application
ASP.NET Web Controls
HTML Server Controls
HTML Server Controls v/s Web Controls
Web Controls
316
317
318
320
322
Rich Object Model
Automatic Browser Detection
Properties
Events
xiv
322
322
322
324
Chapter
Title
Contents
Try It Out Creating an Event Handler
Page Lifecycle
Page_Load()
Event Handling
Page_Unload()
Understanding Web Controls: The Wrox United Application
Try It Out Wrox United Main Page – Default.aspx
Intrinsic Controls
Try It Out Wrox United – Teams.aspx
Data Rendering Controls
Try It Out Wrox United – Teams.aspx Part 2
Rich Controls
Try It Out Wrox United – Default.aspx part 2, the Event Calendar
Try It Out Wrox United – Displaying Fixture Details
Web Matrix Controls
Try It Out Wrox United – Players.aspx and the Web Matrix MX DataGrid
Validation Controls
Try It Out Wrox United – Registering for Email Updates (Default.aspx)
Summary
Exercises
Chapter 11: Users and Applications
Remembering Information in a Web Application
Cookies
Try It Out Using Cookies
Sessions
Try It Out Using Session State – Wrox United, Merchandise.aspx
Applications
How Do Applications Work?
Try It Out Using Application State: Wrox United, Chat.aspx
Reacting to Application and Session Events
Global.asax
Try It Out Global.asax – Wrox United Global Settings
Caching
Try It Out Wrox United – Caching Objects
State Recommendations
When to Use Cookies
When to Use Sessions
When to Use Applications
When to Use Caching
Other State Management Techniques
Using Multiple State Management Techniques on a Page
Try It Out Wrox United – Adding Some Style!
Summary
Exercises
325
326
327
328
328
329
330
333
334
343
346
355
358
363
369
370
374
375
380
380
383
384
385
388
396
398
407
407
408
413
413
414
416
418
422
422
422
422
423
423
424
424
433
434
xv
Contents
Chapter 12: Reusable Code for ASP.NET
Encapsulation
Components
Why Use Components
Applying Component Theory to Applications
User Controls
Try It Out Our First User Control
Try It Out Wrox United: Simple Header Control Example
Try It Out Wrox United: Navigation User Control
Code-Behind
Try It Out Our First Code-Behind File
Try It Out Using Code-Behind in Wrox United
Summary
Exercises
Chapter 13: .NET Assemblies and Custom Controls
Three - Tier Application Design
ASP.NET Application Design
.NET Assemblies
Try It Out Our First ASP.NET Component
What Is Compilation?
Try It Out Compiling Our First ASP.NET Component
Accessing a Component from Within an ASP.NET Page
Try It Out Using a Compiled Component
XCopy Deployment
Accessing Assemblies in Other Locations
Writing Code in Other Languages
Try It Out Writing a Component in C#
Data Access Components
Try It Out Encapsulating Data Access Code into a Component
Custom Server Controls
What Are Custom Controls?
Try It Out Our First ASP.NET Custom Control
Composite Custom Controls
Try It Out Wrox United – Custom Composite Control
Summary
Exercises
Chapter 14: Debugging and Error Handling
A Few Good Habits
Good Coding Practice
Indent Your Code
Structure Your Code
xvi
435
435
436
438
438
439
441
445
451
456
457
461
463
464
467
468
470
471
472
474
475
478
478
481
481
482
483
487
488
495
495
496
504
505
511
511
513
514
514
515
515
Chapter
cter Title
Contents
Comment your Code
Use the Page Explicit Setting
Use the Page Strict Setting
Convert Variables to the Correct Data Types (Validation)
Try to Break Your Code
Where do Errors come from?
Syntax Errors
Try It Out Syntax Error
Try It Out Generate a Compiler Error
Logical (Runtime) Errors
Try It Out Generate a Runtime Error
Try It Out Catching Illegal Values
Try It Out Using RequiredFieldValidator
System Errors
Finding Errors
Try It Out Viewing the Call-stack
Debug Mode
Try It Out Disable the Debug Mode
Tracing
Try It Out Enabling Trace at the Page Level
Try It Out Writing to the Trace Log
Handling Errors
Unstructured Error Handling
Try It Out Using On Error Resume Next
Try It Out Using On Error
Try It Out Using the Err Object
Structured Error Handling
Try It Out Using Try...Catch...Finally
Handling Errors Programmatically
Try It Out Using Page_Error
Notification and Logging
Try It Out Creating Error Pages
Writing to the Event Log
Try It Out Writing to the Windows Error Log
Mailing the Site Administrator
Summary
Exercises
Chapter 15: Configuration and Optimization
516
516
517
517
518
518
519
520
521
523
524
525
528
529
529
530
531
531
533
533
537
540
540
541
543
545
547
551
553
553
555
556
559
560
563
565
565
569
Configuration Overview
570
Browsing .config Files
The Configuration Files
Configuration File Structure
571
572
576
Performance Optimization
Caching
583
583
xvii
Contents
Try It Out Output Caching
Try It Out Creating a File Dependency
Try It Out Creating A Key Dependency
Tips and Tricks
Summary
Exercises
Chapter 16: Web Services
What Is a Web Service?
Try It Out Creating Our First Web Service
HTTP, XML, and Web Services
HTTP GET
HTTP POST
Simple Object Access Protocol (SOAP)
Building an ASP.NET Web Service
Processing Directive
Namespaces
Public Class
Web Methods
Try It Out Creating a Web Service with Multiple Web Methods
Testing Your Web Service
Try It Out Browse to the Conversions Test Page
Using Your Web Service
Try It Out Viewing the WSDL Contract
Try It Out ISBN Search Web Service
Consuming a Web Service
How Does a Proxy Work?
Creating a Proxy
585
591
595
599
601
601
603
604
605
609
610
611
612
614
614
615
615
615
616
618
619
620
621
623
626
626
628
Try It Out Accessing the ISBN Web Service from an ASP.NET Page
628
Creating a Web Service for the Wrox United Application
632
Try It Out Adding a Results Page
Try It Out Creating the Web Service
Web Service Discovery
Securing a Web Service
Username-Password Combination or Registration Keys
Try It Out Securing a Web Service with Username and Password
Secure Sockets Layer
IP Address Restriction
Web Services Enhancements
Other Web Services Considerations
Network Connectivity
Asynchronous Method Calls
Service Hijacking (or Piggybacking)
Provider Solvency
The Interdependency Scenario
xviii
633
635
640
641
642
642
645
645
645
646
646
646
647
647
648
Chapter
Title
Contents
Summary
Exercises
Chapter 17: ASP.NET Security
What Is Security?
The ASP.NET Security Model
Authentication
Implementing Forms-Based Authentication
648
649
651
652
652
653
654
Try It Out Forms-Based Authentication
654
Forms-Based Authentication Using a Database
664
Try It Out Authenticating Against a Database
Authorization
Try It Out Authorization for [email protected]
Adding Authentication to the WroxUnited Application
Try It Out Adding a Login Page to WroxUnited
Encryption using SSL
Try It Out Enabling SSL
Summary
Exercises
Appendix A: Exercise Answers
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
Appendix B: Web Matrix Quick Start
What Is Web Matrix?
Starting ASP.NET Web Matrix
The Screen
How to Enter Code
664
668
668
670
671
681
682
683
684
685
685
686
690
693
695
698
701
704
706
711
719
722
731
735
737
742
747
748
749
749
753
xix
Contents
Try It Out Code Entry
Saving and Viewing Pages
Try It Out Formatting Modes, Views, and Serving Pages
Reusing Code
Try It Out Saving and Using Snippets
Class Browser
Try It Out Class Browser Property Look-Up
What to Study Next
Summary
Appendix C: The Wrox United Database
The Database Design
Players
Status
Teams
PlayerTeams
Positions
Games
GameTypes
Locations
Opponents
Fans
Installing the Database
Installing the Access Database
Installing the MSDE Database
Appendix D: Web Application Development using
Visual Studio .NET
Creating a Web Application Project
Features of the Visual Studio .NET Environment
Visual Studio .NET Solutions and Projects
Files in a Web Application Project
Working with Web Pages
Compiling and Running Pages
Adding Code to the Code-Behind Class
Features of Code View
Adding Code to Methods
Styling Controls and Pages in Visual Studio .NET
Working in HTML View
Creating User Controls
Formatting Blocks of Code
Developing the User Control
Creating an XML File
Adding a User Control to a Page
xx
753
754
756
757
757
758
759
760
760
763
763
764
765
765
765
766
766
767
768
768
768
769
769
770
775
776
777
778
779
779
782
784
784
785
791
797
798
803
804
806
809
Chapter
Title
Contents
Adding Custom Classes
Working with Databases Using the Server Explorer
Debugging in Visual Studio .NET
Using Breakpoints
Fixing Design-Time Errors
Suggested Exercises and Further Reading
Appendix E: Installing and Configuring IIS
Try It Out Locating and Installing IIS on Your Web Server Machine
Working with IIS
The Microsoft Management Console (MMC)
Testing Your Installation
Identifying Your Web Server's Name
Managing Directories on Your Web Server
Try It Out Creating a Virtual Directory and Setting Up Permissions
Permissions
Browsing to a Page on Your Web Server
Index
810
812
815
815
816
818
819
820
822
822
823
824
825
827
831
836
841
xxi
Introduction
ASP.NET is a radical update of Microsoft's Active Server Pages (ASP). ASP.NET is a powerful server
based technology designed to create dynamic and interactive HTML pages on demand for your
World Wide Web site or corporate intranet. It is designed to improve upon nearly every feature of
classic ASP, from reducing the amount of code you need to write to giving you more power and
flexibility.
ASP.NET also constitutes a key element in Microsoft's .NET Framework, providing Web-based
access to the immensely powerful .NET development environment. It allows us to create Web
applications in a new, flexible way by placing commonly used code into reusable controls of
various kinds that can be fired by events initiated by our site's users.
ASP.NET branches out into many other technologies, such as Web Services, ADO.NET, custom
controls, and security. We will briefly touch upon its relationship with these fields throughout the
book to provide a solid, comprehensive understanding of how ASP.NET can benefit your work in
a practical way.
ASP.NET 1.1 itself is a fairly light update to the complete wholesale changes that occurred in
ASP.NET 1.0. This book by and large covers features that are available in both 1.0 and 1.1, but it
does cover the pertinent new features of 1.1 that will be of interest to the novice user. So if you are
already running ASP.NET 1.0, you will be expected to upgrade to 1.1.
By the end of this book you will be familiar with the anatomy of ASP.NET 1.1 and be able to create
powerful, secure, and robust Web sites that can collect and work with information in a multitude
of ways to the benefit of both yourself and your users.
Introduction
Who Is this Book For?
The purpose of this book is to teach you from scratch how to use ASP.NET to be able to write Web pages
and Web applications whose content can be programmatically tailored each time an individual client
browser calls them up. This not only saves you a lot of effort in presenting and updating your Web
pages, but also offers tremendous scope for adding sophisticated functionality to your site. As ASP.NET
is not a programming language in its own right, but rather a technology (as we shall explain in the
book), we will be teaching some basic programming principles in Chapters 2 to 7 in Visual Basic.NET, our
chosen language for implementing ASP.NET.
This book is therefore ideal for somebody who knows some basic HTML but has never programmed
before, or somebody who is familiar with the basics of old style ASP, but hasn't investigated ASP.NET in
any detail. If you are an experienced programmer looking for a quick crash course on ASP.NET, or
somebody who's worked extensively with ASP, we suggest that you refer to Professional ASP.NET 1.1
Special Edition, Wiley, ISBN: 0-7645-5890-0 instead, as you'll most likely find that the early chapters here
just reiterate things you already know. If you are not familiar with HTML, then we suggest that you
master the basics of building Web pages before moving on to learning ASP.NET.
What Does this Book Cover?
This book teaches everything the novice user will need to know, from installing ASP.NET and the
relevant information for creating pages and putting together the concepts to create a whole application
using ASP.NET 1.1.
Although ASP.NET 1.1. isn't a huge update from version 1.0, this book has been considerably
overhauled since edition 1.0. Some of the old chapters have been removed and new ones introduced.
We've removed three chapters because we wanted to simplify the experience of learning ASP.NET. We've
created a brand new case study – an amateur sports league Web site – which is then used throughout
the later chapters in the book.
If you compare the previous edition, you will find this one to be more cohesive, aimed towards the
complete novice and the developer with some ASP experience, and written with the benefit of hindsight
from experienced developers who have have been employed in creating ASP.NET applications. We trust
that you will find it a great improvement over the last, just as every new edition should be.
In the course of this book you will learn:
2
❑
What is ASP.NET
❑
How to install ASP.NET and get it up and running
❑
The structure of ASP.NET and how it sits on the .NET Framework
❑
How to use ASP.NET to produce dynamic, flexible, interactive Web pages
❑
Basic programming principles, such as variables, controls structures, procedural programming,
and objects
❑
How to use ASP.NET to interface with different data sources, from databases to XML
documents
Introduction
❑
What ready-made controls ASP.NET offers for common situations
❑
How to create your own controls
❑
How to debug your ASP.NET pages
❑
How to deal with unexpected events and inputs
❑
How to create your own Web application
❑
How to integrate your applications with Web Services, and create your own Web Services
❑
Some simple security features and how to create a login for an application
How this Book Is Structured
Here is a quick breakdown of what you will find in this book:
❑
Chapter 1 – Getting Started with ASP.NET: In the first chapter we introduce ASP.NET and look at
some of the reasons that you'd want to use server-side code for creating Web pages and the
technologies that are available to do so. This done we spend the bulk of the chapter explaining
the ASP.NET installation process in detail, how to install a Web server to run ASP.NET on (we
will be using the Web server that accompanies Web Matrix), along with the ancillary installation
of MDAC. We finish up with a simple ASP.NET example page to check that our installation is
working correctly.
❑
Chapter 2 – Anatomy of an ASP.NET Page: Having completed the installation in the previous
chapter, we consider the structure of an ASP.NET page and the way that it functions in relation
to the .NET Framework. We use examples to demonstrate how the ASP.NET module parses the
page.
❑
Chapter 3 – Server Controls and Variables: Having acquainted ourselves with the basics of
ASP.NET controls this chapter considers the use of variables for holding data in Visual Basic
.NET. We look at how variables are implemented, what they can contain, and how they can be
placed into your ASP.NET pages.
❑
Chapter 4 – Control Structures and Procedural Programming: This chapter takes a whirlwind tour
of the key building blocks of VB.NET in the context of an ASP.NET page. We learn how to make
our ASP.NET pages more responsive through the use of VB.NET branching and looping
structures that enable us to control the order in which our program's statements execute.
❑
Chapter 5 – Jumping Structures, Subroutines, and Functions: We cover how the
modularization and reusable ASP.NET code works in this chapter. We look at subroutines and
functions and how they are used together with Web controls. We learn how to pass parameters
within ASP.NET pages and the different ways in which ASP.NET can handle them.
❑
Chapter 6 – Event-Driven Programming and Postback: We talk about how ASP.NET revolves
around an event-driven model, and how things occur in strict order and ways in which the
ASP.NET page can react to user intervention. We also look at the concept of postback and how it
is used to send information back from the user to the Web server, to preserve the "state" of a
page.
3
Introduction
❑
Chapter 7 – Objects: This chapter deals with the thorny subject of objects. ASP.NET pages derive a
great deal of their flexibility and power from the object-oriented way they are structured. This chapter introduces concepts such as properties, methods, constructors, collections,
andoverloading using plentiful examples relating to real-world objects to aid your
understanding. We also discuss the concepts that make objects very powerful, such as
inheritance and encapsulation, and how they greatly reduce the amount of code you need to use.
❑
Chapter 8 – Reading from Databases: At this point in the book we're familiar with the basic
anatomy of ASP.NET pages and objects, so we branch out to look at ADO.NET in the context of
ASP.NET. Most specifically we look at the use of the Connection and Command objects for
opening data sources and retrieving information into DataSets.
❑
Chapter 9 – Advanced Data Handling: Having mastered the basics of reading data in the
previous chapter we take things much further; looking in detail at the way we can manipulate
the information in DataTables and DataSets, and store the results back to the data source from
which they came.
❑
Chapter 10 – ASP.NET Server Controls: This chapter explains how ASP.NET server controls
derive their properties and methods from the various classes and objects that make up the .NET
Framework. It explains the syntax required to make their functionality available, together with a
look at the benefits that these controls can give. We also start to create the Wrox United
application case study that is used throughout the rest of the book.
❑
Chapter 11 – Users and Applications: This chapter deals mainly with the process of tracking users
across pages. We look at the objects that ASP.NET uses to enable this. We also tie this into our
case study by creating the facility for adding valid email addresses and passwords to a site via
an admin interface, and then we play the part of one of those users logging in and viewing
pages.
❑
Chapter 12 – Reusable Code for ASP.NET: Here we consider the great benefits that can be
achieved by encapsulating our code to make it more maintainable. Firstly we cover the idea of
user controls designed to store sections of your ASP.NET code that are repeated on multiple
pages of your site before going on to consider the idea of code behind, where the
block of our ASP.NET code is placed in its own file in order to separate the page's logic from its
presentation.
❑
Chapter 13 – .NET Assemblies and Custom Controls: We continue the ideas of the previous
chapter here. We cover how to compile a .NET assembly and use it from within our ASP.NET
page, as well as how to encapsulate our business logic into a component that can be reused on
other projects.
❑
Chapter 14 – Debugging and Error Handling: No matter how careful you are, things can always
go wrong within your code. This chapter explains the steps you can take to minimize these
occurrences and how to recover when things go wrong.
❑
Chapter 15 – Configuration and Optimization: We start by explaining how ASP.NET applications
can be managed from a series of XML configuration files, and then our discussion takes a more
general turn as we consider the many ways that you can streamline and speed-up your
ASP.NET applications.
❑
Chapter 16 – Web Services: You learn how to expose functionality from your Web site to others as
a Web Service. We then discuss how this functionality can be discovered by other users of the
Web, and the form that the data exchange takes.
4
Introduction
❑
Chapter 17 – ASP.NET Security: We conclude the book with a quick overview of some of the
simple precautions that you can take using forms authentication and authorization to safeguard
your ASP.NET pages and ensure that they're only accessed by authorized users in the way that
you want them to be accessed.
What Do You Need to Use this Book?
The only prerequisite for this book is to have a machine with the .NET Framework installed upon it. This
means that you'll need to be running Windows 2000 Professional or Server, Windows XP (either
Professional or Home edition) or Windows 2003 Server.
The .NET Framework itself is available as a free download from http://www.asp.net/ and
http://www.gotdotnet.com. This download is known as the .NET Framework Redistributable and its
approximate size is 20Mb. It includes everything you need to run any .NET application.
Also available is another complementary free download, which might be useful to you throughout the
book, although not essential. This is the .NET Framework SDK (Software Development Kit) and it
contains samples and tutorials that you can refer to in order to learn more about .NET, as well as some
useful tools, some of which we make use of in the book. However it doesn't include the .NET
Framework. The SDK is of size 130Mb approximately.
This book is designed with Web Matrix in mind, so we strongly suggest that you download this as well.
Web Matrix is a free download also available from http://www.asp.net. It will provide you with a Web
server capable of running ASP.NET if you haven't already got one. However while this book has been
designed with Web Matrix in mind, you will find that all of the examples can be created, run, and
understood using any simple text editor such as Notepad, although the instructions will be geared to the
point of view of someone who is running Web Matrix.
Windows XP Home Edition does not support IIS, so if you use this version of Windows, you will have
to download Web Matrix.
You do not need Visual Studio .NET in order to use this book.
Conventions
To help you get the most from the text and keep track of what's happening, we've used a number of
conventions throughout the book.
Boxes like this one hold important, not-to-be forgotten information that is directly relevant to the surrounding text.
While this background style is used for asides to the current discussion.
5
Introduction
As for styles in the text:
❑
When we introduce them, we italicize important words
❑
We show filenames and code within the text like so: persistence.properties
❑
We present code in two different ways:
In code examples, the Code Foreground style shows new, important, pertinent
code.
The Code Background style shows code that's less important in the present
context, or has been shown before.
Source Code
As you work through the examples in this book, you may choose either to type in all the code manually
or to use the source code files that accompany the book. All of the source code used in this book is
available for download at http://www.wrox.com. Once at the site, simply locate the book's title (either by
using the Search box or by using one of the title lists) and click the Download Code link on the book's
detail page to obtain all the source code for the book. Because many books have similar titles, you may
find it easiest to search by ISBN, which for this book is 0764557076. Once you download the code, just
decompress it with your favorite compression tool. Alternately, you can go to the main Wrox code
download page at http://www.wrox.com/dynamic/books/download.aspx to see the code available for this
book and all other Wrox books.
Errata
We make every effort to ensure that there are no errors in the text or in the code. However, no one is
perfect, and mistakes do occur. If you find an error in one of our books, like a spelling mistake or faulty
piece of code, we would be very grateful for your feedback. By sending in errata you may save another
reader hours of frustration, and you will be helping us provide even higher quality information.
To find the errata page for this book, go to http://www.wrox.com and locate the title using the Search box
or one of the title lists. Then, on the book details page, click the View Errata link. On this page, you can
view all errata that has been submitted for this book and posted by Wrox editors. A complete book list
including links to each book's errata is also available at www.wrox.com/misc-pages/booklist.shtml.
If you don't spot your error on the View Errata page, go to www.wrox.com/contact/techsupport.shtml and
complete the form there to send us the error you have found. We'll check the information and, if
appropriate, post a message to the book's errata page and fix the problem in subsequent editions of
the book.
6
Introduction
p2p.wrox.com
For author and peer discussion, join the P2P forums at p2p.wrox.com. The forums are a Web-based
system for you to post messages relating to Wrox books and related technologies and interact with other
readers and technology users. The forums offer a subscription feature to email you topics of interest of
your choosing when new posts are made to the forums. Wrox authors, editors other industry experts,
and your fellow readers are present on these forums.
At http://p2p.wrox.com you will find a number of different forums that will help you not only as you read
this book, but also as you develop your own applications.
You can read messages in the forums without joining P2P, but in order to post your own messages, you
must join the forum.
To join the forums:
1.
2.
3.
4.
Go to p2p.wrox.com and click the Register link.
Read the terms of use and click Agree.
Complete the required information to join as well as any optional information you wish to
provide and click Submit.
You will receive an email with information describing how to verify your account and complete
the joining process.
Once you have joined, you can post new messages and respond to messages other users post. You can
read messages at any time on the Web. If you would like to have new messages from a particular forum
emailed to you, click the Subscribe to this Forum icon by the forum name in the forum listing.
For more information about how to use the Wrox P2P be sure to read the P2P FAQs; they answer
questions about how the forum software works as well as many common questions specific to P2P and
Wrox books. To read the FAQs, click the FAQ link on any P2P page.
7
1
Getting Started With
ASP.NET
ASP.NET is a powerful and flexible technology for creating dynamic Web pages. It's a convergence
of two major Microsoft technologies, Active Server Pages (ASP) and the .NET Framework. ASP (or
classic ASP as it's often referred to), is a relative old-timer on the Web computing circuit and has
provided a sturdy, powerful, and effective way of building dynamic Web pages for seven years or
so now. The .NET Framework, on the other hand, is a whole suite of technologies designed by
Microsoft with the aim of revolutionizing the way in which all programming development takes
place and the way companies carry out business. ASP.NET is a way of creating dynamic Web
pages while making use of the innovations present in the .NET Framework.
The first important thing to know about ASP.NET is that you don't need any ASP skills to learn it.
All you need is a little HTML knowledge for building Web pages. In fact, knowing ASP could be a
disadvantage in some ways because you may have to unlearn some of the principles you followed
earlier. ASP.NET allows you to build dynamic Web pages and tailors the HTML output to the
browser you're using. It also comes with a great set of reusable, predefined, and ready to use
controls for your ASP.NET projects. These reduce the amount of code you have to write, so you
can be more productive while programming.
So, what can you do with ASP.NET? It may be easier to list what you can't, as that is arguably
shorter! One of the most eye-catching things about ASP.NET is the way you can use any
programming language based on the .NET Framework, such as VB .NET, JScript.NET, or C# to
create your Web applications. Within these applications, ASP.NET allows you to customize pages
for a particular user, and makes it simpler to keep track of a particular user's details as they
move around.
ASP.NET makes storing information to a database or self-describing XML document faster and
easier. You can alter the layout of the page using a free Web page editor – Web Matrix – designed
to be used with ASP.NET, rather than having to position everything manually within code, and
even alter the contents of files on your machine, if you have the correct permissions.
Chapter 1
In addition, you can use bits and pieces of other applications without downloading the whole
application. For example, you can access a zip code verifier that is part of another Web site's features,
without having to download the whole application or even giving your users the impression that
they've left your site (Chapter 16 will cover Web Services as well as accessing specific features of your
application via the Web). With ASP.NET, the applications that you create are only limited by your
imagination.
This chapter will cover the installation process of ASP.NET, Web Matrix, and the .NET Framework. Let's
start with a quick introduction to the world of Web servers, dynamic Web pages, and a little bit about
what ASP.NET is. This will help accomplish the main aim of this chapter – to get you running a fully
functional Web server, with a fully functional ASP.NET installation. We will create a short ASP.NET test
page to check that both the Web server and ASP.NET are working as intended. We'll also look at some of
the most common pitfalls encountered.
The topics discussed in this chapter are:
❑
Static Web pages
❑
Dynamic Web pages
❑
What is ASP.NET?
❑
Installing the .NET Framework
❑
Installing Web Matrix
❑
Testing and troubleshooting your installation
What Is a Static Web Page?
If you surf the Web, you'll see many static Web pages. Essentially, this type of Web page consists of some
HTML code typed directly into a text or Web page editor and saved as a .htm or .html file. Thus, the
author of the page has already determined the exact content of the page, in HTML, at some time before
any user visits the page.
Static Web pages are often easy to spot; sometimes you can pick them out by just looking at the content
of the page. The content (text, images, hyperlinks, and so on) and appearance of static Web pages is
always the same – regardless of who visits the page, or how and when they arrive at the page, or any other
factors.
10
Getting Started With ASP.NET
For example, you can create a page called Welcome.htm for your Web site, by writing some simple
HTML like this:
A Welcome Message
Welcome
Welcome to our humble website. Please feel free to view our
list of contents.
If you have any difficulties, you can
send email to the webmaster.
Whenever a client comes to your site and views this page, it will look like the screenshot depicted in
Figure 1-1:
Figure 1-1
The content of the page was determined before the request to view the page was made – in fact, it was
determined at the time the Webmaster saved the .htm file to disk.
11
Chapter 1
How Are Static Web Pages Served?
Let's think for a moment about how a static, pure HTML page finds its way to a client browser (the
process is depicted in Figure 1-2):
WEB SERVER
3. Web server locates .html file
1. Author writes HTML
4. HTML stream (from .html page)
returned to browser
2. Client requests
web page
5. Browser processes HTML
and displays page
CLIENT
Figure 1-2
1.
A Web author writes a page using only HTML and saves it within an .htm file on the Web
server.
2.
Sometime later, a user types a page request (URL) into a browser, and the request passes from the
browser to the Web server.
3.
4.
5.
The Web server locates the .htm page and converts it to an HTML stream.
The Web server sends the HTML stream back across the network to the browser.
The browser processes the HTML and displays the page.
Static, pure-HTML files like Welcome.htm make perfectly serviceable Web pages. You can even spruce
up the presentation and usability of such pages by adding more HTML to alter fonts and colors.
However, there are limitations with what you can achieve with pure-HTML pages because their content
is completely determined before the page is requested. There's no facility for user interaction or dynamic
responses (even simple objects like forms and buttons require more than just HTML to make them
work).
12
Getting Started With ASP.NET
Limitations of Static Web Pages
Static Web pages limit you in several ways. For example, suppose you want to enhance your Welcome
page so that it displays the current time or a special personalized message for each user. These are
simple alterations, but they are impossible to achieve using HTML alone. If you're not convinced, try
writing HTML for a Web page that displays the current time as shown in Figure 1-3:
Figure 1-3
As you type in the HTML, you'll soon realize the problem – you know that the user will request the page
sometime, but you don't know what time they will do it! Hardcoding the time into your HTML will result
in a page that always shows the same time (that will almost always be wrong). In other words, you're
trying to write pure HTML for a Web page that displays the time, but you can't be sure of the exact time
that the Web page should display until the time the page is requested. This can't be done using HTML
alone.
HTML offers no features for personalizing your Web pages; the same Web page is served to every user.
There's also no security with HTML; the code is there for everybody to view, and there's nothing to stop
you from copying somebody else's HTML code and using it in your own Web page. Static pages can be
very fast, as quick as copying a small file over a network, but they cannot provide any dynamic features.
Since you can't create this page by saving hard-coded HTML into a file before the page is requested, what
you need is a way to generate the HTML after the page is requested. There are two ways of doing this;
we'll look at both of them in this chapter. However, before going any further let's make sure everybody
is up to speed on the terminology we've introduced here.
13
Chapter 1
What Is a Web Server?
Web servers are software that manage Web pages and make them available to client browsers – via a
with VB.NET 2003
Chris Ullman
John Kauffman
Chris Hart
Dave Sussman
Wiley Publishing, Inc.
Beginning ASP.NET 1.1
with VB.NET 2003
Beginning ASP.NET 1.1
with VB.NET 2003
Chris Ullman
John Kauffman
Chris Hart
Dave Sussman
Wiley Publishing, Inc.
Beginning ASP.NET 1.1 with VB.NET 2003
Published by
Wiley Publishing, Inc.
10475 Crosspoint Boulevard
Indianapolis, IN 46256
www.wiley.com
Copyright © 2004 by Wiley Publishing, Inc., Indianapolis, Indiana
Published simultaneously in Canada
Library of Congress Card Number: 2003114198
ISBN: 0-7645-5707-6
Manufactured in the United States of America
10 9 8 7 6 5 4 3 2 1
1B/RW/RS/QU
No part of this publication may be reproduced, stored in a retrieval system or transmitted in any form or by
any means, electronic, mechanical, photocopying, recording, scanning or otherwise, except as permitted
under Sections 107 or 108 of the 1976 United States Copyright Act, without either the prior written permission of the Publisher, or authorization through payment of the appropriate per-copy fee to the Copyright
Clearance Center, 222 Rosewood Drive, Danvers, MA 01923, (978) 750-8400, fax (978) 646-8700. Requests to
the Publisher for permission should be addressed to the Legal Department, Wiley Publishing, Inc., 10475
Crosspoint Blvd., Indianapolis, IN 46256, (317) 572-3447, fax (317) 572-4447, Email:
[email protected].
LIMIT OF LIABILITY/DISCLAIMER OF WARRANTY: WHILE THE PUBLISHER AND AUTHOR
HAVE USED THEIR BEST EFFORTS IN PREPARING THIS BOOK, THEY MAKE NO REPRESENTATIONS OR WARRANTIES WITH RESPECT TO THE ACCURACY OR COMPLETENESS OF THE CONTENTS OF THIS BOOK AND SPECIFICALLY DISCLAIM ANY IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. NO WARRANTY MAY BE CREATED OR EXTENDED BY SALES REPRESENTATIVES OR WRITTEN SALES MATERIALS. THE
ADVICE AND STRATEGIES CONTAINED HEREIN MAY NOT BE SUITABLE FOR YOUR SITUATION.
YOU SHOULD CONSULT WITH A PROFESSIONAL WHERE APPROPRIATE. NEITHER THE PUBLISHER NOR AUTHOR SHALL BE LIABLE FOR ANY LOSS OF PROFIT OR ANY OTHER COMMERCIAL DAMAGES, INCLUDING BUT NOT LIMITED TO SPECIAL, INCIDENTAL, CONSEQUENTIAL,
OR OTHER DAMAGES.
For general information on our other products and services or to obtain technical support, please contact our
Customer Care Department within the U.S. at (800) 762-2974, outside the U.S. at (317) 572-3993 or fax (317)
572-4002.
Wiley also publishes its books in a variety of electronic formats. Some content that appears in print may not
be available in electronic books.
Trademarks: Wiley, the Wiley Publishing logo, Wrox, the Wrox logo, Programmer to Programmer, and
related trade dress are trademarks or registered trademarks of John Wiley & Sons, Inc. and/or its affiliates in
the United States and other countries, and may not be used without written permission. All other
trademarks are the property of their respective owners. Wiley Publishing, Inc. is not associated with any
product or vendor mentioned in this book.
About the Authors
Chris Ullman
Chris Ullman is a freelance web developer and technical author who has spent many years stewing in
ASP/ASP.NET, like a teabag left too long in the pot. Coming from a Computer Science background, he
started initially as a UNIX/Linux guru, who gravitated towards MS technologies during the summer of
ASP (1997). He cut his teeth on Wrox Press ASP guides, and since then he has written over 20 books,
most notably as lead author for Wrox's bestselling Beginning ASP/ASP.NET series, and has contributed
chapters to books on PHP, ColdFusion, JavaScript, Web Services, C#, XML and other Internet-related
technologies too esoteric to mention, now swallowed up in the quicksands of the dot.com boom.
Quitting Wrox as a full-time employee in August 2001, he branched out into VB6 programming and
ASP development maintaining a multitude of sites from http://www.cuasp.co.co.uk, his "work" site, to
http://www.atomicwise.com, a selection of his writings on music and art. He now divides his time
between being a human punchbag for his 26-month-old son Nye, composing electronic sounds on bits
of dilapidated old keyboards for his music project Open E, and tutoring his cats in the art of peaceful
co-existence, and not violently mugging each other on the stairs.
Chris Ullman contributed Chapters 1, 14, 15, 16, 17, and Appendix E to this book.
John Kauffman
John Kauffman was born in Philadelphia, the son of a chemist and a nurse. He received his degrees from
The Pennsylvania State University, the colleges of Science and Agriculture. His early research was for
Hershey foods in the genetics of the chocolate tree and the molecular biology of chocolate production.
Subsequently he moved to the Rockefeller University, where he cloned and sequenced DNA regions
which control the day and night cycles of plants.
Since 1997 John has written ten books, six of which have been on the Amazon Computer Best Seller List.
His specialty is programming web front-ends for enterprise-level databases.
In his spare time, John is an avid sailor and youth sailing coach. He represented the USA in the sailing
world championship of 1985 and assisted the Olympic teams of Belgium and China in 1996. He also
enjoys jazz music and drumming and manages to read the New Yorker from cover-to-cover each week.
My portions of this book are dedicated to the instructors of two drum and bugle corps. These men
taught me about precision, accuracy, and discipline: Ken Green and John Flowers of the Belvederes 1976
and Dennis DeLucia and Bobby Hoffman of the Bayonne Bridgemen 1978.
John Kauffman contributed Chapters 2, 3, 4, 5, 6, and Appendix B to this book.
Chris Hart
Chris Hart is a full-time .NET Developer and part-time author who lives in Birmingham (UK) with her
husband James. While she's most at home in the world of the web, she's recently been working with the
.NET Compact Framework. In her spare time, Chris spends much of her time playing with beta
technologies, then attempting to write about them.
Chris has contributed many chapters to a variety of books, including Beginning ASP.NET (Wrox Press),
Beginning Dynamic Websites with ASP.NET Web Matrix (Wrox Press), and most recently, A Programmer's
Guide to SQL (Apress).
When she gets away from computers, Chris enjoys travel, especially when it involves driving along
narrow winding roads to get to out-of-the-way parts of Scotland. She dreams of building her own house
somewhere where she can keep a cat.
Chris Hart contributed Chapters 10, 11, 12, 13, and Appendices C and D to this book.
Dave Sussman
Dave Sussman is a writer, trainer, and consultant living in the wilds of the Oxfordshire countryside. He's
been working with ASP.NET since before it was first released and still isn't bored with it. You can contact
him at [email protected].
Dave Sussman contributed Chapters 7, 8, and 9 to this book.
Credits
Authors
Project Coordinator
Chris Ullman
John Kauffman
Chris Hart
David Sussman
Mary Richards
Senior Acquisitions Editor
Senior Production Manager
Jim Minatel
Fred Bernardi
Vice President & Executive Group
Publisher
Editorial Manager
Project Manager
Ami Frank Sullivan
Mary Beth Wakefield
Richard Swadley
Book Producer
Vice President and Executive Publisher
Bob Ipsen
Vice President and Publisher
Joseph B. Wikert
Executive Editorial Director
Mary Bednarek
Peer Technical Services Pvt. Ltd.
Contents
Introduction
Who Is this Book For?
What Does this Book Cover?
How this Book Is Structured
What Do You Need to Use this Book?
Conventions
Source Code
Errata
p2p.wrox.com
Chapter 1: Getting Started with ASP.NET
What Is a Static Web Page?
How Are Static Web Pages Served?
Limitations of Static Web Pages
What Is a Web Server?
How Are Dynamic Web Pages Served?
Providing Dynamic Web Page Content
What Is ASP.NET?
How Does ASP.NET Differ from ASP?
Using VB.NET
I'm Still Confused about ASP, ASP.NET, and VB.NET
The Installation Process
Which Operating System Do You Have?
Prerequisites for Installing ASP.NET
Try It Out Installing MDAC 2.8
Installing ASP.NET and the .NET Framework
Try It Out Installing the .NET Framework Redistributable
Installing Web Matrix
Try It Out Installing Web Matrix
Configuring Web Matrix for .NET Framework 1.1
Try It Out Configuring Web Matrix
Running Web Matrix and Setting Up the Web Server
Try It Out Starting the Web Server
ASP.NET Test Example
Try It Out Your first ASP.NET Web Page
ASP.NET Troubleshooting
1
2
2
3
5
5
6
6
7
9
10
12
13
14
14
15
18
19
19
20
20
21
22
22
23
24
25
26
28
28
29
29
36
36
39
Contents
Program Not Found, or the Result of the ASP.NET Isn't Being Displayed,
or the Browser Tries To Download the File
Page Cannot Be Displayed: HTTP Error 403
Page Cannot Be Found: HTTP Error 404
Web Page Unavailable While Offline
I Just Get a Blank Page
The Page Displays the Message but Not the Time
I Get an Error Statement Citing a Server Error
I Have a Different Problem
Summary
Chapter 2: Anatomy of an ASP.NET
What Is .NET?
From Your Code to Machine Code
Introducing Two Intermediate Languages
Objects, Objects Everywhere
The .NET Base Classes
The Class Browser
How ASP.NET Works
Saving your ASP.NET Files with an ASPX Suffix
Inserting ASP.NET Code into Our Web Pages
Try It Out Inserting Server-Side (ASP.NET) Code
Try It Out Interweaving ASP.NET Output with HTML
ASP.NET in Action
Binding to a Database
Try It Out Binding to a Database
Binding to a Simple XML File
Try It Out Binding to a Simple XML Document
Summary
Exercises
Chapter 3: Server Controls and Variables
Forms
Web Pages, HTML Forms, and Web Forms
Response and Request in Non-ASP.NET Pages
Where ASP.NET Fits in with the .NET Framework
The Tag in ASP.NET
Using ASP.NET Server Controls
The Control
Try It Out Using the Control
The Control
Try It Out Using the Control
The Control
Try It Out Using the Control
x
39
41
41
42
42
43
43
44
44
45
45
47
48
48
50
51
52
52
52
54
59
60
61
61
63
64
66
67
69
70
70
71
73
74
75
75
77
79
79
82
83
Chapter
Title
Contents
The Control
Try It Out Using the Control
The and Controls
Try It Out Using the Control
The and Controls
84
85
87
88
89
Try It Out Using the Control
90
Storing Information in VB.NET Variables
92
Declaring Variables
Try It Out Using Variables
Simple Data Types
Numeric
Text Data Types
Other Data Types
Naming Variables
Naming Conventions
Variable Scope
Try It Out Creating Procedure- and Block-Level Variables
Constants
Conversion Functions
Arrays
Try It Out Using Arrays
Data Collections
ArrayList
Try It Out Using an ArrayList
Hashtables
Try It Out Hashtable
92
93
95
96
97
98
99
100
100
101
106
106
107
108
111
111
113
114
116
SortedList
118
Summary
Exercises
119
120
Chapter 4: Control Structures and Procedural Programming
Operators
Assignment Operator
Try It Out Performing a Calculation on an ASP.NET Page
Numeric Comparison Operators
Logical Operators
Try It Out Performing a Calculation on an ASP.NET Page
An Overview of Control Structures
Overview of Branching Structures
Overview of Looping Structures
Overview of Jumping Structures
Uses of Control Structures
Branching Structures in Detail
The If...Then Structure
Try It Out Using the If...Then Structure
121
122
122
123
127
128
130
132
133
133
134
135
136
136
140
xi
Contents
Select Case Structure
Try It Out Using Select Case
Looping Structures in Detail
The For...Next Structure
Try It Out Using For...Next
The Do While Structure
Try It Out Using Do While
The Do...Until Structure
The For...Each Structure
With…End With
Try It Out Using With...End With
Summary
Exercises
Chapter 5: Jumping Structures – Subroutines and Functions
Overview of Jumping Structures
Jumping Structures in Detail
Modularization
Subroutines
Passing Parameters
Try It Out Using Subroutines with Parameters
Web Controls as Parameters
Try It Out Using Web Controls as Parameters
Functions
Defining Functions
Calling Functions
A Function Exercise
Try It Out Using Functions
Passing Parameters by Reference and by Value
Passing Parameters by Value
Passing Parameters by Reference
Try It Out Passing Values by Value and by Reference
ByVal v/s ByRef: A Comparison
Modularization Best Practices
Summary
Exercises
Chapter 6: Event-Driven Programming and Postback
What Is an Event?
What Is Event-Driven Programming?
HTML Events Executed on the Browser
ASP.NET’s Trace Feature
ASP.NET Page Events
ASP.NET Web Controls Events
xii
144
146
148
148
150
152
154
156
157
157
158
159
160
161
162
162
163
164
167
168
171
172
174
175
175
177
178
182
183
184
184
187
187
188
189
191
192
192
194
195
197
199
Chapter
Title
Contents
The ASP.NET Button Control
Event-Driven Programming and Postback
Try It Out Demonstrating Event Reaction in HTML and ASP.NET
The IsPostBack Test
Try It Out Calculator
Summary
Exercises
Chapter 7: Objects
Classes and Instances
Properties, Methods, and Events
Objects in .NET
Why Use Objects
Defining Classes
Try It Out Creating a Class
Property Variables
Property Types
Try It Out Read-Only Properties
Initializing Objects
Try It Out Creating Another Constructor
Implementing Methods
Try It Out Adding Methods to a Class
Consolidating Overloaded Methods
Advanced Classes
Shared or Static Properties and Methods
Inheritance
Try It Out Inheritance
Interfaces
Try It Out Creating an Interface
.NET Objects
Namespaces
The Class Browser
Summary
Exercises
Chapter 8: Reading From Databases
Understanding Databases
Tables
Normalization
SQL and Stored Procedures
The Web Matrix Data Explorer
Try It Out Connecting to a Database
Creating Data Pages
Displaying Data Using the Data Explorer
201
201
202
204
205
209
210
213
214
214
214
215
216
217
222
223
224
225
226
227
227
231
232
232
233
234
238
239
245
245
246
247
248
249
249
250
251
252
253
253
255
256
xiii
Contents
Try It Out Creating a Grid
Displaying Data Using Web Matrix Template Pages
256
259
Try It Out Creating a Data Page
260
Displaying Data Using the Code Wizards
265
Try It Out Creating a Data Page
ADO.NET
The OleDbConnection Object
The OleDbCommand Object
Try It Out using Parameters
The OleDataAdapter Object
The DataSet Object
The DataReader Object
Try It Out Using a DataReader
Summary
Exercises
Chapter 9: Advanced Data Handling
265
274
276
277
278
283
283
283
284
286
286
287
More Data Objects
287
The DataTable Object
The DataRow Object
288
290
Try It Out The DataTable and DataRow Objects
Updating Databases
ADO.NET v/s ADO
Updating Data in a DataSet
Try It Out Adding, Editing, and Deleting Rows
Updating the Original Data Source
Try It Out Auto-Generated Commands
Updating the Database
Try It Out Updating the Database
Updating Databases Using a Command
Try It Out Executing Commands Directly
Summary
Exercises
290
293
293
294
294
301
302
305
306
310
310
313
313
Chapter 10: ASP.NET Server Controls
315
The Wrox United Application
ASP.NET Web Controls
HTML Server Controls
HTML Server Controls v/s Web Controls
Web Controls
316
317
318
320
322
Rich Object Model
Automatic Browser Detection
Properties
Events
xiv
322
322
322
324
Chapter
Title
Contents
Try It Out Creating an Event Handler
Page Lifecycle
Page_Load()
Event Handling
Page_Unload()
Understanding Web Controls: The Wrox United Application
Try It Out Wrox United Main Page – Default.aspx
Intrinsic Controls
Try It Out Wrox United – Teams.aspx
Data Rendering Controls
Try It Out Wrox United – Teams.aspx Part 2
Rich Controls
Try It Out Wrox United – Default.aspx part 2, the Event Calendar
Try It Out Wrox United – Displaying Fixture Details
Web Matrix Controls
Try It Out Wrox United – Players.aspx and the Web Matrix MX DataGrid
Validation Controls
Try It Out Wrox United – Registering for Email Updates (Default.aspx)
Summary
Exercises
Chapter 11: Users and Applications
Remembering Information in a Web Application
Cookies
Try It Out Using Cookies
Sessions
Try It Out Using Session State – Wrox United, Merchandise.aspx
Applications
How Do Applications Work?
Try It Out Using Application State: Wrox United, Chat.aspx
Reacting to Application and Session Events
Global.asax
Try It Out Global.asax – Wrox United Global Settings
Caching
Try It Out Wrox United – Caching Objects
State Recommendations
When to Use Cookies
When to Use Sessions
When to Use Applications
When to Use Caching
Other State Management Techniques
Using Multiple State Management Techniques on a Page
Try It Out Wrox United – Adding Some Style!
Summary
Exercises
325
326
327
328
328
329
330
333
334
343
346
355
358
363
369
370
374
375
380
380
383
384
385
388
396
398
407
407
408
413
413
414
416
418
422
422
422
422
423
423
424
424
433
434
xv
Contents
Chapter 12: Reusable Code for ASP.NET
Encapsulation
Components
Why Use Components
Applying Component Theory to Applications
User Controls
Try It Out Our First User Control
Try It Out Wrox United: Simple Header Control Example
Try It Out Wrox United: Navigation User Control
Code-Behind
Try It Out Our First Code-Behind File
Try It Out Using Code-Behind in Wrox United
Summary
Exercises
Chapter 13: .NET Assemblies and Custom Controls
Three - Tier Application Design
ASP.NET Application Design
.NET Assemblies
Try It Out Our First ASP.NET Component
What Is Compilation?
Try It Out Compiling Our First ASP.NET Component
Accessing a Component from Within an ASP.NET Page
Try It Out Using a Compiled Component
XCopy Deployment
Accessing Assemblies in Other Locations
Writing Code in Other Languages
Try It Out Writing a Component in C#
Data Access Components
Try It Out Encapsulating Data Access Code into a Component
Custom Server Controls
What Are Custom Controls?
Try It Out Our First ASP.NET Custom Control
Composite Custom Controls
Try It Out Wrox United – Custom Composite Control
Summary
Exercises
Chapter 14: Debugging and Error Handling
A Few Good Habits
Good Coding Practice
Indent Your Code
Structure Your Code
xvi
435
435
436
438
438
439
441
445
451
456
457
461
463
464
467
468
470
471
472
474
475
478
478
481
481
482
483
487
488
495
495
496
504
505
511
511
513
514
514
515
515
Chapter
cter Title
Contents
Comment your Code
Use the Page Explicit Setting
Use the Page Strict Setting
Convert Variables to the Correct Data Types (Validation)
Try to Break Your Code
Where do Errors come from?
Syntax Errors
Try It Out Syntax Error
Try It Out Generate a Compiler Error
Logical (Runtime) Errors
Try It Out Generate a Runtime Error
Try It Out Catching Illegal Values
Try It Out Using RequiredFieldValidator
System Errors
Finding Errors
Try It Out Viewing the Call-stack
Debug Mode
Try It Out Disable the Debug Mode
Tracing
Try It Out Enabling Trace at the Page Level
Try It Out Writing to the Trace Log
Handling Errors
Unstructured Error Handling
Try It Out Using On Error Resume Next
Try It Out Using On Error
Try It Out Using the Err Object
Structured Error Handling
Try It Out Using Try...Catch...Finally
Handling Errors Programmatically
Try It Out Using Page_Error
Notification and Logging
Try It Out Creating Error Pages
Writing to the Event Log
Try It Out Writing to the Windows Error Log
Mailing the Site Administrator
Summary
Exercises
Chapter 15: Configuration and Optimization
516
516
517
517
518
518
519
520
521
523
524
525
528
529
529
530
531
531
533
533
537
540
540
541
543
545
547
551
553
553
555
556
559
560
563
565
565
569
Configuration Overview
570
Browsing .config Files
The Configuration Files
Configuration File Structure
571
572
576
Performance Optimization
Caching
583
583
xvii
Contents
Try It Out Output Caching
Try It Out Creating a File Dependency
Try It Out Creating A Key Dependency
Tips and Tricks
Summary
Exercises
Chapter 16: Web Services
What Is a Web Service?
Try It Out Creating Our First Web Service
HTTP, XML, and Web Services
HTTP GET
HTTP POST
Simple Object Access Protocol (SOAP)
Building an ASP.NET Web Service
Processing Directive
Namespaces
Public Class
Web Methods
Try It Out Creating a Web Service with Multiple Web Methods
Testing Your Web Service
Try It Out Browse to the Conversions Test Page
Using Your Web Service
Try It Out Viewing the WSDL Contract
Try It Out ISBN Search Web Service
Consuming a Web Service
How Does a Proxy Work?
Creating a Proxy
585
591
595
599
601
601
603
604
605
609
610
611
612
614
614
615
615
615
616
618
619
620
621
623
626
626
628
Try It Out Accessing the ISBN Web Service from an ASP.NET Page
628
Creating a Web Service for the Wrox United Application
632
Try It Out Adding a Results Page
Try It Out Creating the Web Service
Web Service Discovery
Securing a Web Service
Username-Password Combination or Registration Keys
Try It Out Securing a Web Service with Username and Password
Secure Sockets Layer
IP Address Restriction
Web Services Enhancements
Other Web Services Considerations
Network Connectivity
Asynchronous Method Calls
Service Hijacking (or Piggybacking)
Provider Solvency
The Interdependency Scenario
xviii
633
635
640
641
642
642
645
645
645
646
646
646
647
647
648
Chapter
Title
Contents
Summary
Exercises
Chapter 17: ASP.NET Security
What Is Security?
The ASP.NET Security Model
Authentication
Implementing Forms-Based Authentication
648
649
651
652
652
653
654
Try It Out Forms-Based Authentication
654
Forms-Based Authentication Using a Database
664
Try It Out Authenticating Against a Database
Authorization
Try It Out Authorization for [email protected]
Adding Authentication to the WroxUnited Application
Try It Out Adding a Login Page to WroxUnited
Encryption using SSL
Try It Out Enabling SSL
Summary
Exercises
Appendix A: Exercise Answers
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
Chapter
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
Appendix B: Web Matrix Quick Start
What Is Web Matrix?
Starting ASP.NET Web Matrix
The Screen
How to Enter Code
664
668
668
670
671
681
682
683
684
685
685
686
690
693
695
698
701
704
706
711
719
722
731
735
737
742
747
748
749
749
753
xix
Contents
Try It Out Code Entry
Saving and Viewing Pages
Try It Out Formatting Modes, Views, and Serving Pages
Reusing Code
Try It Out Saving and Using Snippets
Class Browser
Try It Out Class Browser Property Look-Up
What to Study Next
Summary
Appendix C: The Wrox United Database
The Database Design
Players
Status
Teams
PlayerTeams
Positions
Games
GameTypes
Locations
Opponents
Fans
Installing the Database
Installing the Access Database
Installing the MSDE Database
Appendix D: Web Application Development using
Visual Studio .NET
Creating a Web Application Project
Features of the Visual Studio .NET Environment
Visual Studio .NET Solutions and Projects
Files in a Web Application Project
Working with Web Pages
Compiling and Running Pages
Adding Code to the Code-Behind Class
Features of Code View
Adding Code to Methods
Styling Controls and Pages in Visual Studio .NET
Working in HTML View
Creating User Controls
Formatting Blocks of Code
Developing the User Control
Creating an XML File
Adding a User Control to a Page
xx
753
754
756
757
757
758
759
760
760
763
763
764
765
765
765
766
766
767
768
768
768
769
769
770
775
776
777
778
779
779
782
784
784
785
791
797
798
803
804
806
809
Chapter
Title
Contents
Adding Custom Classes
Working with Databases Using the Server Explorer
Debugging in Visual Studio .NET
Using Breakpoints
Fixing Design-Time Errors
Suggested Exercises and Further Reading
Appendix E: Installing and Configuring IIS
Try It Out Locating and Installing IIS on Your Web Server Machine
Working with IIS
The Microsoft Management Console (MMC)
Testing Your Installation
Identifying Your Web Server's Name
Managing Directories on Your Web Server
Try It Out Creating a Virtual Directory and Setting Up Permissions
Permissions
Browsing to a Page on Your Web Server
Index
810
812
815
815
816
818
819
820
822
822
823
824
825
827
831
836
841
xxi
Introduction
ASP.NET is a radical update of Microsoft's Active Server Pages (ASP). ASP.NET is a powerful server
based technology designed to create dynamic and interactive HTML pages on demand for your
World Wide Web site or corporate intranet. It is designed to improve upon nearly every feature of
classic ASP, from reducing the amount of code you need to write to giving you more power and
flexibility.
ASP.NET also constitutes a key element in Microsoft's .NET Framework, providing Web-based
access to the immensely powerful .NET development environment. It allows us to create Web
applications in a new, flexible way by placing commonly used code into reusable controls of
various kinds that can be fired by events initiated by our site's users.
ASP.NET branches out into many other technologies, such as Web Services, ADO.NET, custom
controls, and security. We will briefly touch upon its relationship with these fields throughout the
book to provide a solid, comprehensive understanding of how ASP.NET can benefit your work in
a practical way.
ASP.NET 1.1 itself is a fairly light update to the complete wholesale changes that occurred in
ASP.NET 1.0. This book by and large covers features that are available in both 1.0 and 1.1, but it
does cover the pertinent new features of 1.1 that will be of interest to the novice user. So if you are
already running ASP.NET 1.0, you will be expected to upgrade to 1.1.
By the end of this book you will be familiar with the anatomy of ASP.NET 1.1 and be able to create
powerful, secure, and robust Web sites that can collect and work with information in a multitude
of ways to the benefit of both yourself and your users.
Introduction
Who Is this Book For?
The purpose of this book is to teach you from scratch how to use ASP.NET to be able to write Web pages
and Web applications whose content can be programmatically tailored each time an individual client
browser calls them up. This not only saves you a lot of effort in presenting and updating your Web
pages, but also offers tremendous scope for adding sophisticated functionality to your site. As ASP.NET
is not a programming language in its own right, but rather a technology (as we shall explain in the
book), we will be teaching some basic programming principles in Chapters 2 to 7 in Visual Basic.NET, our
chosen language for implementing ASP.NET.
This book is therefore ideal for somebody who knows some basic HTML but has never programmed
before, or somebody who is familiar with the basics of old style ASP, but hasn't investigated ASP.NET in
any detail. If you are an experienced programmer looking for a quick crash course on ASP.NET, or
somebody who's worked extensively with ASP, we suggest that you refer to Professional ASP.NET 1.1
Special Edition, Wiley, ISBN: 0-7645-5890-0 instead, as you'll most likely find that the early chapters here
just reiterate things you already know. If you are not familiar with HTML, then we suggest that you
master the basics of building Web pages before moving on to learning ASP.NET.
What Does this Book Cover?
This book teaches everything the novice user will need to know, from installing ASP.NET and the
relevant information for creating pages and putting together the concepts to create a whole application
using ASP.NET 1.1.
Although ASP.NET 1.1. isn't a huge update from version 1.0, this book has been considerably
overhauled since edition 1.0. Some of the old chapters have been removed and new ones introduced.
We've removed three chapters because we wanted to simplify the experience of learning ASP.NET. We've
created a brand new case study – an amateur sports league Web site – which is then used throughout
the later chapters in the book.
If you compare the previous edition, you will find this one to be more cohesive, aimed towards the
complete novice and the developer with some ASP experience, and written with the benefit of hindsight
from experienced developers who have have been employed in creating ASP.NET applications. We trust
that you will find it a great improvement over the last, just as every new edition should be.
In the course of this book you will learn:
2
❑
What is ASP.NET
❑
How to install ASP.NET and get it up and running
❑
The structure of ASP.NET and how it sits on the .NET Framework
❑
How to use ASP.NET to produce dynamic, flexible, interactive Web pages
❑
Basic programming principles, such as variables, controls structures, procedural programming,
and objects
❑
How to use ASP.NET to interface with different data sources, from databases to XML
documents
Introduction
❑
What ready-made controls ASP.NET offers for common situations
❑
How to create your own controls
❑
How to debug your ASP.NET pages
❑
How to deal with unexpected events and inputs
❑
How to create your own Web application
❑
How to integrate your applications with Web Services, and create your own Web Services
❑
Some simple security features and how to create a login for an application
How this Book Is Structured
Here is a quick breakdown of what you will find in this book:
❑
Chapter 1 – Getting Started with ASP.NET: In the first chapter we introduce ASP.NET and look at
some of the reasons that you'd want to use server-side code for creating Web pages and the
technologies that are available to do so. This done we spend the bulk of the chapter explaining
the ASP.NET installation process in detail, how to install a Web server to run ASP.NET on (we
will be using the Web server that accompanies Web Matrix), along with the ancillary installation
of MDAC. We finish up with a simple ASP.NET example page to check that our installation is
working correctly.
❑
Chapter 2 – Anatomy of an ASP.NET Page: Having completed the installation in the previous
chapter, we consider the structure of an ASP.NET page and the way that it functions in relation
to the .NET Framework. We use examples to demonstrate how the ASP.NET module parses the
page.
❑
Chapter 3 – Server Controls and Variables: Having acquainted ourselves with the basics of
ASP.NET controls this chapter considers the use of variables for holding data in Visual Basic
.NET. We look at how variables are implemented, what they can contain, and how they can be
placed into your ASP.NET pages.
❑
Chapter 4 – Control Structures and Procedural Programming: This chapter takes a whirlwind tour
of the key building blocks of VB.NET in the context of an ASP.NET page. We learn how to make
our ASP.NET pages more responsive through the use of VB.NET branching and looping
structures that enable us to control the order in which our program's statements execute.
❑
Chapter 5 – Jumping Structures, Subroutines, and Functions: We cover how the
modularization and reusable ASP.NET code works in this chapter. We look at subroutines and
functions and how they are used together with Web controls. We learn how to pass parameters
within ASP.NET pages and the different ways in which ASP.NET can handle them.
❑
Chapter 6 – Event-Driven Programming and Postback: We talk about how ASP.NET revolves
around an event-driven model, and how things occur in strict order and ways in which the
ASP.NET page can react to user intervention. We also look at the concept of postback and how it
is used to send information back from the user to the Web server, to preserve the "state" of a
page.
3
Introduction
❑
Chapter 7 – Objects: This chapter deals with the thorny subject of objects. ASP.NET pages derive a
great deal of their flexibility and power from the object-oriented way they are structured. This chapter introduces concepts such as properties, methods, constructors, collections,
andoverloading using plentiful examples relating to real-world objects to aid your
understanding. We also discuss the concepts that make objects very powerful, such as
inheritance and encapsulation, and how they greatly reduce the amount of code you need to use.
❑
Chapter 8 – Reading from Databases: At this point in the book we're familiar with the basic
anatomy of ASP.NET pages and objects, so we branch out to look at ADO.NET in the context of
ASP.NET. Most specifically we look at the use of the Connection and Command objects for
opening data sources and retrieving information into DataSets.
❑
Chapter 9 – Advanced Data Handling: Having mastered the basics of reading data in the
previous chapter we take things much further; looking in detail at the way we can manipulate
the information in DataTables and DataSets, and store the results back to the data source from
which they came.
❑
Chapter 10 – ASP.NET Server Controls: This chapter explains how ASP.NET server controls
derive their properties and methods from the various classes and objects that make up the .NET
Framework. It explains the syntax required to make their functionality available, together with a
look at the benefits that these controls can give. We also start to create the Wrox United
application case study that is used throughout the rest of the book.
❑
Chapter 11 – Users and Applications: This chapter deals mainly with the process of tracking users
across pages. We look at the objects that ASP.NET uses to enable this. We also tie this into our
case study by creating the facility for adding valid email addresses and passwords to a site via
an admin interface, and then we play the part of one of those users logging in and viewing
pages.
❑
Chapter 12 – Reusable Code for ASP.NET: Here we consider the great benefits that can be
achieved by encapsulating our code to make it more maintainable. Firstly we cover the idea of
user controls designed to store sections of your ASP.NET code that are repeated on multiple
pages of your site before going on to consider the idea of code behind, where the
block of our ASP.NET code is placed in its own file in order to separate the page's logic from its
presentation.
❑
Chapter 13 – .NET Assemblies and Custom Controls: We continue the ideas of the previous
chapter here. We cover how to compile a .NET assembly and use it from within our ASP.NET
page, as well as how to encapsulate our business logic into a component that can be reused on
other projects.
❑
Chapter 14 – Debugging and Error Handling: No matter how careful you are, things can always
go wrong within your code. This chapter explains the steps you can take to minimize these
occurrences and how to recover when things go wrong.
❑
Chapter 15 – Configuration and Optimization: We start by explaining how ASP.NET applications
can be managed from a series of XML configuration files, and then our discussion takes a more
general turn as we consider the many ways that you can streamline and speed-up your
ASP.NET applications.
❑
Chapter 16 – Web Services: You learn how to expose functionality from your Web site to others as
a Web Service. We then discuss how this functionality can be discovered by other users of the
Web, and the form that the data exchange takes.
4
Introduction
❑
Chapter 17 – ASP.NET Security: We conclude the book with a quick overview of some of the
simple precautions that you can take using forms authentication and authorization to safeguard
your ASP.NET pages and ensure that they're only accessed by authorized users in the way that
you want them to be accessed.
What Do You Need to Use this Book?
The only prerequisite for this book is to have a machine with the .NET Framework installed upon it. This
means that you'll need to be running Windows 2000 Professional or Server, Windows XP (either
Professional or Home edition) or Windows 2003 Server.
The .NET Framework itself is available as a free download from http://www.asp.net/ and
http://www.gotdotnet.com. This download is known as the .NET Framework Redistributable and its
approximate size is 20Mb. It includes everything you need to run any .NET application.
Also available is another complementary free download, which might be useful to you throughout the
book, although not essential. This is the .NET Framework SDK (Software Development Kit) and it
contains samples and tutorials that you can refer to in order to learn more about .NET, as well as some
useful tools, some of which we make use of in the book. However it doesn't include the .NET
Framework. The SDK is of size 130Mb approximately.
This book is designed with Web Matrix in mind, so we strongly suggest that you download this as well.
Web Matrix is a free download also available from http://www.asp.net. It will provide you with a Web
server capable of running ASP.NET if you haven't already got one. However while this book has been
designed with Web Matrix in mind, you will find that all of the examples can be created, run, and
understood using any simple text editor such as Notepad, although the instructions will be geared to the
point of view of someone who is running Web Matrix.
Windows XP Home Edition does not support IIS, so if you use this version of Windows, you will have
to download Web Matrix.
You do not need Visual Studio .NET in order to use this book.
Conventions
To help you get the most from the text and keep track of what's happening, we've used a number of
conventions throughout the book.
Boxes like this one hold important, not-to-be forgotten information that is directly relevant to the surrounding text.
While this background style is used for asides to the current discussion.
5
Introduction
As for styles in the text:
❑
When we introduce them, we italicize important words
❑
We show filenames and code within the text like so: persistence.properties
❑
We present code in two different ways:
In code examples, the Code Foreground style shows new, important, pertinent
code.
The Code Background style shows code that's less important in the present
context, or has been shown before.
Source Code
As you work through the examples in this book, you may choose either to type in all the code manually
or to use the source code files that accompany the book. All of the source code used in this book is
available for download at http://www.wrox.com. Once at the site, simply locate the book's title (either by
using the Search box or by using one of the title lists) and click the Download Code link on the book's
detail page to obtain all the source code for the book. Because many books have similar titles, you may
find it easiest to search by ISBN, which for this book is 0764557076. Once you download the code, just
decompress it with your favorite compression tool. Alternately, you can go to the main Wrox code
download page at http://www.wrox.com/dynamic/books/download.aspx to see the code available for this
book and all other Wrox books.
Errata
We make every effort to ensure that there are no errors in the text or in the code. However, no one is
perfect, and mistakes do occur. If you find an error in one of our books, like a spelling mistake or faulty
piece of code, we would be very grateful for your feedback. By sending in errata you may save another
reader hours of frustration, and you will be helping us provide even higher quality information.
To find the errata page for this book, go to http://www.wrox.com and locate the title using the Search box
or one of the title lists. Then, on the book details page, click the View Errata link. On this page, you can
view all errata that has been submitted for this book and posted by Wrox editors. A complete book list
including links to each book's errata is also available at www.wrox.com/misc-pages/booklist.shtml.
If you don't spot your error on the View Errata page, go to www.wrox.com/contact/techsupport.shtml and
complete the form there to send us the error you have found. We'll check the information and, if
appropriate, post a message to the book's errata page and fix the problem in subsequent editions of
the book.
6
Introduction
p2p.wrox.com
For author and peer discussion, join the P2P forums at p2p.wrox.com. The forums are a Web-based
system for you to post messages relating to Wrox books and related technologies and interact with other
readers and technology users. The forums offer a subscription feature to email you topics of interest of
your choosing when new posts are made to the forums. Wrox authors, editors other industry experts,
and your fellow readers are present on these forums.
At http://p2p.wrox.com you will find a number of different forums that will help you not only as you read
this book, but also as you develop your own applications.
You can read messages in the forums without joining P2P, but in order to post your own messages, you
must join the forum.
To join the forums:
1.
2.
3.
4.
Go to p2p.wrox.com and click the Register link.
Read the terms of use and click Agree.
Complete the required information to join as well as any optional information you wish to
provide and click Submit.
You will receive an email with information describing how to verify your account and complete
the joining process.
Once you have joined, you can post new messages and respond to messages other users post. You can
read messages at any time on the Web. If you would like to have new messages from a particular forum
emailed to you, click the Subscribe to this Forum icon by the forum name in the forum listing.
For more information about how to use the Wrox P2P be sure to read the P2P FAQs; they answer
questions about how the forum software works as well as many common questions specific to P2P and
Wrox books. To read the FAQs, click the FAQ link on any P2P page.
7
1
Getting Started With
ASP.NET
ASP.NET is a powerful and flexible technology for creating dynamic Web pages. It's a convergence
of two major Microsoft technologies, Active Server Pages (ASP) and the .NET Framework. ASP (or
classic ASP as it's often referred to), is a relative old-timer on the Web computing circuit and has
provided a sturdy, powerful, and effective way of building dynamic Web pages for seven years or
so now. The .NET Framework, on the other hand, is a whole suite of technologies designed by
Microsoft with the aim of revolutionizing the way in which all programming development takes
place and the way companies carry out business. ASP.NET is a way of creating dynamic Web
pages while making use of the innovations present in the .NET Framework.
The first important thing to know about ASP.NET is that you don't need any ASP skills to learn it.
All you need is a little HTML knowledge for building Web pages. In fact, knowing ASP could be a
disadvantage in some ways because you may have to unlearn some of the principles you followed
earlier. ASP.NET allows you to build dynamic Web pages and tailors the HTML output to the
browser you're using. It also comes with a great set of reusable, predefined, and ready to use
controls for your ASP.NET projects. These reduce the amount of code you have to write, so you
can be more productive while programming.
So, what can you do with ASP.NET? It may be easier to list what you can't, as that is arguably
shorter! One of the most eye-catching things about ASP.NET is the way you can use any
programming language based on the .NET Framework, such as VB .NET, JScript.NET, or C# to
create your Web applications. Within these applications, ASP.NET allows you to customize pages
for a particular user, and makes it simpler to keep track of a particular user's details as they
move around.
ASP.NET makes storing information to a database or self-describing XML document faster and
easier. You can alter the layout of the page using a free Web page editor – Web Matrix – designed
to be used with ASP.NET, rather than having to position everything manually within code, and
even alter the contents of files on your machine, if you have the correct permissions.
Chapter 1
In addition, you can use bits and pieces of other applications without downloading the whole
application. For example, you can access a zip code verifier that is part of another Web site's features,
without having to download the whole application or even giving your users the impression that
they've left your site (Chapter 16 will cover Web Services as well as accessing specific features of your
application via the Web). With ASP.NET, the applications that you create are only limited by your
imagination.
This chapter will cover the installation process of ASP.NET, Web Matrix, and the .NET Framework. Let's
start with a quick introduction to the world of Web servers, dynamic Web pages, and a little bit about
what ASP.NET is. This will help accomplish the main aim of this chapter – to get you running a fully
functional Web server, with a fully functional ASP.NET installation. We will create a short ASP.NET test
page to check that both the Web server and ASP.NET are working as intended. We'll also look at some of
the most common pitfalls encountered.
The topics discussed in this chapter are:
❑
Static Web pages
❑
Dynamic Web pages
❑
What is ASP.NET?
❑
Installing the .NET Framework
❑
Installing Web Matrix
❑
Testing and troubleshooting your installation
What Is a Static Web Page?
If you surf the Web, you'll see many static Web pages. Essentially, this type of Web page consists of some
HTML code typed directly into a text or Web page editor and saved as a .htm or .html file. Thus, the
author of the page has already determined the exact content of the page, in HTML, at some time before
any user visits the page.
Static Web pages are often easy to spot; sometimes you can pick them out by just looking at the content
of the page. The content (text, images, hyperlinks, and so on) and appearance of static Web pages is
always the same – regardless of who visits the page, or how and when they arrive at the page, or any other
factors.
10
Getting Started With ASP.NET
For example, you can create a page called Welcome.htm for your Web site, by writing some simple
HTML like this:
A Welcome Message
Welcome
Welcome to our humble website. Please feel free to view our
list of contents.
If you have any difficulties, you can
send email to the webmaster.
Whenever a client comes to your site and views this page, it will look like the screenshot depicted in
Figure 1-1:
Figure 1-1
The content of the page was determined before the request to view the page was made – in fact, it was
determined at the time the Webmaster saved the .htm file to disk.
11
Chapter 1
How Are Static Web Pages Served?
Let's think for a moment about how a static, pure HTML page finds its way to a client browser (the
process is depicted in Figure 1-2):
WEB SERVER
3. Web server locates .html file
1. Author writes HTML
4. HTML stream (from .html page)
returned to browser
2. Client requests
web page
5. Browser processes HTML
and displays page
CLIENT
Figure 1-2
1.
A Web author writes a page using only HTML and saves it within an .htm file on the Web
server.
2.
Sometime later, a user types a page request (URL) into a browser, and the request passes from the
browser to the Web server.
3.
4.
5.
The Web server locates the .htm page and converts it to an HTML stream.
The Web server sends the HTML stream back across the network to the browser.
The browser processes the HTML and displays the page.
Static, pure-HTML files like Welcome.htm make perfectly serviceable Web pages. You can even spruce
up the presentation and usability of such pages by adding more HTML to alter fonts and colors.
However, there are limitations with what you can achieve with pure-HTML pages because their content
is completely determined before the page is requested. There's no facility for user interaction or dynamic
responses (even simple objects like forms and buttons require more than just HTML to make them
work).
12
Getting Started With ASP.NET
Limitations of Static Web Pages
Static Web pages limit you in several ways. For example, suppose you want to enhance your Welcome
page so that it displays the current time or a special personalized message for each user. These are
simple alterations, but they are impossible to achieve using HTML alone. If you're not convinced, try
writing HTML for a Web page that displays the current time as shown in Figure 1-3:
Figure 1-3
As you type in the HTML, you'll soon realize the problem – you know that the user will request the page
sometime, but you don't know what time they will do it! Hardcoding the time into your HTML will result
in a page that always shows the same time (that will almost always be wrong). In other words, you're
trying to write pure HTML for a Web page that displays the time, but you can't be sure of the exact time
that the Web page should display until the time the page is requested. This can't be done using HTML
alone.
HTML offers no features for personalizing your Web pages; the same Web page is served to every user.
There's also no security with HTML; the code is there for everybody to view, and there's nothing to stop
you from copying somebody else's HTML code and using it in your own Web page. Static pages can be
very fast, as quick as copying a small file over a network, but they cannot provide any dynamic features.
Since you can't create this page by saving hard-coded HTML into a file before the page is requested, what
you need is a way to generate the HTML after the page is requested. There are two ways of doing this;
we'll look at both of them in this chapter. However, before going any further let's make sure everybody
is up to speed on the terminology we've introduced here.
13
Chapter 1
What Is a Web Server?
Web servers are software that manage Web pages and make them available to client browsers – via a