Pro CSharp And The .NET 2.0 Platform (2005) [eng]

974■I N D E X

public access modifier, 77 publisher policy assemblies, 384–85 push and pop, 480, CIL

■Q

Query Analyzer, SQL Server, 775

Queue System.Collections class type, 250–52

■R

RadioButton control, 711, 713 RangeValidator control, ASP.NET, 884, 886 reachable objects, 180

Read( ) method BinaryReader class, 538

Stream class, System.IO, 532 TextReader, System.IO, 535

ReadBlock( ) method, TextReader, System.IO, 535 ReadByte( ) method, Stream class, System.IO,

532

reading

cookies, ASP.NET, 911–12 resources, 697

from a text file, 535

ReadLine( ) method, TextReader, System.IO, 535 read-only class properties, 153–54

readonly keyword, 82–83 ReadOnly property

ADO.NET DataColumn object, 797 UpDownBase, 728

ReadToEnd( ) method, TextReader, System.IO, 535

ReadXml( ) method, ADO.NET DataSet class, 795

ReadXmlSchema( ) method, ADO.NET DataSet class, 795

ready state, Menu selection in Visual Studio 2005, 639

real proxy, remoting, 568

Rectangle(F) type, System.Drawing namespace, 652–53

Redirect( ) method, ASP.NET HTTP Response, 860

redirecting users, ASP.NET, 861

ref method parameter modifier, 89–91 reference types, 96–100, 103–4 references

differences from classes and objects, 179 memory management using, 180–81 new keyword, 180

reflection, 395

Region class, System.Drawing namespace, 653 Register( ) method, ILease interface remoting,

593 RegisterActivatedClientType( ) method,

RemotingConfiguration, 580 RegisterChannel( ) method, remoting

ChannelServices, 579

registered data provider factories, ADO.NET, 771–72

RegisteredChannels property, remoting ChannelServices, 579 RegisterWellKnownClientType( ) method,

RemotingConfiguration, 580 RegisterWellKnownServiceType( ) method,

RemotingConfiguration, 580 registration of events, 279–81 RegularExpressionValidator control, ASP.NET,

884, 886

RejectChanges( ) method, ADO.NET DataSet class, 795

remoting

alternative hosts, 597 assemblies required, 574–75 asynchronous invocation, 602–3

automatic server-side loading, 597 CAO activation, 572–73

channels, 568–69 ChannelServices, 579 client-activated, 590–91

client-side configuration files, 585–86 configuration files, 584

default layers, 570 definition, 565

deploying remote server, 582 deployment, 574–75

determining MBR runtime information, 580–81

dispatcher, 569

example application, 575–78 formatters, 569

garbage collection, 592–97 hosting using IIS, 601–2 HTTP channel, 568

IIS hosting, 597

installing a Windows service, 600–601 IPC channel, 568, 583

lease configuration, 594–96 lease sponsorship, 596 lease-based lifetimes, 592–97 marshaling, 570

MBV objects, 586–89 namespaces, 566–67

.NET Framework architecture, 567 one-way invocation, 604 overview, 565

proxies and messages, 567–68 real proxy, 568

server-side configuration files, 584–85 singleton WKO activation, 573 singleton WKO and multiple clients,

581–82

TCP channel, 568, 582–83 transparent proxy, 567

Windows service construction, 597, 599 WKO activation, 572–73

WKO and CAO configuration summary, 574 RemotingConfiguration, 580 RemotingFormat property, ADO.NET DataSet

class, 795

976■I N D E X

SharpDevelop IDE Assembly Scouts, 48

compiling common intermediate language (CIL), 486

download link, 46 features, 47

installing or compiling, 46 overview, 46

Project and Classes Scouts, 47 Windows Forms Designers, 49–50

shopping cart application, ASP.NET, 906–8 single call WKO activation, remoting, 573 single file code model, ASP.NET, 842–43 single-file assemblies, 11

singleton WKO activation, remoting, 573 sink object, callback interfaces, 256–57, 259 Size property, ADO.NET DbParameter, 789 sizeof keyword, 316

SkinID property, System.Web.UI.Control in ASP.NET, 867

Sleep( ) method, Thread type, 460 SmallChange property, TrackBar control, 724 Smalltalk .NET programming language, 8 sn.exe, strong name utility, 371, 373, 375–76 SOAP bindings, 941–42

SOAP transport of web service, 922 SoapFormatter, serialization, 548, 552 SoapHttpClientProtocol class, 944–45 SoapVersion property, WebService base class,

929

software development, 3–5

sort order of tables, ADO.NET, 807–8 Sorted property, DomainUpDown, 728

SortedList System.Collections class type, 250 sorting and paging example, ASP.NET, 878–79 spawning child forms in MDI applications,

647–48 SponsorshipTimeout, ILease interface

remoting, 593

SQL command autogenerating, ADO.NET, 816–17

SQL for Fill( ) and Update( ), ADO.NET, data adapter, 811

stack, and value based types, 96

Stack System.Collections class type, 250, 252–53 stackalloc keyword, 314–15

stack-based programming, 480, CIL

StackTrace property, System.Exception, 200, 205 standard dialogs, System.Windows.Forms, 606 Start( ) method

System.Diagnostics.Process, 429 Thread type, 460

StartAddress, ProcessThread type, 432 starting and stopping a process example code,

434–35 StartTime

ProcessThread type, 432 System.Diagnostics.Process, 429

StartupPath property, Application class, 609 state data, multithreaded applications, 458

state management, 889–91

State property, DbConnection, ADO.NET, 779 stateful data, XML web services, 933, 935 stateless, description, HTTP, 830

static assemblies, 504

static class properties, 154–55 static keyword, 83–88

static readonly keywords, 83

static web service discovery using DISCO, 921 StatusBar vs. StatusStrip, 633

StatusStrip, Visual Studio 2005, 633–34, 636–37 stored procedures using DbCommand,

ADO.NET, 790–91 Stream class, System.IO, 531–32 StreamReader, StreamWriter

direct creation, 536 System.IO, 533

StreamWriter, StreamReader types, input/output, System.IO, 518

StringCollection, System.Collections.Specialized, 253

String.Concat( ) method, 124 StringDictionary,

System.Collections.Specialized, 253 StringEnumerator,

System.Collections.Specialized, 253 String.Format( ) method, 76

StringReader, StringWriter, System.IO, 536–37 strings

comparing, 124

internal .NET string processing, 126 iterating over, 124

StringWriter, StringReader types, input/output, System.IO, 518

strong names in assemblies, 348, 357, 371, 373–74

structures

common intermediate language (CIL), 491 and enumerations, value based types, 97 types, 16

in XML web services, 949–50 submitting form data, ASP.NET, 837–38

subsystem directive, common intermediate language (CIL), 489

Suspend() method, Thread type, 460 switch statement, 95–96 Synchronization attribute

context bound objects, 442 multithreaded applications, 472–73

synchronizing threads, 455–56 synchronous delegate call, 260 System data types, 117–18

System.Activator class, late binding, 406–7 System.AppDomain class

AssemblyLoad event, 436 AssemblyResolve event, 436 BaseDirectory( ), 436 CreateDomain( ), 435, 437 CreateInstance( ), 436 DomainUnload event, 436

978■I N D E X

System.Runtime.Remoting, remoting namespace, 566

System.Runtime.Remoting.Activation, remoting namespace, 566

System.Runtime.Remoting.Channels, remoting namespace, 566

System.Runtime.Remoting.Channels.Http, remoting namespace, 566 System.Runtime.Remoting.Channels.Ipc, remoting namespace, 566 System.Runtime.Remoting.Channels.Tcp, remoting namespace, 566

System.Runtime.Remoting.Contexts, remoting namespace, 566

System.Runtime.Remoting.Lifetime, remoting namespace, 566

System.Runtime.Remoting.Messaging, remoting namespace, 566

System.Runtime.Remoting.Metadata, remoting namespace, 566

System.Runtime.Remoting.MetadataServices, remoting namespace, 566

System.Runtime.Remoting.Metadata. W3cXsd2001, remoting namespace, 566

System.Runtime.Remoting.Proxies, remoting namespace, 567

System.Runtime.Remoting.Services, remoting namespace, 567

System.Serializable attribute, structured exception handling, 211

System.String data type, 123 System.SystemException, structured exception

handling, 208 System.Text.StringBuilder, 126–27 System.Threading Namespace

Interlocked type, 459 Monitor type, 459 Mutex type, 459

ParameterizedThreadStart delegate, 459, 462–63, 465–66

Semaphore type, 459 Thread type, 459–60 ThreadPool type, 459, 475–76 ThreadPriority enum, 459

ThreadStart delegate, 459, 463–64 ThreadState enum, 459

Timer type, 459

TimerCallback delegate, 459, 473–74 System.TimeSpan, 122

System.Type class, 396–97 System.ValueType, 97

System.ValueType, struct default base, 222 System.Web namespace, ASP.NET 2.0, 842 System.Web.Caching namespace, ASP.NET 2.0,

842

System.Web.Hosting namespace, ASP.NET 2.0, 842

System.Web.Management namespace, ASP.NET 2.0, 842

System.Web.Profile namespace, ASP.NET 2.0, 842

System.Web.Security namespace, ASP.NET 2.0, 842

System.Web.Services.Configuration, XML web services namespaces, 922

System.Web.Services.Description, XML web services namespaces, 922

System.Web.Services.Discover, XML web services namespaces, 922 System.Web.Services.Protocols, XML web services namespaces, 922

System.Web.ServicesXML web services namespaces, 922

System.Web.SessionState namespace, ASP.NET 2.0, 842

System.Web.UI.Control in ASP.NET, 867 System.Web.UI.Page, ASP.NET, 856 System.Web.UI.x namespace, ASP.NET 2.0, 842 System.Windows.Forms, 605–6, 699 System.Windows.Forms.ContainerControl,

Form object inheritance chain, 612 System.Windows.Forms.Control

core properties, 612–13 events, 613

Form object inheritance chain, 612 methods, 613–14

System.Windows.Forms.Form, Form object inheritance chain, 612

System.Windows.Forms.ScrollableControl, Form object inheritance chain, 612

■T

tab order for controls, 718 TabControl control, 722–23

Table, ADO.NET DataRow object, 798

Table property, ADO.NET DataColumn object, 797

TableLayoutPanel, controls, 756–57 Target property,

System.MulticastDelegate/System Delegate, 263

TargetSite property, System.Exception, 200, 204 TCP channel, remoting, 568, 582–83

template, exception code expansion, 211 text based Windows.Forms coding, 606 Text property, UpDownBase, 728 TextAlign property

Button, 709

Textbox, 705 UpDownBase, 728

TextBox control, 705–7 TextPad development editor, 41

C Shart Helpers clip library, 45 configuring for C#, 42–43 executing programs, 44 predefined run commands, 44–45

TextReader, System.IO, 535

TextureBrush, System.Drawing.Brush, 679–80

TextWriter, System.IO, 534

Theme, Page Type properties, ASP.NET, 857 this keyword, 142–43

this[ ] syntax, indexer technique, 290–91 ThousandsSeparator property,

NumericUpDown, 728 Thread type, 449, 459–62

ThreadExit event, Application class, 609 Thread.GetDomain( ), 449

ThreadPool type, System.Threading Namespace, 459, 475–76

ThreadPriority enum, System.Threading Namespace, 459

threads

example code, 430–31 hyperthreading, 427 multithreading, 426 overview, 426

suspended during garbage collection, 182 Thread Local Storage (TLS), 427

time slice, 427

Threads, System.Diagnostics.Process, 429 ThreadStart delegate, System.Threading Namespace, 459, 463–64

ThreadState enum, System.Threading Namespace, 459

ThreadState method, Thread type, 460 ThreeState property, Button, 711 ThrowException( ) method,

System.Reflection.Emit.ILGenerator,

506

TickFrequency property, TrackBar control, 724 TickStyle property, TrackBar control, 724

time slice, 427

Timeout( ) method, SoapHttpClientProtocol class, 945

Timer type, System.Threading Namespace, 459 Timer, Visual Studio 2005, 637–38 TimerCallback delegate, System.Threading

Namespace, 459, 473–74

tokens

formatting output, 74–75

in MaskedTextBox control, 707 ToolBar components in ToolStrips, 639–41

ToolStripMenuItem types, Visual Studio 2005, 632–33

ToolStrips in Visual Studio 2005, 639–41 ToolTip control, 721–22

ToString( ), System.Object instance-level member, 112

TotalProcessorTime, ProcessThread type, 432 Trace, ASP.NET <%@Page%> directive attribute,

846

trace element attributes, Web.config, ASP.NET, 913

trace element, Web.config, ASP.NET, 913–14 Trace, Page Type properties, ASP.NET, 857 TrackBar control, 724–26

Transaction object, ADO.NET data providers, 761

■I N D E X 979

transforming XML documentation to HTML, 177

transparent proxy, remoting, 567 TreeView controls, 731–36

type constructors, common intermediate language (CIL), 494

type reflection AssemblyRef, 394 description, 395

example metadata, 393–94 external private assemblies, 402–3 fields and properties, 398 implemented interfaces, 399

metadata and type reflection, 391–92 method parameters and return values, 401–2 methods, 398

other metadata, 399 overview, 391

shared assemblies, 404–6 TypeDef, 392

TypeRef, 392 User Strings, 395

TypeBuilder, System.Reflection.Emit namespace, 505

typed exceptions, structured exception handling, 217

TypeDef, 392 typeof operator, 398 TypeRef, 392

TypeResolve event, System.AppDomain, 436 types

access modifiers, 78 definition, 15 determining, 172

five categories of, 15–17 parameters, 321 visibility, 78

types element, WSDL document elements, 937

■U

UDDI discovery of XML web services, 953–54 UDDI web service discovery, 921

unbound type parameters, 335–36 unboxing. See boxing and unboxing unchecked keyword, 309

unhandled exceptions, structured exception handling, 217

UnhandledException event, System.AppDomain, 436

Unique property, ADO.NET DataColumn object, 797

unit of measure, GDI+, 660 Unload( ), System.AppDomain, 436 Unload, ASP.NET Page events, 862 Unlock( ) method, ASP.NET

HttpApplicationState member, 898 unmanaged resources, 185, 189–95 Unregister( ) method, ILease interface

remoting, 593

980■I N D E X

UnregisterChannel( ) method, remoting ChannelServices, 579

unsafe compiler flag, 310 unsafe keyword, 311–12

Update( ) method, ADO.NET, data adapter, 811 UpdateCommand property in updating,

ADO.NET, 815 updating

applications using shared assemblies, 378–79 records, ADO.NET, 787

rows, ADO.NET, 809

using data adapter objects, ADO.NET, 813–15 UpDown control, 727, 729

UpDownAlign property, UpDownBase, 728 UpDownBase, 728

Url( ) method, SoapHttpClientProtocol class, 945

user errors, 197

user interface in HTML, 834–35

UserAgent( ) method, SoapHttpClientProtocol class, 945

UserControl Test Container, 743 user-defined type (UDT), definition, 69–70 using keyword, 136–37, 192–93 UsingNamespace( ) method,

System.Reflection.Emit.ILGenerator,

506

■V

Validated, control class property, 730 ValidateInput( ) method, ASP.NET HTTP

Request, 858

Validating, control class property, 730 validating form data, ASP.NET, 837 validation controls, ASP.NET, 884–87

ValidationSummary control, ASP.NET, 884, 887 value and reference types, conversion, 104–6 value, contentual keyword, 151

Value property

ADO.NET DbParameter, 789 NumericUpDown, 728 TrackBar control, 724

value types, 96–100, 103–4

variables, local, common intermediate language (CIL), 498

VB6 language deficiencies, 4 VB.NET operator overloading, 300 verbatim strings, 125

version number of assemblies, 348 view objects, ADO.NET, 810

view state, state management in ASP.NET, 891–93 Vil development tool, 62

virtual execution stack, 480, CIL virtual keyword, description, 163–64

Visible property, System.Web.UI.Control in ASP.NET, 867

Visual Basic .NET integration with C#, 360, 362, 364–65

Visual Basic snap-in example, 420–21

Visual C# 2005 Express, 51 Visual Studio 2005

additions available, 52 automated coding support, 57 Class View, 53

Code Definition window, 54 code refactoring support, 55

ContextMenuStrip controls, 626, 630–32 deprecated controls, 623

designer.cs form file, 624

event handling in ToolStrips, 643 event registration, 280–81

form files in a project, 623 forms designer, 621 FxCop, 62

generating resources, 694–95, 697 handling events, 625

images in ToolStrips, 641–43 integrated Help system, 60–61 interface implementation, 234–35 Lutz Roeder’s Reflector for .NET, 62 MDI applications, 646

menu items in controls, 632 Menu selection prompts, 639 Menu selection ready state, 639 menu systems, 634, 636–37 MenuStrip controls, 626–28, 630 NAnt, 62

NDoc, 62

.NET 1.x controls, 623 Nunit, 62

Object Browser, 54 Object Test Bench, 60 overview, 51, 621 Program class, 625

project configuration (Project Properties), 53 project templates, 621

properties window, 622 refactoring example, 56

refactoring techniques available, 55 Snippets automated coding, 57 Solution Explorer, 52

StatusStrip, 633–34, 636–37 Surround With automated coding, 57 Timer, 637–38

Toolbox, 621

ToolStrip containers, 643, 645 ToolStripMenuItem types, 632–33 ToolStrips, 639–41

Vil, 62

Visual Class Designer, 57–59

■W

WaitReason, ProcessThread type, 432 Web Application Administration utility,

ASP.NET, 916–17 web applications in ASP.NET

application cache, 901 application level state data, 898–99

982 ■I N D E X

generating server-side code, 943 /language flag, 942, 944 /namespace flag, 942

/out flag, 943 /protocol flag, 943–44

/serverInterface flag, 943

WSI basic profile (BP 1.1) conformance, XML web services, 932

WsiProfiles enumeration, XML System.Web.Services namespace, 923

■X

Xcopy deployment, 365 XML

and ADO.NET, 759

code comment format characters, 177 /doc compiler flag, 177 documentation elements, 175

source code documentation, 175–77 transforming to HTML, 177

XML System.Web.Services namespace, 923 XML web services. See also WSDL (Web Service

Description Language) <%@WebService%> directive, 923 ADO.NET datasets using web methods, 950 arrays using web methods, 949 asynchronous invocation, wsdl.exe utility,

946–47

autogenerated test page, 925 benefits, 919–20

client architecture, 920 client-side representation, 952–53 custom test page, 925–26

custom types using web methods, 948 default constructor, wsdl.exe utility, 945 DefaultWsdlHelpGenerator.aspx, 925–26 Description property, 930

description service, description, 921 DISCO UDDI directory, 921 discovery service, description, 921

dynamic web service discovery using DISCO, 921

example application, wsdl.exe utility, 947 example web service, 928–29

HTTP GET, 940

HTTP POST, 940

HTTP SOAP, 940

HTTP transport, 922 HTTP use, 919–20 IIS deployment, 925

machine.config file, 940 manual web service coding, 923 Name property, 930 Namespace property, 930 namespaces, 922

overview, 919

vs. proprietary wire protocols, 919–20 proxy code using Visual Studio 2005, 947–48 role, 919–20

session state and web.config, 935 SOAP body, 941

SOAP envelope, 941–42 SOAP transport, 922 stateful data, 933, 935

static web service discovery using DISCO, 921

structures using web methods, 949–50 synchronous invocation, wsdl.exe utility, 946 System.Web.Services namespace, 922 transport protocal, description, 921

UDDI and Visual Studio .NET, 954 UDDI discovery, 921, 953–54 using Visual Studio.NET, 926–28 viewing SOAP messages, 942

Web Service Description Language (WSDL), 935

web.config and session state, 935 web.config file, 941 WebDev.WebServer.exe, 924 WebMethod attribute, 923, 932 WebService base class, 929 WebServiceAttribute, 929–30 WebServiceBinding attribute, 931 Windows Forms clients, 951–52 wire protocols, 940

wsdl.exe utility, 942–47

WSI basic profile (BP 1.1) conformance, 932 XmlAttributeAttribute, XmlSerializer, 554 XmlElementAttribute, XmlSerializer, 554 XmlEnumAttribute, XmlSerializer, 554 XmlRootAttribute, XmlSerializer, 554 XmlSerializer, 548–49, 553–55 XmlTextAttribute, XmlSerializer, 554