Register your product to gain access to bonus material or receive a coupon.
This is a complete, authoritative, and truly useful reference for every .NET developer. It covers every aspect of .NET Framework library by providing concise descriptions with just the right number of examples. I would not start development of any significant .NET project without having this book on my bookshelf.
Max Loukianov, Vice President of Research and Development, Netpise Inc.
The .NET Framework Standard Library Annotated Reference is the one reference you really need when you use the .NET Framework library. The annotations provide clear insight into the design choices that the library development team made when building the library. Those explanations will guide you to the best design choices for your own application code.
Bill Wagner, Founder/Consultant, SRT Solutions, and author of Effective C#
More than just a reference, this book provides great insight into the massive amount of thought that went into designing the Microsoft .NET Framework. It is both entertaining and educational, combining interesting and sometimes amusing annotations along with the reference material.
Jordan Matthiesen, Software Engineer
Brad Abrams, Tamara Abrams, and the CLR team take readers on a journey through the backstreets of the .NET Framework, pointing out invaluable design decisions and performance best practices along the way. Not to be missed by any developer who has ever wondered why the Framework is designed the way it is.
William D. Bartholomew, Senior Software Architect, Orli-TECH Pty Ltd
This volume provides an in-depth review for every class method listed, including a CD with many examples of usage. The most valuable aspect of this book is the annotations provided; the annotators thoughts about the design of the .NET Framework lets the reader develop a crystal-clear understanding of what can be accomplished with this fantastic technology.
Bradley Snobar, Software Engineer
The utility of a reference book is often a function of how easily you can find a desired subject and, once there, how clearly is it explained. On both counts, you should find that this book stands well.
Dr. Wes Boudville, Inventor
The .NET Framework Standard Library Annotated Reference, Volume 2, completes the definitive reference to the .NET Framework base class library. This book-and-CD set offers programmers unparalleled insight into the ECMA and ISO specifications for the classes and members, while also explaining why they were designed as they were and demonstrating how to use them. This volume covers the Networking, Reflection, and XML libraries, complementing Volume 1s coverage of the Base Class and Extended Numerics libraries.
The printed book contains high-level descriptions of each namespace, plus detailed descriptions and samples of each type, including annotations, inheritance diagrams, and a listing of members.
The accompanying CD contains a vastly expanded version of the books text that includes detailed descriptions of each member and samples for most membersalmost two thousand searchable pages of immediately useful reference material, plus a full source-code archive.
With the ECMA and ISO standards as its core, the combined book and CD include
Download the Sample
Chapter related to this title.
Foreword.
Preface.
Annotators' Biographies.
I: NAMESPACE OVERVIEWS.
System
System.Collections.Specialized
System.Globalization
System.Net
System.Reflection
System.Runtime.CompilerServices
System.Runtime.InteropServices
System.Security.Permissions
System.Xml
II: CLASS LIBRARIES.
System.Net.Sockets.AddressFamily Enum
System.Reflection.AmbiguousMatchException
System.AppDomain
System.Reflection.Assembly
System.AssemblyLoadEventArgs
System.AssemblyLoadEventHandler Delegate
System.Net.AuthenticationManager
System.Net.Authorization
System.BadImageFormatException
System.Reflection.Binder
System.Reflection.BindingFlags Enum
System.Runtime.InteropServices.CallingConvention Enum
System.CannotUnloadAppDomainException
System.Runtime.InteropServices.CharSet Enum
System.Reflection.ConstructorInfo Structure
System.Net.CredentialCache
System.Globalization.CultureInfo
System.Runtime.CompilerServices.DecimalConstantAttribute
System.Reflection.DefaultMemberAttribute
System.Runtime.InteropServices.DllImportAttribute
System.Net.Dns
System.Net.DnsPermission
System.Net.DnsPermissionAttribute
System.Net.EndPoint
System.EntryPointNotFoundException
System.Reflection.EventAttributes Enum
System.Reflection.EventInfo
System.FieldAccessException
System.Reflection.FieldAttributes Enum
System.Reflection.FieldInfo
System.Runtime.InteropServices.FieldOffsetAttribute
System.Xml.Formatting Enum
System.Runtime.InteropServices.GCHandle Structure
System.Runtime.InteropServices.GCHandleType Enum
System.Net.GlobalProxySelection
System.Net.HttpContinueDelegate Delegate
System.Net.HttpStatusCode Enum
System.Net.HttpVersion
System.Net.HttpWebRequest
System.Net.HttpWebResponse
System.Net.IAuthenticationModule Interface
System.Net.ICredentials Interface
System.Runtime.InteropServices.InAttribute
System.IntPtr Structure
System.Net.IPAddress
System.Net.IPEndPoint
System.Net.IPHostEntry
System.Runtime.CompilerServices.IsVolatile
System.Net.IWebProxy Interface
System.Net.IWebRequestCreate Interface
System.Runtime.InteropServices.LayoutKind Enum
System.Net.Sockets.LingerOption
System.Runtime.InteropServices.MarshalAsAttribute
System.MemberAccessException
System.Reflection.MemberInfo
System.MethodAccessException
System.Reflection.MethodAttributes Enum
System.Reflection.MethodBase
System.Runtime.CompilerServices.MethodImplAttribute
System.Runtime.CompilerServices.MethodImplOptions Enum
System.Reflection.MethodInfo
System.MissingFieldException
System.MissingMemberException
System.MissingMethodException
System.Reflection.Module
System.Net.Sockets.MulticastOption
System.Xml.NameTable
System.Collections.Specialized.NameValueCollection
System.Ne.NetworkAccess Enum
System.Net.NetworkCredential
System.Net.Sockets.NetworkStream
System.Runtime.InteropServices.OutAttribute
System.ParamArrayAttribute
System.Reflection.ParameterAttributes Enum
System.Reflection.ParameterInfo
System.Reflection.ParameterModifier Structure
System.Reflection.PropertyAttributes Enum
System.Reflection.PropertyInfo
System.Net.Sockets.ProtocolType Enum
System.Net.ProtocolViolationException
System.Xml.ReadState Enum
System.Security.Permissions.ReflectionPermission
System.Security.Permissions.ReflectionPermissionAttribute
System.Security.Permissions.ReflectionPermissionFlag Enum
System.RuntimeFieldHandle Structure
System.Runtime.CompilerServices.RuntimeHelpers
System.RuntimeMethodHandle Structure
System.RuntimeTypeHandle Structure
System.Net.Sockets.SelectMode Enum
System.Net.ServicePoint
System.Net.ServicePointManager
System.Net.Sockets.Socket
System.Net.SocketAddress
System.Net.Sockets.SocketException
System.Net.Sockets.SocketFlags Enum
System.Net.Sockets.SocketOptionLevel Enum
System.Net.Sockets.SocketOptionName Enum
System.Net.SocketPermission
System.Net.SocketPermissionAttribute
System.Net.Sockets.SocketShutdown Enum
System.Net.Sockets.SocketType Enum
System.Runtime.InteropServices.StructLayoutAttribute
System.Reflection.TargetException
System.Reflection.TargetInvocationException
System.Reflection.TargetParameterCountException
System.Net.TransportType Enum
System.Reflection.TypeAttributes Enum
System.TypeLoadException
System.TypeUnloadedException
System.UIntPtr Structure
System.UnhandledExceptionEventArgs
System.UnhandledExceptionEventHandler Delegate
System.Runtime.InteropServices.UnmanagedType Enum
System.Uri
System.UriBuilder
System.UriFormatException
System.UriHostNameType Enum
System.UriPartial Enum
System.Void Structure
System.Net.WebClient
System.Net.WebException
System.Net.WebExceptionStatus Enum
System.Net.WebHeaderCollection
System.Net.WebPermission
System.Net.WebPermissionAttribute
System.Net.WebProxy
System.Net.WebRequest
System.Net.WebResponse
System.Xml.WhitespaceHandling Enum
System.Xml.WriteState Enum
System.Xml.XmlConvert
System.Xml.XmlException
System.Xml.XmlNamespaceManager
System.Xml.XmlNameTable
System.Xml.XmlNodeType Enum
System.Xml.XmlParserContext
System.Xml.XmlReader
System.Xml.XmlResolver
System.Xml.XmlSpace Enum
System.Xml.XmlTextReader
System.Xml.XmlTextWriter
System.Xml.XmlUrlResolver
System.Xml.XmlWriter
Annotations Index.
Index.
The .NET Framework is huge. The amount of time that would be required limits our ability to cover the entire .NET Framework in the depth it deserves. As a result, we have focused the scope of this book on the most important, widely used types in the Framework. Luckily, such a subset was already created in the standardization process of the Common Language Runtime and the C# Programming Language. This book covers the second half of that subset (Volume 1 covered the first half). In the printed portion of this volume you will find all the type-level information for these types. Both the type-level information and member-level information are available in electronic form on the CD.
To make the standard more accessible, this book includes the following features:
The CLI and the C# programming language are covered in other books in this series. Jim Miller's The Common Language Infrastructure Annotated Standard (Addison-Wesley, 2004) covers the CLI, which includes the metadata file format, IL Instruction set, and the type system. The C# Programming Language (Addison-Wesley, 2004) by Anders Hejlsberg, Scott Wiltamuth, and Peter Golde covers the C# programming language specification.
This book covers the second half of the .NET Framework as standardized in ECMA 335 and ISO 23271. The standards break the .NET Framework into seven different libraries to allow conformant implementations in resource-constrained environments. Those libraries are as follows:
Base Class Library--A simple runtime library for modern programming languages. It serves as the standard for the runtime library for the language C#, as well as one of the CLI standard libraries. It provides types to represent the built-in data types of the CLI, simple file access, custom attributes, security attributes, string manipulation, formatting, streams, collections, and so forth.
Extended Numerics Library--Provides the support for floating-point (System.Single, System.Double) and extended-precision (System.Decimal) data types. Like the Base Class Library, this library is directly referenced by the C# standard.
Network Library--Provides simple networking services, including direct access to network ports and HTTP support.
Reflection Library--Provides the ability to examine the structure of types, create instances of types, and invoke methods on types, all based on a description of the type.
XML Library--Provides a simple "pull-style" parser for XML. It is designed for resource-constrained devices, yet provides a simple user model.
Runtime Infrastructure Library--Provides the services needed by a compiler to target the CLI and the facilities needed to dynamically load types from a stream in the file format specified. For example, it provides System.BadImageFormatException, which is thrown when a stream that does not have the correct format is loaded.
Extended Array Library--Provides support for non-vector arrays, that is, arrays that have more than one dimension and arrays that have non-zero lower bounds.
The first volume of the .NET Framework Standard Library Reference covered the Base Class Library, the Extended Numerics Library and the Extended Array Library. This volume will contain the remaining libraries, as well as Microsoft-specific members on those types.
Type Chapters
Types are described in their own chapters, which are organized alphabetically
by type name.
Header
The header contains the namespace name (1), the type name (2), and the library
name from the ECMA\ISO Standard (3).
Type Hierarchy
Under the header we include a diagram representing the full inheritance hierarchy
for this type (1), subclasses of this type found in this volume (2), and any
interfaces they implement (3). The type being described is shown with a gray
background (4).
Type Summary
This section contains the C# declaration syntax for all members defined on this
type. It is meant to provide a quick reference in a very familiar format to
what is in the type. In this summary we highlight certain attributes of these
members.
CF Indicates the member is not available in the .NET Compact Framework. If
not included the member is available.
MS Indicates that the member is not included in the ECMA\ISO standard.
1.1 Indicates that the member is new in V1.1 of the .NET Framework.
Type Description
This section contains a detailed description of how this type is to be used.
For the most part this text is taken directly from the standard.
Annotations
Throughout this section we provide annotations from key members of the design
team at Microsoft and members of the ECMA standardization committee. The comments
in this section vary widely, and include notes on everything from common issues
to the history of the class design or standardization process to areas where,
in retrospect, the designers feel they could have done better.
Here's an example of an annotation from Brad Abrams on the AppDomain class. Each annotation is attributed to individuals by their initials.
BA
We introduced Application Domains as a lightweight process mechanism. Because managed code can be verifiably type safe (memory safe) we did not need the heavyweight address space barrier that processes provide. This savings works out well most of the time. However, when using interop with unmanaged code it does cause some problems when type safety is violated. One notable example of this is the loader-lock and AppDomain marshaling problem that C++ was succeptible to. We fixed this problem in a service pack of v1.1.
Type Examples
In this section we provide sample code illustrating use of the type. Some samples
are from the standard, but we added many more to facilitate a deeper and quicker
understanding of the use of the type. All the samples we provide are fully compilable
programs (1) and include selected output (2).
All of these samples have been tested with V1.0 and V1.1 of the .NET Framework and the appropriate ones have been tested on the .NET Compact Framework.
Complete source code for the samples is available on the CD that is included in the back of the book.
Type Members
The detailed descriptions of the members are included in the electronic version
of the book on the CD. To facilitate easy look-ups, the member descriptions
appear in the same order as the type summary sections. Each member contains
some or all of the following fields:
Syntax--C# declaration syntax is provided for familiar reference. ILASM syntax
is provided for completeness.
Summary--Short description of the member's purpose.
Parameters--Table of parameters accepted by this member and their meaning.
Description--A complete description of this member.
Return Value--The value and range returned by this method.
Property Value--The value of this property.
Exceptions--Table of the common exceptions thrown by this member.
Permissions--Table of the code access permissions demanded by this method.
Example--An example using this member following the same pattern as the type
samples.
In order to aid readability, the namespace portion of the fully qualified type names were removed when the result was unambigous. The following guidelines were used:
Many people contributed to making this book possible. We would like to thank:
Brad Abrams
Lead Program Manager, .NET Framework Team
Microsoft Corporation
March 2005
Download the Foreword
file related to this title.
Download the Index
file related to this title.