Application program interface for network software platform

[0001] This application is a continuation of U.S. patent application Ser. No. 09/902,811, filed Jul. 10, 2001, which is hereby incorporated by reference herein.

[0002] This invention relates to network software, such as Web applications, and to computer software development of such network software. More particularly, this invention relates to an application program interface (API) that facilitates use of a network software platform by application programs and computer hardware.

[0003] Very early on, computer software came to be categorized as “operating system” software or “application” software. Broadly speaking, an application is software meant to perform a specific task for the computer user such as solving a mathematical equation or supporting word processing. The operating system is the software that manages and controls the computer hardware. The goal of the operating system is to make the computer resources available to the application programmer while at the same time, hiding the complexity necessary to actually control the hardware.

[0004] The operating system makes the resources available via functions that are collectively known as the Application Program Interface or API. The term API is also used in reference to a single one of these functions. The functions are often grouped in terms of what resource or service they provide to the application programmer. Application software requests resources by calling individual API functions. API functions also serve as the means by which messages and information provided by the operating system are relayed back to the application software.

[0005] In addition to changes in hardware, another factor driving the evolution of operating system software has been the desire to simplify and speed application software development. Application software development can be a daunting task, sometimes requiring years of developer time to create a sophisticated program with millions of lines of code. For a popular operating system such as Microsoft Windows®, application software developers write thousands of different applications each year that utilize the operating system. A coherent and usable operating system base is required to support so many diverse application developers.

[0006] Often, development of application software can be made simpler by making the operating system more complex. That is, if a function may be useful to several different application programs, it may be better to write it once for inclusion in the operating system, than requiring dozens of software developers to write it dozens of times for inclusion in dozens of different applications. In this manner, if the operating system supports a wide range of common functionality required by a number of applications, significant savings in applications software development costs and time can be achieved.

[0007] Regardless of where the line between operating system and application software is drawn, it is clear that for a useful operating system, the API between the operating system and the computer hardware and application software is as important as efficient internal operation of the operating system itself.

[0008] Over the past few years, the universal adoption of the Internet, and networking technology in general, has changed the landscape for computer software developers. Traditionally, software developers focused on single-site software applications for standalone desktop computers, or LAN-based computers that were connected to a limited number of other computers via a local area network (LAN). Such software applications were typically referred to as “shrink wrapped” products because the software was marketed and sold in a shrink-wrapped package. The applications utilized well-defined APIs to access the underlying operating system of the computer.

[0009] As the Internet evolved and gained widespread acceptance, the industry began to recognize the power of hosting applications at various sites on the World Wide Web (or simply the “Web”). In the networked world, clients from anywhere could submit requests to server-based applications hosted at diverse locations and receive responses back in fractions of a second. These Web applications, however, were typically developed using the same operating system platform that was originally developed for standalone computing machines or locally networked computers. Unfortunately, in some instances, these applications do not adequately transfer to the distributed computing regime. The underlying platform was simply not constructed with the idea of supporting limitless numbers of interconnected computers.

[0010] To accommodate the shift to the distributed computing environment being ushered in by the Internet, Microsoft Corporation is developing a network software platform known as the “.NET” platform (read as “Dot Net”). The platform allows developers to create Web services that will execute over the Internet. Such a dynamic shift requires a new ground-up design of an entirely new API.

[0011] In response to this challenge, the inventors developed a unique set of API functions for Microsoft's .NET™ platform.

[0012] An application program interface (API) provides a set of functions, including a set of base classes and types that are used in substantially all applications accessing the API, for application developers who build Web applications on a network platform, such as Microsoft Corporation's .NET™ platform.

[0018] Accompanying the specification in the parent case, U.S. patent application Ser. No. 09/902,811, is a compact disc that stores a compiled HTML help file identifying the API (application program interface) for Microsoft's .NET™ network platform. The file is named “cpref.chm” and was created on Jun. 8, 2001. It is 30.81 Mbytes in size. The file can be executed on a Windows®-based computing device (e.g., IBM-PC, or equivalent) that executes a Windows®-brand operating system (e.g., Windows® NT, Windows® 98, Windows® 2000, etc.). The compiled HTML help file stored on the compact disk is hereby incorporated by reference.

[0019] Additionally, the APIs contained in the compiled HTML help file are also provided in approximately 100 separate text files named “NamespaceName.txt”. The text files comply with the ASCII format.

[0020] The compact disc itself is a CD-ROM, and conforms to the ISO 9660 standard.

[0021] This disclosure addresses an application program interface (API) for a network platform upon which developers can build Web applications and services. More particularly, an exemplary API is described for the .NET™ platform created by Microsoft Corporation. The .NET™ platform is a software platform for Web services and Web applications implemented in the distributed computing environment. It represents the next generation of Internet computing, using open communication standards to communicate among loosely coupled Web services that are collaborating to perform a particular task.

[0022] In the described implementation, the .NET™ platform utilizes XML (extensible markup language), an open standard for describing data. XML is managed by the World Wide Web Consortium (W3C). XML is used for defining data elements on a Web page and business-to-business documents. XML uses a similar tag structure as HTML; however, whereas HTML defines how elements are displayed, XML defines what those elements contain. HTML uses predefined tags, but XML allows tags to be defined by the developer of the page. Thus, virtually any data items can be identified, allowing Web pages to function like database records. Through the use of XML and other open protocols, such as Simple Object Access Protocol (SOAP), the .NET™ platform allows integration of a wide range of services that can be tailored to the needs of the user. Although the embodiments described herein are described in conjunction with XML and other open standards, such are not required for the operation of the claimed invention. Other equally viable technologies will suffice to implement the inventions described herein.

[0023] Exemplary Network Environment

[0024] FIG. 1 shows a network environment 100 in which a network platform, such as the .NET™ platform, may be implemented. The network environment 100 includes representative Web services 102(1), . . . , 102(N), which provide services that can be accessed over a network 104 (e.g., Internet). The Web services, referenced generally as number 102, are programmable application components that are reusable and interact programmatically over the network 104, typically through industry standard Web protocols, such as XML, SOAP, WAP (wireless application protocol), HTTP (hypertext transport protocol), and SMTP (simple mail transfer protocol) although other means of interacting with the Web services over the network may also be used, such as Remote Procedure Call (RPC) or object broker type technology. A Web service can be self-describing and is often defined in terms of formats and ordering of messages.

[0025] Web services 102 are accessible directly by other services (as represented by communication link 106) or a software application, such as Web application 110 (as represented by communication links 112 and 114). Each Web service 102 is illustrated as including one or more servers that execute software to handle requests for particular services. Such services often maintain databases that store information to be served back to requesters. Web services may be configured to perform any one of a variety of different services. Examples of Web services include login verification, notification, database storage, stock quoting, location directories, mapping, music, electronic wallet, calendar/scheduler, telephone listings, news and information, games, ticketing, and so on. The Web services can be combined with each other and with other applications to build intelligent interactive experiences.

[0026] The network environment 100 also includes representative client devices 120(1), 120(2), 120(3), 120(4), . . . , 120(M) that utilize the Web services 102 (as represented by communication link 122) and/or the Web application 110 (as represented by communication links 124, 126, and 128). The clients may communicate with one another using standard protocols as well, as represented by an exemplary XML link 130 between clients 120(3) and 120(4).

[0027] The client devices, referenced generally as number 120, can be implemented many different ways. Examples of possible client implementations include, without limitation, portable computers, stationary computers, tablet PCs, televisions/set-top boxes, wireless communication devices, personal digital assistants, gaming consoles, printers, photocopiers, and other smart devices.

[0028] The Web application 110 is an application designed to run on the network platform and may utilize the Web services 102 when handling and servicing requests from clients 120. The Web application 110 is composed of one or more software applications 130 that run atop a programming framework 132, which are executing on one or more servers 134 or other computer systems. Note that a portion of Web application 110 may actually reside on one or more of clients 120. Alternatively, Web application 110 may coordinate with other software on clients 120 to actually accomplish its tasks.

[0029] The programming framework 132 is the structure that supports the applications and services developed by application developers. It permits multi-language development and seamless integration by supporting multiple languages. It supports open protocols, such as SOAP, and encapsulates the underlying operating system and object model services. The framework provides a robust and secure execution environment for the multiple programming languages and offers secure, integrated class libraries.

[0030] The framework 132 is a multi-tiered architecture that includes an application program interface (API) layer 142, a common language runtime (CLR) layer 144, and an operating system/services layer 146. This layered architecture allows updates and modifications to various layers without impacting other portions of the framework. A common language specification (CLS) 140 allows designers of various languages to write code that is able to access underlying library functionality. The specification 140 functions as a contract between language designers and library designers. By adhering to the CLS, libraries written in one language can be directly accessible to code modules written in other languages to achieve seamless integration between code modules written in one language and code modules written in another language.

[0031] The API layer 142 presents groups of functions that the applications 130 can call to access the resources and services provided by layer 146. By exposing the API functions for a network platform, application developers can create Web applications for distributed computing systems that make full use of the network resources and other Web services, without needing to understand the complex interworkings of how those network resources actually operate or are made available. Moreover, the Web applications can be written in any number of programming languages, and translated into an intermediate language supported by the common language runtime 144 and included as part of the common language specification 140. In this way, the API layer 142 can provide methods for a wide and diverse variety of applications.

[0032] Additionally, the framework 132 can be configured to support API calls placed by remote applications executing remotely from the servers 134 that host the framework. Representative applications 148(1) and 148(2) residing on clients 120(3) and 120(M), respectively, can use the API functions by making calls directly, or indirectly, to the API layer 142 over the network 104.

[0033] The framework may also be implemented at the clients. Client 120(3) represents the situation where a framework 150 is implemented at the client. This framework may be identical to server-based framework 132, or modified for client purposes. Alternatively, the client-based framework may be condensed in the event that the client is a limited or dedicated function device, such as a cellular phone, personal digital assistant, handheld computer, or other communication/computing device.

[0034] Developers' Programming Framework

[0035] FIG. 2 shows the programming framework 132 in more detail. The common language specification (CLS) layer 140 supports applications written in a variety of languages 130(1), 130(2), 130(3), 130(4), . . . , 130(K). Such application languages include Visual Basic, C++, C#, COBOL, Jscript, Perl, Eiffel, Python, and so on. The common language specification 140 specifies a subset of features or rules about features that, if followed, allow the various languages to communicate. For example, some languages do not support a given type (e.g., an “int*” type) that might otherwise be supported by the common language runtime 144. In this case, the common language specification 140 does not include the type. On the other hand, types that are supported by all or most languages (e.g., the “int[ ]” type) is included in common language specification 140 so library developers are free to use it and are assured that the languages can handle it. This ability to communicate results in seamless integration between code modules written in one language and code modules written in another language. Since different languages are particularly well suited to particular tasks, the seamless integration between languages allows a developer to select a particular language for a particular code module with the ability to use that code module with modules written in different languages. The common language runtime 144 allow seamless multi-language development, with cross language inheritance, and provide a robust and secure execution environment for the multiple programming languages. For more information on the common language specification 140 and the common language runtime 144, the reader is directed to co-pending applications entitled “Method and System for Compiling Multiple Languages”, filed Jun. 21, 2000 (Ser. No. 09/598,105) and “Unified Data Type System and Method” filed Jul. 10, 2000 (Ser. No. 09/613,289), which are incorporated by reference.

[0036] The framework 132 encapsulates the operating system 146(1) (e.g., Windows®-brand operating systems) and object model services 146(2) (e.g., Component Object Model (COM) or Distributed COM). The operating system 146(1) provides conventional functions, such as file management, notification, event handling, user interfaces (e.g., windowing, menus, dialogs, etc.), security, authentication, verification, processes and threads, memory management, and so on. The object model services 146(2) provide interfacing with other objects to perform various tasks. Calls made to the API layer 142 are handed to the common language runtime layer 144 for local execution by the operating system 146(1) and/or object model services 146(2).

[0037] The API 142 groups API functions into multiple namespaces. Namespaces essentially define a collection of classes, interfaces, delegates, enumerations, and structures, which are collectively called “types”, that provide a specific set of related functionality. A class represents managed heap allocated data that has reference assignment semantics. A delegate is an object oriented function pointer. An enumeration is a special kind of value type that represents named constants. A structure represents static allocated data that has value assignment semantics. An interface defines a contract that other types can implement.

[0038] By using namespaces, a designer can organize a set of types into a hierarchical namespace. The designer is able to create multiple groups from the set of types, with each group containing at least one type that exposes logically related functionality. In the exemplary implementation, the API 142 is organized into four root namespaces: a first namespace 200 for Web applications, a second namespace 202 for client applications, a third namespace 204 for data and XML, and a fourth namespace 206 for base class libraries (BCLs). Each group can then be assigned a name. For instance, types in the Web applications namespace 200 are assigned the name “Web”, and types in the data and XML namespace 204 can be assigned names “Data” and “XML” respectively. The named groups can be organized under a single “global root” namespace for system level APIs, such as an overall System namespace. By selecting and prefixing a top level identifier, the types in each group can be easily referenced by a hierarchical name that includes the selected top level identifier prefixed to the name of the group containing the type. For instance, types in the Web applications namespace 200 can be referenced using the hierarchical name “System.Web”. In this way, the individual namespaces 200, 202, 204, and 206 become major branches off of the System namespace and can carry a designation where the individual namespaces are prefixed with a designator, such as a “System.” prefix.

[0039] The Web applications namespace 200 pertains to Web based functionality, such as dynamically generated Web pages (e.g., Microsoft's Active Server Pages (ASP)). It supplies types that enable browser/server communication. The client applications namespace 202 pertains to drawing and client side UI functionality. It supplies types that enable drawing of two-dimensional (2D) and three-dimensional (3D) drawings, imaging, and printing, as well as the ability to construct window forms, menus, boxes, and so on.

[0040] The data and XML namespace 204 relates to connectivity to data sources and XML functionality. It supplies classes, interfaces, delegates, and enumerations that enable security, specify data types, and serialize objects into XML format documents or streams. The base class libraries (BCL) namespace 206 pertains to basic system and runtime functionality. It contains the fundamental types and base classes that define commonly-used value and reference data types, events and event handlers, interfaces, attributes, and processing exceptions.

[0041] In addition to the framework 132, programming tools 210 are provided to assist the developer in building Web services and/or applications. One example of the programming tools 200 is Visual Studio™, a multi-language suite of programming tools offered by Microsoft Corporation.

[0042] Root API Namespaces

[0043] FIG. 3 shows the API 142 and its four root namespaces in more detail. In one embodiment, the namespaces are identified according to a hierarchical naming convention in which strings of names are concatenated with periods. For instance, the Web applications namespace 200 is identified by the root name “System.Web”. Within the “Sytem.Web” namespace is another namespace for Web services, identified as “System.Web.Services”, which further identifies another namespace for a description known as “System.Web.Services.Description”. With this naming convention in mind, the following provides a general overview of selected namespaces of the API 142, although other naming conventions could be used with equal effect.

[0044] The Web applications namespace 200 (“System.Web”) defines additional namespaces, including:

• • [0045] A services namespace 300 (“System.Web.Services”) containing classes that enable a developer to build and use Web services. The services namespace 300 defines additional namespaces, including a namespace 302 (“System.Web.Services.Description”) containing classes that enable a developer to publicly describe a Web service via a service description language (such as WSDL, a specification available from the W3C), a discovery namespace 304 (“System.Web.Services.Discovery”) containing classes that allow Web service consumers to locate available Web Services on a Web server, and a protocols namespace 306 (“System.Web.Services.Protocols”) containing classes that define the protocols used to transmit data across a network during communication between Web service clients and the Web service itself.
  • [0046] A caching namespace 308 (“System.Web.Caching”) containing classes that enable developers to decrease Web application response time through temporarily caching frequently used resources on the server. This includes ASP.NET pages, web services, and user controls. (ASP.NET is the updated version of Microsoft's ASP technology.) Additionally, a cache dictionary is available for developers to store frequently used resources, such as hash tables and other data structures.
  • [0047] A configuration namespace 310 (“System.Web.Configuration”) containing classes that are used to read configuration data in for an application.
  • [0048] A UI namespace 312 (“System.Web.UI”) containing types that allow developers to create controls and pages that will appear in Web applications as user interfaces on a Web page. This namespace includes the control class, which provides all web based controls, whether those encapsulating HTML elements, higher level Web controls, or even custom User controls, with a common set of functionality. Also provided are classes which provide the web forms server controls data binding functionality, the ability to save the view state of a given control or page, as well as parsing functionality for both programmable and literal controls. Within the UI namespace 312 are two additional namespaces: an HTML controls namespace 314 (“System.Web.UI.HtmlControls”) containing classes that permit developers to interact with types that encapsulates html 3.2 elements create HTML controls, and a Web controls namespace 316 (“System.Web.UI.Weblcontrols”) containing classes that allow developers to create higher level Web controls.
  • [0049] A security namespace 318 (“System.Web.Securty”) containing classes used to implement security in web server applications, such as basic authentication, challenge response authentication, and role based authentication.
  • [0050] A session state namespace 320 (“System.Web.SessionState”) containing classes used to access session state values (i.e., data that lives across requests for the lifetime of the session) as well as session-level settings and lifetime management methods.

[0051] The client applications namespace 202 is composed of two namespaces:

• • [0052] A windows forms namespace 322 (“System.Windows.Forms”) containing classes for creating Windows®-based client applications that take full advantage of the rich user interface features available in the Microsoft Windows® operating system, such as the ability to drag and drop screen elements. Such classes may include wrapped APIs available in the Microsoft Windows® operating system that are used in a windowing UI environment. Within this namespace are a design namespace 324 (“System.Windows.Forms.Design”) that contains classes to extend design-time support for Windows forms and a component model namespace 326 (“System.Windows.Forms.ComponentModel”) that contains the windows form implementation of the general component model defined in System.ComponentModel. This namespace contains designer tools, such as Visual Studio, which offer a rich experience for developers at design time.
  • [0053] A drawing namespace 328 (“System.Drawing”) containing classes for graphics functionality. The drawing namespace 328 includes a 2D drawing namespace 330 (“System.Drawing.Drawing2D”) that contains classes and enumerations to provide advanced 2-dimensional and vector graphics functionality, an imaging namespace 332 (“System.Drawing.Imaging”) that contains classes for advanced imaging functionality, a printing namespace 334 (“System. Drawing.Printing”) that contains classes to permit developers to customize printing, and a text namespace 336 (“System.Drawing.Text”) that contains classes for advanced typography functionality.

[0054] The data and XML namespace 204 is composed of two namespaces:

• • [0055] A data namespace 340 (“System.Data”) containing classes that enable developers to build components that efficiently manage data from multiple data sources. It implements an architecture that, in a disconnected scenario (such as the Internet), provides tools to request, update, and reconcile data in multiple tier systems. The data namespace 340 includes a common namespace 342 that contains types shared by data providers. A data provider describes a collection of types used to access a data source, such as a database, in the managed space. The data namespace 340 also includes an OLE DB namespace 344 that contains types pertaining to data used in object-oriented databases (e.g., Microsoft's SQL Server), and a SQL client namespace 346 that contains types pertaining to data used by SQL clients. The data namespace also includes a SQL types namespace 348 (“System.Data.SqlTypes”) that contains classes for native data types within Microsoft's SQL Server. The classes provide a safer, faster alternative to other data types. Using the objects within this namespace helps prevent type conversion errors caused in situations where loss of precision could occur. Because other data types are converted to and from SQL types behind the scenes, explicitly creating and using objects within this namespace results in faster code as well.
  • [0056] An XML namespace 350 (“System.XML”) containing classes that provide standards-based support for processing XML. The supported standards include XML (e.g., version 1.0), XML Namespaces (both stream level and DOM), XML Schemas, XPath expressions, XSL/T transformations, DOM Level 2 Core, and SOAP (e.g., version 1.1). The XML namespace 350 includes an XSLT namespace 352 (“System.XML.Xsl”) that contains classes and enumerations to support XSLT (Extensible Stylesheet Language Transformations), an Xpath namespace 354 (“System.XML.Xpath”) that contains an XPath parser and evaluation engine, and a serialization namespace 356 (“System.XML.Serialization”) that contains classes used to serialize objects into XML format documents or streams.

[0057] The base class library namespace 206 (“System”) includes the following namespaces:

• • [0058] A collections namespace 360 (“System.Collections”) containing interfaces and classes that define various collections of objects, such as lists, queues, arrays, hash tables and dictionaries.
  • [0059] A configuration namespace 362 (“System.Configuration”) containing classes and interfaces that allow developers to programmatically access configuration settings and handle errors in configuration files.
  • [0060] A diagnostics namespace 364 (“System.Diagnostics”) containing classes that are used to debug applications and to trace code execution. The namespace allows developers to start system processes, read and write to event logs, and monitor system performance using performance counters.
  • [0061] A globalization namespace 366 (“System.Globalization”) containing classes that define culture-related information, including the language, the country/region, the calendars in use, the format patterns for dates, currency and numbers, and the sort order for strings.
  • [0062] An I/O namespace 368 (“System.IO”) containing the infrastructure pieces to operate with the intput/output of data streams, files, and directories. This namespace includes a model for working with streams of bytes, higher level readers and writers which consume those bytes, various constructions or implementations of the streams (e.g., FileStream and MemoryStream) and, a set of utility classes for working with files and directories.
  • [0063] A net namespace 370 (“System.Net”) providing an extensive set of classes for building network-enabled application, referred to as the Net Class Libraries (NCL). One element to the design of the Net Class Libraries is an extensible, layered approach to exposing networking functionality. The NCL stack contains three basic layers. A base layer (System.Net.Socket) provides access to an interface to TCP/IP, the communications protocol of UNIX networks and the Internet. One example of such an interface is the “WinSock API” from Microsoft Corporation. The next layer is the Transport Protocol classes, which support such transport protocols as TCP and UDP. Developers may write their own protocol classes to provide support for protocols such as IGMP and ICMP. The third layer is the Web request, which provides an abstract factory pattern for the creation of other protocol classes. The NCL provides implementations for Hyper Text Transport Protocol (HTTP).
  • [0064] A reflection namespace (“System.Reflection”) 372 containing types that provide a managed view of loaded types, methods, and fields, with the ability to dynamically create and invoke types.
  • [0065] A resources namespace 374 (“System.Resources”) containing classes and interfaces that allow developers to create, store and manage various culture-specific resources used in an application.
  • [0066] A security namespace 376 (“System.Security”) supporting the underlying structure of the security system, including interfaces, attributes, exceptions, and base classes for permissions.
  • [0067] A service process namespace 378 (“System.ServiceProcess”) containing classes that allow developers to install and run services. Services are long-running executables that run without a user interface. They can be installed to run under a system account that enables them to be started at computer reboot. Services whose implementation is derived from processing in one class can define specific behavior for start, stop, pause, and continue commands, as well as behavior to take when the system shuts down.
  • [0068] A text namespace 380 (“System.Text”) containing classes representing various types of encodings (e.g., ASCII, Unicode, UTF-7, and UTF-8), abstract base classes for converting blocks of characters to and from blocks of bytes, and a helper class that manipulates and formats string objects without creating intermediate instances.
  • [0069] A threading namespace 382 (“System.Threading”) containing classes and interfaces that enable multi-threaded programming. The threading namespace includes a ThreadPool class that manages groups of threads, a Timer class that enables a delegate to be called after a specified amount of time, and a Mutex class for synchronizing mutually-exclusive threads. This namespace also provides classes for thread scheduling, wait notification, and deadlock resolution.
  • [0070] A runtime namespace 384 (“System.Runtime”) containing multiple namespaces concerning runtime features, including an interoperation services namespace 386 (“System.Runtime.InteropServices”) that contains a collection of classes useful for accessing COM objects. The types in the InteropServices namespace fall into the following areas of functionality: attributes, exceptions, managed definitions of COM types, wrappers, type converters, and the Marshal class. The runtime namespace 384 further includes a remoting namespace 388 (“System.Runtime.Remoting”) that contains classes and interfaces allowing developers to create and configure distributed applications. Another namespace within the runtime namespace 384 is a serialization namespace 390 (“System.Runtime.Serialization”) that contains classes used for serializing and deserializing objects. Serialization is the process of converting an object or a graph of objects into a linear sequence of bytes for either storage or transmission to another location.

[0071] Portions of the base class library namespace 206 (“System”) are discussed in additional detail below.

[0072] System Namespace

[0073] The System namespace is the root namespace; it offers common functionality that is needed by a wide variety of application types. The System namespace includes common base classes, types and utility classes that will be needed in substantially all applications (that is, in nearly every application).

[0074] The System namespace provides commonly used base types. It includes Object, which is the ultimate base class for all types in the system. Object defines the base set of services that any type in the system is able to provide. Not surprisingly, Object provides default implementations for all of these services. The ValueType class is a reference type that serves as the base class for all value types. It customizes the implementations of the virtual methods on Object so that they are more appropriate for value types. Enum is a reference type that derives from ValueType and is the base class for all enums in the system. It further customizes the virtual methods from ValueType to make them specific to deal with exactly one integral field of instance data. Enum also offers utility methods for formatting and parsing of enum values. The ultimate base class for all exceptions in the system, the Exception class, is also in the System namespace. All custom attributes derive from the Attribute base class that contains utility methods for reading custom attribute off of reflection elements.

[0075] In addition, the base data types are also found in the system namespace. These are types that are so commonly used that languages typically use key words as aliases for them. These classes represent those types and provide formatting and parsing, comparing and coercion support.

NET Framework Built-In Value Types

[0076]

					Managed
					Extensions
			Visual Basic		for C++ data
Category	Class name	Description	data type	C# data type	type
Integer	Byte	An 8-bit	Byte	byte	char
		unsigned
		integer.
	Sbyte	An 8-bit signed	Sbyte	sbyte	signed char
		integer.	No built-in
		Not CLS	type.
		compliant.
	Int16	A 16-bit signed	Short	short	short
		integer.
	Int32	A 32-bit signed	Integer	int	int
		integer.			-or-
					long
	Int64	A 64-bit signed	Long	long	——int64
		integer.
	UInt16	A 16-bit	UInt16	ushort	unsigned
		unsigned	No built-in		short
		integer.	type.
		Not CLS
		compliant.
	UInt32	A 32-bit	UInt32	uint	unsigned int
		unsigned	No built-in		-or-
		integer.	type.		unsigned long
		Not CLS
		compliant.
	UInt64	A 64-bit	UInt64	ulong	unsigned
		unsigned	No built-in		——int64
		integer.	type.
		Not CLS
		compliant.
Floating	Single	A single-	Single	float	float
point		precision (32-
		bit) floating-
		point number.
	Double	A double-	Double	double	double
		precision (64-
		bit) floating-
		point number.
Logical	Boolean	A Boolean value	Boolean	bool	bool
		(true or false).
Other	Char	A Unicode (16-	Char	char	——wchar_t
		bit) character.
	Decimal	A 96-bit	Decimal	decimal	Decimal
		decimal value.
	Single	A signed	IntPtr	IntPtr	IntPtr
		integer, that is,	No built-in	No built-in	No built-in
		a 32 bit value	type.	type.	type.
		on a 32-bit
		platform and a
		64 bit value on
		a 64-bit
		platform.
	Double	A native-sized	UIntPtr	UIntPtr	UIntPtr
		unsigned	No built-in	No built-in	No built-in
		integer.	type.	type.	type.
		Not CLS
		compliant.

[0077] Other classes provide services including supervision of managed and unmanaged applications, mathematics, remote and local program invocation, data type conversion, and application environment management.

[0078] The following is a more detailed description of the System namespace, identifying various classes, interfaces, enumerations, and so forth contained in the System namespace.

[0079] System

[0080] This namespace contains fundamental classes and base classes that define commonly-used value and reference data types, events and event handlers, interfaces, attributes, and processing exceptions.

Description

[0081] This namespace contains fundamental classes and base classes that define commonly-used value and reference data types, events and event handlers, interfaces, attributes, and processing exceptions.

[0082] _AppDomain interface (System)

Description

[0083] Properties:

[0084] BaseDirectory

• [0085] [C#] string BaseDirectory {get;}
• [0086] [C++] String* get_BaseDirectory( );
• [0087] [VB] ReadOnly Property BaseDirectory As String
• [0088] [JScript] abstract function get BaseDirectory( ): String;
  Description

[0089] DynamicDirectory

• [0090] [C#] string DynamicDirectory {get;}
• [0091] [C++] String* get_DynamicDirectory( );
• [0092] [VB] ReadOnly Property DynamnicDirectory As String
• [0093] [JScript] abstract function get DynamnicDirectory( ): String;
  Description

[0094] Evidence

• [0095] [C#] Evidence Evidence {get;}
• [0096] [C++] Evidence* get_Evidence( );
• [0097] [VB] ReadOnly Property Evidence As Evidence
• [0098] [JScript] abstract function get Evidence( ): Evidence;
  Description

[0099] FriendlyName

• [0100] [C#] string FriendlyName {get;}
• [0101] [C++] String* get_FriendlyName( );
• [0102] [VB] ReadOnly Property FriendlyName As String
• [0103] [JScript] abstract function get FriendlyName( ): String;
  Description

[0104] RelativeSearchPath

• [0105] [C#] string RelativeSearchPath {get;}
• [0106] [C++] String* get_RelativeSearchPath( );
• [0107] [VB] ReadOnly Property RelativeSearchPath As String
• [0108] [JScript] abstract function get RelativeSearchPath( ): String;
  Description

[0109] ShadowCopyFiles

• [0110] [C#] bool ShadowCopyFiles {get;}
• [0111] [C++] bool get_ShadowCopyFiles( );
• [0112] [VB] ReadOnly Property ShadowCopyFiles As Boolean
• [0113] [JScript] abstract function get ShadowCopyFiles( ): Boolean;
  Description
• [0114] [C#] event AssemblyLoadEventHandler AssemblyLoad;
• [0115] [C++] _event AssemblyLoadEventHandler* AssemblyLoad;
• [0116] [VB] Event AssemblyLoad As AssemblyLoadEventHandler
  Description
• [0117] [C#] event ResolveEventHandler AssemblyResolve;
• [0118] [C++]-event ResolveEventHandler* AssemblyResolve;
• [0119] [VB] Event AssemblyResolve As ResolveEventHandler
  Description
• [0120] [C#] event EventHandler DomainUnload;
• [0121] [C++] _event EventHandler* DomainUnload;
• [0122] [VB] Event DomainUnload As EventHandler
  Description
• [0123] [C#] event EventHandler ProcessExit;
• [0124] [C++] _event EventHandler* ProcessExit;
• [0125] [VB] Event ProcessExit As EventHandler
  Description
• [0126] [C#] event ResolveEventHandler ResourceResolve;
• [0127] [C++] _event ResolveEventHandler* ResourceResolve;
• [0128] [VB] Event ResourceResolve As ResolveEventHandler
  Description
• [0129] [C#] event ResolveEventHandler TypeResolve;
• [0130] [C++] _event ResolveEventHandler* TypeResolve;
• [0131] [VB] Event TypeResolve As ResolveEventHandler
  Description
• [0132] [C#] event UnhandledExceptionEventHandler UnhandledException;
• [0133] [C++] _event UnhandledExceptionEventHandler* UnhandledException;
• [0134] [VB] Event UnhandledException As UnhandledExceptionEventHandler
  Description

[0135] Methods:

[0136] AppendPrivatePath

• [0137] [C#] void AppendPrivatePath(string path);
• [0138] [C++] void AppendPrivatePath(String* path);
• [0139] [VB] Sub AppendPrivatePath(ByVal path As String)
• [0140] [JScript] function AppendPrivatePath(path: String);
  Description

[0141] ClearPrivatePath

• [0142] [C#] void ClearPrivatePath( );
• [0143] [C++] void ClearPrivatePath( );
• [0144] [VB] Sub ClearPrivatePath( )
• [0145] [JScript] function ClearPrivatePath( );
  Description

[0146] ClearShadowCopyPath

• [0147] [C#] void ClearShadowCopyPath( );
• [0148] [C++] void ClearShadowCopyPath( );
• [0149] [VB] Sub ClearShadowCopyPath( )
• [0150] [JScript] function ClearShadowCopyPath( );
  Description

[0151] CreateInstance

• [0152] [C#] ObjectHandle CreateInstance(string assemblyName, string typeName);
• [0153] [C++] ObjectHandle* CreateInstance(String* assemblyName, String* typeName);
• [0154] [VB] Function CreateInstance(ByVal assemblyName As String, ByVal typeName As String) As ObjectHandle
• [0155] [JScript] function CreateInstance(assemblyName: String, typeName: String): ObjectHandle;
  Description

[0156] CreateInstance

• [0157] [C#] ObjectHandle CreateInstance(string assemblyName, string typeName, object[ ] activationAttributes);
• [0158] [C++] ObjectHandle* CreateInstance(String* assemblyName, String* typeName, Object* activationAttributes _gc[ ]);
• [0159] [VB] Function CreateInstance(ByVal assemblyName As String, ByVal typeName As String, ByVal activationAttributes( ) As Object) As ObjectHandle
• [0160] [JScript] function CreateInstance(assemblyName: String, typeName: String, activationAttributes: Object[ ]): ObjectHandle;
  Description

[0161] CreateInstance

• [0162] [C#] ObjectHandle CreateInstance(string assemblyName, string typeName, bool ignoreCase, BindingFlags bindingAttr, Binder binder, object[ ] args, CultureInfo culture, object[ ] activationAttributes, Evidence securityAttributes);
• [0163] [C++] ObjectHandle* CreateInstance(String* assemblyName, String* typeName, bool ignoreCase, BindingFlags bindingAttr, Binder* binder, Object* args _gc[ ], CultureInfo* culture, Object* activationAttributes _gc[ ], Evidence* securityAttributes);
• [0164] [VB] Function CreateInstance(ByVal assemblyName As String, ByVal typeName As String, ByVal ignoreCase As Boolean, ByVal bindingAttr As BindingFlags, ByVal binder As Binder, ByVal args( ) As Object, ByVal culture As CultureInfo, ByVal activationAttributes( ) As Object, ByVal securityAttributes As Evidence) As ObjectHandle
• [0165] [JScript] function CreateInstance(assemblyName: String, typeName: String, ignoreCase: Boolean, bindingAttr: BindingFlags, binder: Binder, args: Object[ ], culture: CultureInfo, activationAttributes: Object[ ], securityAttributes: Evidence): ObjectHandle;
  Description

[0166] CreateInstanceFrom

• [0167] [C#] ObjectHandle CreateInstanceFrom(string assemblyFile, string typeName);
• [0168] [C++] ObjectHandle* CreateInstanceFrom(String* assemblyFile, String* typeName);
• [0169] [VB] Function CreateInstanceFrom(ByVal assemblyFile As String, ByVal typeName As String) As ObjectHandle
• [0170] [JScript] function CreateInstanceFrom(assemblyFile: String, typeName: String): ObjectHandle;
  Description

[0171] CreateInstanceFrom

• [0172] [C#] ObjectHandle CreateInstanceFrom(string assemblyFile, string typeName, object[ ] activationAttributes);
• [0173] [C++] ObjectHandle* CreateInstanceFrom(String* assemblyFile, String* typeName, Object* activationAttributes _gc[ ]);
• [0174] [VB] Function CreateInstanceFrom(ByVal assemblyFile As String, ByVal typeName As String, ByVal activationAttributes( ) As Object) As ObjectHandle
• [0175] [JScript] function CreateInstanceFrom(assemblyFile: String, typeName: String, activationAttributes: Object[ ]): ObjectHandle;
  Description

[0176] CreateInstanceFrom

• [0177] [C#] ObjectHandle CreateInstanceFrom(string assemblyFile, string typeName, bool ignoreCase, BindingFlags bindingAttr, Binder binder, object[ ] args, CultureInfo culture, object[ ] activationAttributes, Evidence securityAttributes);
• [0178] [C++] ObjectHandle* CreateInstanceFrom(String* assemblyFile, String* typeName, bool ignoreCase, BindingFlags bindingAttr, Binder* binder, Object* args _gc[ ], CultureInfo* culture, Object* activationAttributes _gc[ ], Evidence* securityAttributes);
• [0179] [VB] Function CreateInstanceFrom(ByVal assemblyFile As String, ByVal typeName As String, ByVal ignoreCase As Boolean, ByVal bindingAttr As BindingFlags, ByVal binder As Binder, ByVal args( ) As Object, ByVal culture As CultureInfo, ByVal activationAttributes( ) As Object, ByVal securityAttributes As Evidence) As ObjectHandle
• [0180] [JScript] function CreateInstanceFrom(assemblyFile: String, typeName: String, ignoreCase: Boolean, bindingAttr: BindingFlags, binder: Binder, args: Object[ ], culture: CultureInfo, activationAttributes: Object[ ], securityAttributes Evidence): ObjectHandle;
  Description

[0181] DefineDynamicAssembly

• [0182] [C#] AssemblyBuilder DefineDynamicAssembly(AssemblyName name, AssemblyBuilderAccess access);
• [0183] [C++] AssemblyBuilder* DefineDynamicAssembly(AssemblyName* name, AssemblyBuilderAccess access);
• [0184] [VB] Function DefineDynamicAssembly(ByVal name As AssemblyName, ByVal access As AssemblyBuilderAccess) As AssemblyBuilder
• [0185] [JScript] function DefineDynamicAssembly(name: AssemblyName, access: AssemblyBuilderAccess): AssemblyBuilder;
  Description

[0186] DefineDynamicAssembly

• [0187] [C#] AssemblyBuilder DefineDynamicAssembly(AssemblyName name, AssemblyBuilderAccess access, Evidence evidence);
• [0188] [C++] AssemblyBuilder* DefineDynamicAssembly(AssemblyName* name, AssemblyBuilderAccess access, Evidence* evidence);
• [0189] [VB] Function DefineDynamicAssembly(ByVal name As AssemblyName, ByVal access As AssemblyBuilderAccess, ByVal evidence As Evidence) As AssemblyBuilder
• [0190] [JScript] function DefineDynamicAssembly(name: AssemblyName, access: AssemblyBuilderAccess, evidence: Evidence): AssemblyBuilder;
  Description

[0191] DefineDynamicAssembly

• [0192] [C#] AssemblyBuilder DefineDynamicAssembly(AssemblyName name, AssemblyBuilderAccess access, string dir);
• [0193] [C++] AssemblyBuilder* DefineDynamicAssembly(AssemblyName* name, AssemblyBuilderAccess access, String* dir);
• [0194] [VB] Function DefineDynamicAssembly(ByVal name As AssemblyName, ByVal access As AssemblyBuilderAccess, ByVal dir As String) As AssemblyBuilder
• [0195] [JScript] function DefineDynamicAssembly(name: AssemblyName, access: AssemblyBuilderAccess, dir: String): AssemblyBuilder;
  Description

[0196] DefineDynamicAssembly

• [0197] [C#] AssemblyBuilder DefineDynamicAssembly(AssemblyName name, AssemblyBuilderAccess access, string dir, Evidence evidence);
• [0198] [C++] AssemblyBuilder* DefineDynamicAssembly(AssemblyName* name, AssemblyBuilderAccess access, String* dir, Evidence* evidence);
• [0199] [VB] Function DefineDynamicAssembly(ByVal name As AssemblyName, ByVal access As AssemblyBuilderAccess, ByVal dir As String, ByVal evidence As Evidence) As AssemblyBuilder
• [0200] [JScript] function DefineDynamicAssembly(name: AssemblyName, access: AssemblyBuilderAccess, dir: String, evidence: Evidence): AssemblyBuilder;
  Description

[0201] DefineDynamicAssembly

• [0202] [C#] AssemblyBuilder DefineDynamicAssembly(AssemblyName name, AssemblyBuilderAccess access, PermissionSet requiredPermissions, PermissionSet optionalPermissions, PermissionSet refusedPermissions);
• [0203] [C++] AssemblyBuilder* DefineDynamicAssembly(AssemblyName* name, AssemblyBuilderAccess access, PermissionSet* requiredPermissions, PermissionSet* optionalPermissions, PermissionSet* refusedPermissions);
• [0204] [VB] Function DefineDynamicAssembly(ByVal name As AssemblyName, ByVal access As AssemblyBuilderAccess, ByVal requiredPermissions As PermissionSet, ByVal optionalPermissions As PermissionSet, ByVal refusedPermissions As PermissionSet) As AssemblyBuilder
• [0205] [JScript] function DefineDynamicAssembly(name: AssemblyName, access: AssemblyBuilderAccess, requiredPermissions: PermissionSet, optionalPermissions: PermissionSet, refusedPermissions: PermissionSet) AssemblyBuilder;
  Description

[0206] DefineDynamicAssembly

• [0207] [C#] AssemblyBuilder DefineDynamicAssembly(AssemblyName name, AssemblyBuilderAccess access, Evidence evidence, PermissionSet requiredPermissions, PermissionSet optionalPermissions, PermissionSet refusedPermissions);
• [0208] [C++] AssemblyBuilder* DefineDynamicAssembly(AssemblyName* name, AssemblyBuilderAccess access, Evidence* evidence, PermissionSet* requiredPermissions, PermissionSet* optionalPermissions, PermissionSet* refusedPermissions);
• [0209] [VB] Function DefineDynamicAssembly(ByVal name As AssemblyName, ByVal access As AssemblyBuilderAccess, ByVal evidence As Evidence, ByVal requiredPermissions As PermissionSet, ByVal optionalPermissions As PermissionSet, ByVal refusedPermissions As PermissionSet) As AssemblyBuilder
• [0210] [JScript] function DefineDynamicAssembly(name: AssemblyName, access: AssemblyBuilderAccess, evidence: Evidence, requiredPermissions: PermissionSet, optionalPermissions: PermissionSet, refusedPermissions: PermissionSet): AssemblyBuilder;
  Description

[0211] DefineDynamicAssembly

• [0212] [C#] AssemblyBuilder DefineDynamicAssembly(AssemblyName name, AssemblyBuilderAccess access, string dir, PermissionSet requiredPermissions, PermissionSet optionalPermissions, PermissionSet refusedPermissions);
• [0213] [C++] AssemblyBuilder* DefineDynamicAssembly(AssemblyName* name, AssemblyBuilderAccess access, String* dir, PermissionSet* requiredPermissions, PermissionSet* optionalPermissions, PermissionSet* refusedPermissions);
• [0214] [VB] Function DefineDynamicAssembly(ByVal name As AssemblyName, ByVal access As AssemblyBuilderAccess, ByVal dir As String, ByVal requiredPermissions As PermissionSet, ByVal optionalPermissions As PermissionSet, ByVal refusedPermissions As PermissionSet) As AssemblyBuilder
• [0215] [JScript] function DefineDynamicAssembly(name: AssemblyName, access: AssemblyBuilderAccess, dir: String, requiredPermissions: PermissionSet, optionalPermissions: PermissionSet, refusedPermissions: PermissionSet): AssemblyBuilder;
  Description

[0216] DefineDynamicAssembly

• [0217] [C#] AssemblyBuilder DefineDynamicAssembly(AssemblyName name, AssemblyBuilderAccess access, string dir, Evidence evidence, PermissionSet requiredPermissions, PermissionSet optionalPermissions, PermissionSet refusedPermissions);
• [0218] [C++] AssemblyBuilder* DefineDynamicAssembly(AssemblyName* name, AssemblyBuilderAccess access, String* dir, Evidence* evidence, PermissionSet* requiredPermissions, PermissionSet* optionalPermissions, PermissionSet* refusedPermissions);
• [0219] [VB] Function DefineDynamicAssembly(ByVal name As AssemblyName, ByVal access As AssemblyBuilderAccess, ByVal dir As String, ByVal evidence As Evidence, ByVal requiredPermissions As PermissionSet, ByVal optionalPermissions As PermissionSet, ByVal refusedPermissions As PermissionSet) As AssemblyBuilder
• [0220] [JScript] function DefineDynamicAssembly(name: AssemblyName, access: AssemblyBuilderAccess, dir: String, evidence: Evidence, requiredPermissions: PermissionSet, optionalPermissions: PermissionSet, refusedPermissions: PermissionSet): AssemblyBuilder;
  Description

[0221] DefineDynamicAssembly

• [0222] [C#] AssemblyBuilder DefineDynamicAssembly(AssemblyName name, AssemblyBuilderAccess access, string dir, Evidence evidence, PermissionSet requiredPermissions, PermissionSet optionalPermissions, PermissionSet refusedPermissions, bool is Synchronized);
• [0223] [C++] AssemblyBuilder* DefineDynamicAssembly(AssemblyName* name, AssemblyBuilderAccess access, String* dir, Evidence* evidence, PermissionSet* requiredPermissions, PermissionSet* optionalPermissions, PermissionSet* refusedPermissions, bool is Synchronized);
• [0224] [VB] Function DefineDynamicAssembly(ByVal name As AssemblyName, ByVal access As AssemblyBuilderAccess, ByVal dir As String, ByVal evidence As Evidence, ByVal requiredPermissions As PermissionSet, ByVal optionalPermissions As PermissionSet, ByVal refusedPermissions As PermissionSet, ByVal is Synchronized As Boolean) As AssemblyBuilder
• [0225] [JScript] function DefineDynamicAssembly(name: AssemblyName, access: AssemblyBuilderAccess, dir: String, evidence: Evidence, requiredPermissions: PermissionSet, optionalPermissions: PermissionSet, refusedPermissions: PermissionSet, is Synchronized: Boolean): AssemblyBuilder;
  Description

[0226] DoCallBack

• [0227] [C#] void DoCallBack(CrossAppDomainDelegate theDelegate);
• [0228] [C++] void DoCallBack(CrossAppDomainDelegate* theDelegate);
• [0229] [VB] Sub DoCallBack(ByVal theDelegate As CrossAppDomainDelegate)
• [0230] [JScript] function DoCallBack(theDelegate: CrossAppDomainDelegate);
  Description

[0231] Equals

• [0232] [C#] bool Equals(object other);
• [0233] [C++] bool Equals(Object* other);
• [0234] [VB] Function Equals(ByVal other As Object) As Boolean
• [0235] [JScript] function Equals(other: Object): Boolean;
  Description

[0236] ExecuteAssembly

• [0237] [C#] int ExecuteAssembly(string assemblyFile);
• [0238] [C++] int ExecuteAssembly(String* assemblyFile);
• [0239] [VB] Function ExecuteAssembly(ByVal assemblyFile As String) As Integer
• [0240] [JScript] function ExecuteAssembly(assemblyFile: String): int;
  Description

[0241] ExecuteAssembly

• [0242] 8 [C#] int ExecuteAssembly(string assemblyFile, Evidence assemblySecurity);
• [0243] [C++] int ExecuteAssembly(String* assemblyFile, Evidence* assemblySecurity);
• [0244] [VB] Function ExecuteAssembly(ByVal assemblyFile As String, ByVal assemblySecurity As Evidence) As Integer
• [0245] [JScript] function ExecuteAssembly(assemblyFile: String, assemblySecurity: Evidence): int;
  Description

[0246] ExecuteAssembly

• [0247] [C#] int ExecuteAssembly(string assemblyFile, Evidence assemblySecurity, string[ ] args);
• [0248] [C++] int ExecuteAssembly(String* assemblyFile, Evidence* assemblySecurity, String* args _gc[ ]);
• [0249] [VB] Function ExecuteAssembly(ByVal assemblyFile As String, ByVal assemblySecurity As Evidence, ByVal args( ) As String) As Integer
• [0250] [JScript] function ExecuteAssembly(assemblyFile: String, assemblySecurity: Evidence, args: String[ ]): int;
  Description

[0251] GetAssemblies

• [0252] [C#] Assembly[ ] GetAssemblies( );
• [0253] [C++] Assembly* GetAssemblies( )[ ]
• [0254] [VB] Function GetAssemblies( ) As Assembly( )
• [0255] [JScript] function GetAssemblies( ): Assembly[ ];
  Description

[0256] GetData

• [0257] [C#] object GetData(string name);
• [0258] [C++] Object* GetData(String* name);
• [0259] [VB] Function GetData(ByVal name As String) As Object
• [0260] [JScript] function GetData(name: String): Object;
  Description

[0261] GetHashCode

• [0262] [C#] int GetHashCode( );
• [0263] [C++] int GetHashCode( );
• [0264] [VB] Function GetHashCode( ) As Integer
• [0265] [JScript] function GetHashCode( ): int;
  Description

[0266] GetLifetimeService

• [0267] [C#] object GetLifetimeService( );
• [0268] [C++] Object* GetLifetimeService( );
• [0269] [VB] Function GetLifetimeService( ) As Object
• [0270] [JScript] function GetLifetimeService( ): Object;
  Description

[0271] GetType

• [0272] [C#] Type GetType( );
• [0273] [C++] Type* GetType( );
• [0274] [VB] Function GetType( ) As Type
• [0275] [JScript] function GetType( ): Type;
  Description

[0276] InitializeLifetimeService

• [0277] [C#] object InitializeLifetimeService( );
• [0278] [C++] Object* InitializeLifetimeService( );
• [0279] [VB] Function InitializeLifetimeService( ) As Object
• [0280] [JScript] function InitializeLifetimeService( ): Object;
  Description

[0281] Load

• [0282] [C#] Assembly Load(AssemblyName assemblyRef);
• [0283] [C++] Assembly* Load(AssemblyName* assemblyRef);
• [0284] [VB] Function Load(ByVal assemblyRef As AssemblyName) As Assembly
• [0285] [JScript] function Load(assemblyRef: AssemblyName): Assembly;
  Description

[0286] Load

• [0287] [C#] Assembly Load(byte[ ] rawAssembly);
• [0288] [C++] Assembly* Load(unsigned char rawAssembly _gc[ ]);
• [0289] [VB] Function Load(ByVal rawAssembly( ) As Byte) As Assembly
• [0290] [JScript] function Load(rawAssembly: Byte[ ]): Assembly;
  Description

[0291] Load

• [0292] [C#] Assembly Load(string assemblyString);
• [0293] [C++] Assembly* Load(String* assemblyString);
• [0294] [VB] Function Load(ByVal assemblyString As String) As Assembly
• [0295] [JScript] function Load(assemblyString: String): Assembly;
  Description

[0296] Load

• [0297] [C#] Assembly Load(AssemblyName assemblyRef, Evidence assemblySecurity);
• [0298] [C++] Assembly* Load(AssemblyName* assemblyRef, Evidence* assemblySecurity);
• [0299] [VB] Function Load(ByVal assemblyRef As AssemblyName, ByVal assemblySecurity As Evidence) As Assembly
• [0300] [JScript] function Load(assemblyRef: AssemblyName, assemblySecurity: Evidence): Assembly;
  Description

[0301] Load

• [0302] [C#] Assembly Load(byte[ ] rawAssembly, byte[ ] rawSymbolStore);
• [0303] [C++] Assembly* Load(unsigned char rawAssembly _gc[ ], unsigned char rawSymbolStore _gc[ ]);
• [0304] [VB] Function Load(ByVal rawAssembly( ) As Byte, ByVal rawSymbolStore( ) As Byte) As Assembly
• [0305] [JScript] function Load(rawAssembly: Byte[ ], rawSymbolStore: Byte[ ]): Assembly;
  Description

[0306] Load

• [0307] [C#] Assembly Load(string assemblyString, Evidence assemblySecurity);
• [0308] [C++] Assembly* Load(String* assemblyString, Evidence* assemblySecurity);
• [0309] [VB] Function Load(ByVal assemblyString As String, ByVal assemblySecurity As Evidence) As Assembly
• [0310] [JScript] function Load(assemblyString: String, assemblySecurity: Evidence): Assembly;
  Description

[0311] Load

• [0312] [C#] Assembly Load(AssemblyName assemblyRef, Evidence assemblySecurity, string callerLocation);
• [0313] [C++] Assembly* Load(AssemblyName* assemblyRef, Evidence* assemblySecurity, String* callerLocation);
• [0314] [VB] Function Load(ByVal assemblyRef As AssemblyName, ByVal assemblySecurity As Evidence, ByVal callerLocation As String) As Assembly
• [0315] [JScript] function Load(assemblyRef: AssemblyName, assemblySecurity: Evidence, callerLocation: String): Assembly;
  Description

[0316] Load

• [0317] [C#] Assembly Load(byte[ ] rawAssembly, byte[ ] rawSymbolStore, Evidence securityEvidence);
• [0318] [C++] Assembly* Load(unsigned char rawAssembly _gc[ ], unsigned char rawSymbolStore _gc[ ], Evidence* securityEvidence);
• [0319] [VB] Function Load(ByVal rawAssembly( ) As Byte, ByVal rawSymbolStore( ) As Byte, ByVal securityEvidence As Evidence) As Assembly
• [0320] [JScript] function Load(rawAssembly: Byte[ ], rawSymbolStore: Byte[ ], securityEvidence: Evidence): Assembly;
  Description

[0321] Load

• [0322] [C#] Assembly Load(string assemblyString, Evidence assemblySecurity, string callerLocation);
• [0323] [C++] Assembly* Load(String* assemblyString, Evidence* assemblySecurity, String* callerLocation);
• [0324] [VB] Function Load(ByVal assemblyString As String, ByVal assemblySecurity As Evidence, ByVal callerLocation As String) As Assembly
• [0325] [JScript] function Load(assemblyString: String, assemblySecurity: Evidence, callerLocation: String): Assembly;
  Description

[0326] SetAppDomainPolicy

• [0327] [C#] void SetAppDomainPolicy(PolicyLevel domainPolicy);
• [0328] [C++] void SetAppDomainPolicy(PolicyLevel* domainPolicy);
• [0329] [VB] Sub SetAppDomainPolicy(ByVal domainPolicy As PolicyLevel)
• [0330] [JScript] function SetAppDomainPolicy(domainPolicy: PolicyLevel);
  Description

[0331] SetCachePath

• [0332] [C#] void SetCachePath(string s);
• [0333] [C++] void SetCachePath(String* s);
• [0334] [VB] Sub SetCachePath(ByVal a As String)
• [0335] [JScript] function SetCachePath(s: String);
  Description

[0336] SetData

• [0337] [C#] void SetData(string name, object data);
• [0338] [C++] void SetData(String* name, Object* data);
• [0339] [VB] Sub SetData(ByVal name As String, ByVal data As Object)
• [0340] [JScript] function SetData(name: String, data: Object);
  Description

[0341] SetPrincipalPolicy

• [0342] [C#] void SetPrincipalPolicy(PrincipalPolicy policy);
• [0343] [C++] void SetPrincipalPolicy(PrincipalPolicy policy);
• [0344] [VB] Sub SetPrincipalPolicy(ByVal policy As PrincipalPolicy)
• [0345] [JScript] function SetPrincipalPolicy(policy: PrincipalPolicy);
  Description

[0346] SetShadowCopyPath

• [0347] [C#] void SetShadowCopyPath(string s);
• [0348] [C++] void SetShadowCopyPath(String* s);
• [0349] [VB] Sub SetShadowCopyPath(ByVal s As String)
• [0350] [JScript] function SetShadowCopyPath(s: String);
  Description

[0351] SetThreadPrincipal

• [0352] [C#] void SetThreadPrincipal(IPrincipal principal);
• [0353] [C++] void SetThreadPrincipal(IPrincipal* principal);
• [0354] [VB] Sub SetThreadPrincipal(ByVal principal As IPrincipal)
• [0355] [JScript] function SetThreadPrincipal(principal: IPrincipal);
  Description

[0356] ToString

• [0357] [C#] string ToString( );
• [0358] [C++] String* ToString( );
• [0359] [VB] Function ToString( ) As String
• [0360] [JScript] function ToString( ): String;
  Description

[0361] Activator class (System)

[0362] ToString

Description

[0363] Contains methods to create types of objects locally or remotely, or obtain references to existing remote objects.

[0364] The

[0365] System.Activator.CreateInstance(System.Type,System.Reflection.BindingFlags, System.Reflection.Binder,System.Object[ ],System.Globalization.CultureInfo) method creates an instance of a type defined in an assembly by invoking the constructor that best matches the specified arguments. If no arguments are specified, the constructor that takes no parameters, that is, the default constructor, is invoked.

[0366] CreateComInstanceFrom

• [0367] [C#] public static ObjectHandle CreateComInstanceFrom(string assemblyName, string typeName);
• [0368] [C++] public: static ObjectHandle* CreateComInstanceFrom(String* assemblyName, String* typeName);
• [0369] [VB] Public Shared Function CreateComInstanceFrom(ByVal assemblyName As String, ByVal typeName As String) As ObjectHandle
• [0370] [JScript] public static function CreateComInstanceFrom(assemblyName: String, typeName: String): ObjectHandle;
  Description

[0371] Creates an instance of the COM object whose name is specified, using the named assembly file and the constructor that best matches the specified parameters.

Return Value: A handle, which must be unwrapped to access the newly created instance.

[0372] This method allows types to be created remotely without having to load the type locally. The name of a file that contains an assembly where the type named typeName is sought. The name of the desired type.

[0373] CreateInstance

• [0374] [C#] public static object CreateInstance(Type type);
• [0375] [C++] public: static Object* CreateInstance(Type* type);
• [0376] [VB] Public Shared Function CreateInstance(ByVal type As Type) As Object
• [0377] [JScript] public static function CreateInstance(type: Type): Object;
  Description

[0378] Creates an instance of the specified type using the constructor that best matches the specified parameter.

Return Value: A reference to the newly created object.

[0379] The constructor to be invoked must be accessible. The type of object to create.

[0380] CreateInstance

• [0381] [C#] public static ObjectHandle CreateInstance(string assemblyName, string typeName);
• [0382] [C++] public: static ObjectHandle* CreateInstance(String* assemblyName, String* typeName);
• [0383] [VB] Public Shared Function CreateInstance(ByVal assemblyName As String, ByVal typeName As String) As ObjectHandle
• [0384] [JScript] public static function CreateInstance(assemblyName: String, typeName: String): ObjectHandle;
  Description

[0385] Creates an instance of the type whose name is specified, using the named assembly and the constructor that best matches the specified parameters.

Return Value: A handle, which must be unwrapped to access the newly created instance.

[0386] This method allows types to be created remotely without having to load the type locally. The name of the assembly where the type named typeName is sought. If assemblyName is null, the executing assembly is searched. The name of the desired type.

[0387] CreateInstance

• [0388] [C#] public static object CreateInstance(Type type, object[ ] args);
• [0389] [C++] public: static Object* CreateInstance(Type* type, Object* args _gc[ ]);
• [0390] [VB] Public Shared Function CreateInstance(ByVal type As Type, ByVal args( ) As Object) As Object
• [0391] [JScript] public static function CreateInstance(type: Type, args: Object[ ]): Object;
  Description

[0392] Creates an instance of the specified type using the constructor that best matches the specified parameters.

Return Value: A reference to the newly created object.

[0393] The constructor to be invoked must be accessible and provide the most specific match with the specified argument list. The type of object to create. An array of arguments that match in number, order, and type the parameters of the constructor to invoke. If args is an empty array or null, the constructor that takes no parameters (the default constructor) is invoked.

[0394] CreateInstance

• [0395] [C#] public static ObjectHandle CreateInstance(string assemblyName, string typeName, object[ ] activationAttributes);
• [0396] [C++] public: static ObjectHandle* CreateInstance(String* assemblyName, String* typeName, Object* activationAttributes _gc[ ]);
• [0397] [VB] Public Shared Function CreateInstance(ByVal assemblyName As String, ByVal typeName As String, ByVal activationAttributes( ) As Object) As ObjectHandle
• [0398] [JScript] public static function CreateInstance(assemblyName: String, typeName: String, activationAttributes: Object[ ]): ObjectHandle;
  Description

[0399] Creates an instance of the type whose name is specified, using the named assembly and the constructor that best matches the specified parameters.

Return Value: A handle, which must be unwrapped to access the newly created instance.

[0400] This method allows types to be created remotely without having to load the type locally. The name of the assembly where the type named typeName is sought. If assemblyName is null, the executing assembly is searched. The name of the desired type. An array of one or more attributes that can participate in activation.

[0401] CreateInstance

• [0402] [C#] public static object CreateInstance(Type type, object[ ] args, object[ ] activationAttributes);
• [0403] [C++] public: static Object* CreateInstance(Type* type, Object* args _gc[ ], Object* activationAttributes _gc[ ]);
• [0404] [VB] Public Shared Function CreateInstance(ByVal type As Type, ByVal args( ) As Object, ByVal activationAttributes( ) As Object) As Object
• [0405] [JScript] public static function CreateInstance(type: Type, args: Object[ ], activationAttributes: Object[ ]): Object;
  Description

[0406] Creates an instance of the specified type using the constructor that best matches the specified parameters.

Return Value: A reference to the newly created object.

[0407] The constructor to be invoked must be accessible and provide the most specific match with the specified argument list. The type of object to create. An array of arguments that match in number, order, and type the parameters of the constructor to invoke. If args is an empty array or null, the constructor that takes no parameters (the default constructor) is invoked. An array of one or more attributes that can participate in activation.

[0408] CreateInstance

• [0409] [C#] public static object CreateInstance(Type type, BindingFlags bindingAttr, Binder binder, object[ ] args, CultureInfo culture);
• [0410] [C++] public: static Object* CreateInstance(Type* type, BindingFlags bindingAttr, Binder* binder, Object* args _gc[ ], CultureInfo* culture);
• [0411] [VB] Public Shared Function CreateInstance(ByVal type As Type, ByVal bindingAttr As BindingFlags, ByVal binder As Binder, ByVal args( ) As Object, ByVal culture As CultureInfo) As Object
• [0412] [JScript] public static function CreateInstance(type: Type, bindingAttr: BindingFlags, binder: Binder, args: Object[ ], culture: CultureInfo): Object; Creates an instance of the specified type using the constructor that best matches the specified parameters.
  Description

[0413] Creates an instance of the specified type using the constructor that best matches the specified parameters.

Return Value: A reference to the newly created object.

[0414] The constructor to be invoked must be accessible and provide the most specific match with the specified argument list under the constraints of the specified binder and binding attributes. The type of object to create. A combination of zero or more bit flags that affect the search for the type constructor. If bindingAttr is zero, a case-sensitive search for public properties is conducted. An object that uses bindingAttr and args to seek and identify the type constructor. If binder is null, the default binder is used. An array of arguments that match in number, order, and type the parameters of the constructor to invoke. If args is an empty array or null, the constructor that takes no parameters (the default constructor) is invoked. Culture-specific information that governs the coercion of args to the formal types declared for the type constructor. If culture is null, the System.Globalization.CultureInfo for the current thread is used.

[0415] CreateInstance

• [0416] [C#] public static object CreateInstance(Type type, BindingFlags bindingAttr, Binder binder, object[ ] args, CultureInfo culture, object[ ] activationAttributes);
• [0417] [C++] public: static Object* CreateInstance(Type* type, BindingFlags bindingAttr, Binder* binder, Object* args _gc[ ], CultureInfo* culture, Object* activationAttributes _gc[ ]);
• [0418] [VB] Public Shared Function CreateInstance(ByVal type As Type, ByVal bindingAttr As BindingFlags, ByVal binder As Binder, ByVal args( ) As Object, ByVal culture As CultureInfo, ByVal activationAttributes( ) As Object) As Object
• [0419] [JScript] public static function CreateInstance(type: Type, bindingAttr: BindingFlags, binder: Binder, args: Object[ ], culture: CultureInfo, activationAttributes: Object[ ]): Object;
  Description

[0420] Creates an instance of the specified type using the constructor that best matches the specified parameters.

Return Value: A reference to the newly created object.

[0421] The constructor to be invoked must be accessible and provide the most specific match with the specified argument list under the constraints of the specified binder and binding attributes. The type of object to create. A combination of zero or more bit flags that affect the search for the type constructor. If bindingAttr is zero, a case-sensitive search for public properties is conducted. An object that uses bindingAttr and args to seek and identify the type constructor. If binder is null, the default binder is used. An array of arguments that match in number, order, and type the parameters of the constructor to invoke. If args is an empty array or null, the constructor that takes no parameters (the default constructor) is invoked. Culture-specific information that governs the coercion of args to the formal types declared for the type constructor. If culture is null, the System.Globalization.CultureInfo for the current thread is used. An array of one or more attributes that can participate in activation.

[0422] CreateInstance

• [0423] [C#] public static ObjectHandle CreateInstance(string assemblyName, string typeName, bool ignoreCase, BindingFlags bindingAttr, Binder binder, object[ ] args, CultureInfo culture, object[ ] activationAttributes, Evidence securityInfo);
• [0424] [C++] public: static ObjectHandle* CreateInstance(String* assemblyName, String* typeName, bool ignoreCase, BindingFlags bindingAttr, Binder* binder, Object* args _gc[ ], CultureInfo* culture, Object* activationAttributes _gc[ ], Evidence* securityInfo);
• [0425] [VB] Public Shared Function CreateInstance(ByVal assemblyName As String, ByVal typeName As String, ByVal ignoreCase As Boolean, ByVal bindingAttr As BindingFlags, ByVal binder As Binder, ByVal args( ) As Object, ByVal culture As CultureInfo, ByVal activationAttributes( ) As Object, ByVal securityInfo As Evidence) As ObjectHandle
• [0426] [JScript] public static function CreateInstance(assemblyName: String, typeName: String, ignoreCase: Boolean, bindingAttr: BindingFlags, binder: Binder, args: Object[ ], culture: CultureInfo, activationAttributes: Object[ ], securityInfo Evidence): ObjectHandle;
  Description

[0427] Creates an instance of the type whose name is specified, using the named assembly and the constructor that best matches the specified parameters.

Return Value: A handle, which must be unwrapped to access the newly created instance.

[0428] This method allows types to be created remotely without having to load the type locally. The name of the assembly where the type named typeName is sought. If assemblyName is null, the executing assembly is searched. The name of the desired type. A Boolean that specifies whether the search for typeName is case-sensitive. If ignoreCase is true, the search is not case-sensitive. A combination of zero or more bit flags that affect the search for the typeName constructor. If bindingAttr is zero, a case-sensitive search for public properties is conducted. An object that uses bindingAttr and args to seek and identify the typeName constructor. If binder is null, the default binder is used. An array of arguments that match in number, order, and type the parameters of the constructor to invoke. If args is an empty array or null, the constructor that takes no parameters (the default constructor) is invoked. Culture-specific information that governs the coercion of args to the formal types declared for the typeName constructor. If culture is null, the System.Globalization.CultureInfo for the current thread is used. An array of one or more attributes that can participate in activation. Information used to make security policy decisions and grant code permissions.

[0429] CreateInstanceFrom

• [0430] [C#] public static ObjectHandle CreateInstanceFrom(string assemblyFile, string typeName);
• [0431] [C++] public: static ObjectHandle* CreateInstanceFrom(String* assemblyFile, String* typeName);
• [0432] [VB] Public Shared Function CreateInstanceFrom(ByVal assemblyFile As String, ByVal typeName As String) As ObjectHandle
• [0433] [JScript] public static function CreateInstanceFrom(assemblyFile: String, typeName: String): ObjectHandle; Creates an instance of the type whose name is specified, using the named assembly file and the constructor that best matches the specified parameters.
  Description

[0434] Creates an instance of the type whose name is specified, using the named assembly file and the constructor that best matches the specified parameters.

Return Value: A handle, which must be unwrapped to access the newly created instance.

[0435] This method allows types to be created remotely without having to load the type locally. The name of a file that contains an assembly where the type named typeName is sought. The name of the desired type.

[0436] CreateInstanceFrom

• [0437] [C#] public static ObjectHandle CreateInstanceFrom(string assemblyFile, string typeName, object[ ] activationAttributes);
• [0438] [C++] public: static ObjectHandle* CreateInstanceFrom(String* assemblyFile, String* typeName, Object* activationAttributes _gc[ ]);
• [0439] [VB] Public Shared Function CreateInstanceFrom(ByVal assemblyFile As String, ByVal typeName As String, ByVal activationAttributes( ) As Object) As ObjectHandle
• [0440] [JScript] public static function CreateInstanceFrom(assemblyFile: String, typeName: String, activationAttributes: Object[ ]): ObjectHandle;
  Description

[0441] Creates an instance of the type whose name is specified, using the named assembly file and the constructor that best matches the specified parameters.

Return Value: A handle, which must be unwrapped to access the newly created instance.

[0442] This method allows types to be created remotely without having to load the type locally. The name of a file that contains an assembly where the type named typeName is sought. The name of the desired type. An array of one or more attributes that can participate in activation.

[0443] CreateInstanceFrom

• [0444] [C#] public static ObjectHandle CreateInstanceFrom(string assemblyFile, string typeName, bool ignoreCase, BindingFlags bindingAttr, Binder binder, object[ ] args, CultureInfo culture, object[ ] activationAttributes, Evidence securityInfo);
• [0445] [C++] public: static ObjectHandle* CreateInstanceFrom(String* assemblyFile, String* typeName, bool ignoreCase, BindingFlags bindingAttr, Binder* binder, Object* args _gc[ ], CultureInfo* culture, Object* activationAttributes _gc[ ], Evidence* securityInfo);
• [0446] [VB] Public Shared Function CreateInstanceFrom(ByVal assemblyFile As String, ByVal typeName As String, ByVal ignoreCase As Boolean, ByVal bindingAttr As BindingFlags, ByVal binder As Binder, ByVal args( ) As Object, ByVal culture As CultureInfo, ByVal activationAttributes( ) As Object, ByVal securityInfo As Evidence) As ObjectHandle
• [0447] [JScript] public static function CreateInstanceFrom(assemblyFile: String, typeName: String, ignoreCase: Boolean, bindingAttr: BindingFlags, binder: Binder, args: Object[ ], culture: CultureInfo, activationAttributes: Object[ ], securityInfo: Evidence): ObjectHandle;
  Description

[0448] Creates an instance of the type whose name is specified, using the named assembly file and the constructor that best matches the specified parameters.

Return Value: A handle, which must be unwrapped to access the newly created instance.

[0449] This method allows types to be created remotely without having to load the type locally. The name of a file that contains an assembly where the type named typeName is sought. The name of the desired type. A Boolean that specifies whether the search for typeName is case-sensitive. If ignoreCase is true, the search is not case-sensitive. A combination of zero or more bit flags that affect the search for the typeName constructor. If bindingAttr is zero, a case-sensitive search for public properties is conducted. An object that uses bindingAttr and args to seek and identify the typeName constructor. If binder is null, the default binder is used. An array of arguments that match in number, order, and type the parameters of the constructor to invoke. If args is an empty array or null, the constructor that takes no parameters (the default constructor) is invoked. Culture-specific information that governs the coercion of args to the formal types declared for the typeName constructor. If culture is null, the System.Globalization.CultureInfo for the current thread is used. An array of one or more attributes that can participate in activation. Information used to make security policy decisions and grant code permissions.

[0450] GetObject

• [0451] [C#] public static object GetObject(Type type, string url);
• [0452] [C++] public: static Object* GetObject(Type* type, String* url);
• [0453] [VB] Public Shared Function GetObject(ByVal type As Type, ByVal url As String) As Object
• [0454] [JScript] public static function GetObject(type: Type, url: String): Object; Creates a proxy for a currently running remote object, server-activated well-known object, or web service.
  Description

[0455] Creates a proxy for the well-known object indicated by the specified type and URL.

[0456] Return Value: A proxy that points to an endpoint served by the requested well-known object. Call the proxy to send messages to the remote object. No messages are sent over the network until a method is called on the proxy. The type of the well-known object to which you want to connect. The URL of the well-known object.

[0457] GetObject

• [0458] [C#] public static object GetObject(Type type, string url, object state);
• [0459] [C++] public: static Object* GetObject(Type* type, String* url, Object* state);
• [0460] [VB] Public Shared Function GetObject(ByVal type As Type, ByVal url As String, ByVal state As Object) As Object
• [0461] [JScript] public static function GetObject(type: Type, url: String, state: Object) Object;
  Description

[0462] Creates a proxy for the well-known object indicated by the specified type, URL, and channel data.

Return Value: A proxy that points to an endpoint served by the requested well-known object.

[0463] Call the proxy to send messages to the remote object. No messages are sent over the network until a method is called on the proxy. The type of the well-known object to which you want to connect. The URL of the well-known object. Channel-specific data or null.

[0464] AppDomain class (System)

[0465] ToString

Description

[0466] Represents an application domain, which is an isolated environment where applications execute. This class cannot be inherited.

[0467] Application domains isolate executing applications from one another. One or more applications can run in a single application domain.

[0468] BaseDirectory

[0469] ToString

• [0470] [C#] public string BaseDirectory {get;}
• [0471] [C++] public: _property String* get_BaseDirectory( );
• [0472] [VB] Public ReadOnly Property BaseDirectory As String
• [0473] [JScript] public function get BaseDirectory( ): String;
  Description

[0474] Gets the base directory that the assembly resolver used to probe for assemblies.

[0475] This property corresponds to the assembly resolver's APPBASE.

[0476] CurrentDomain

[0477] ToString

• [0478] [C#] public static AppDomain CurrentDomain {get;}
• [0479] [C++] public: _property static AppDomain* get_CurrentDomain( );
• [0480] [VB] Public Shared ReadOnly Property CurrentDomain As AppDomain
• [0481] [JScript] public static function get CurrentDomain( ): AppDomain;
  Description

[0482] Gets the current application domain for the current System.Threading.Thread.

[0483] DynamicDirectory

[0484] ToString

• [0485] [C#] public string DynamicDirectory {get;}
• [0486] [C++] public: _property String* get_DynamicDirectory( );
• [0487] [VB] Public ReadOnly Property DynamicDirectory As String
• [0488] [JScript] public function get DynamicDirectory( ): String;
  Description

[0489] Gets the directory that the assembly resolver used to probe for dynamically-created assemblies.

[0490] Only available once an attempt has been made to load an assembly into this domain.

[0491] Evidence

[0492] ToString

• [0493] [C#] public Evidence Evidence {get;}
• [0494] [C++] public: _property Evidence* get_Evidence( );
• [0495] [VB] Public ReadOnly Property Evidence As Evidence
• [0496] [JScript] public function get Evidence( ): Evidence;
  Description

[0497] Gets the System.Security.Policy.Evidence associated with this application domain that is used as input to security policy.

[0498] FriendlyName

[0499] ToString

• [0500] [C#] public string FriendlyName {get;}
• [0501] [C++] public: _property String* get_FriendlyName( );
• [0502] [VB] Public ReadOnly Property FriendlyName As String
• [0503] [JScript] public function get FriendlyName( ): String;
  Description

[0504] Gets the friendly name of this application domain.

[0505] The friendly name of the default application domain is the name of the assembly file loaded in the application domain. The friendly name is formed by stripping the directory specification from the assembly's codebase. For example, if an assembly with the file name “c:MyAppDirectoryMyAssembly.exe” is loaded in the default application domain, the friendly name of that application domain is “MyAssembly.exe”.

[0506] RelativeSearchPath

[0507] ToString

• [0508] [C#] public string RelativeSearchPath {get;}
• [0509] [C++] public: _property String* get_RelativeSearchPath( );
• [0510] [VB] Public ReadOnly Property RelativeSearchPath As String
• [0511] [JScript] public function get RelativeSearchPath( ): String;
  Description

[0512] Gets the path relative to the base directory where the assembly resolver should probe for private assemblies.

[0513] Private assemblies are deployed in the same directory structure as the application.

[0514] SetupInformation

[0515] ToString

• [0516] [C#] public AppDomainSetup SetupInformation {get;}
• [0517] [C++] public: _property AppDomainSetup* get_SetupInformation( );
• [0518] [VB] Public ReadOnly Property SetupInformation As AppDomainSetup
• [0519] [JScript] public function get SetupInformation( ): AppDomainSetup;
  Description

[0520] Gets the application domain configuration information for this instance.

[0521] ShadowCopyFiles

[0522] ToString

• [0523] [C#] public bool ShadowCopyFiles {get;}
• [0524] [C++] public: _property bool get_ShadowCopyFiles( );
• [0525] [VB] Public ReadOnly Property ShadowCopyFiles As Boolean
• [0526] [JScript] public function get ShadowCopyFiles( ): Boolean;
  Description

[0527] Gets an indication whether all assemblies that are loaded in the application domain are shadow copied.

[0528] This method sets the System.AppDomainSetup.ShadowCopyFiles property of the internal System.AppDomainSetup object associated with this instance.

[0529] ToString

• [0530] [C#] public event AssemblyLoadEventHandler AssemblyLoad;
• [0531] [C++] public: _sealed _event AssemblyLoadEventHandler* AssemblyLoad;
• [0532] [VB] NotOverridable Public Event AssemblyLoad As AssemblyLoadEventHandler
  Description

[0533] Occurs when an assembly is loaded.

[0534] The System.AssemblyLoadEventHandler for this event can attempt to locate the assembly and load it.

[0535] ToString

• [0536] [C#] public event ResolveEventandler AssemblyResolve;
• [0537] [C++] public: _sealed _event ResolveEventandler* AssemblyResolve;
• [0538] [VB] NotOverridable Public Event AssemblyResolve As ResolveEventHandler
  Description

[0539] Occurs when the resolution of an assembly fails.

[0540] The System.ResolveEventHandler for this event can attempt to locate the assembly and load it.

[0541] ToString

• [0542] [C#] public event EventHandler DomainUnload;
• [0543] [C++] public: _sealed _event EventHandler* DomainUnload;
• [0544] [VB] NotOverridable Public Event DomainUnload As EventHandler
  Description

[0545] Occurs when an System.AppDomain is about to be unloaded.

[0546] The System.EventHandler for this event can attempt to locate the assembly and load it.

[0547] ToString

• [0548] [C#] public event EventHandler ProcessExit;
• [0549] [C++] public: _sealed _event EventHandler* ProcessExit;
• [0550] [VB] NotOverridable Public Event ProcessExit As EventHandler
  Description

[0551] Occurs when a process is about to exit.

[0552] The System.EventHandler for this event can perform termination activities, such as closing files, releasing storage and so on, before the process ends.

[0553] ToString

• [0554] [C#] public event ResolveEventHandler ResourceResolve;
• [0555] [C++] public: _sealed _event ResolveEventHandler* ResourceResolve;
• [0556] [VB] NotOverridable Public Event ResourceResolve As ResolveEventHandler
  Description

[0557] Occurs when the resolution of a resource fails.

[0558] The System.ResolveEventHandler for this event can attempt to locate the resource and load it.

[0559] ToString

• [0560] [C#] public event ResolveEventHandler TypeResolve;
• [0561] [C++] public: _sealed _event ResolveEventHandler* TypeResolve;
• [0562] [VB] NotOverridable Public Event TypeResolve As ResolveEventHandler
  Description

[0563] Occurs when the resolution of a type fails.

[0564] The System.ResolveEventHandler for this event can attempt to locate the type and load it.

[0565] ToString

• [0566] [C#] public event UnhandledExceptionEventHandler UnhandledException;
• [0567] [C++] public: _sealed _event UnhandledExceptionEventHandler* UnhandledException;
• [0568] [VB] NotOverridable Public Event UnhandledException As UnhandledExceptionEventHandler
  Description

[0569] Occurs when an exception is not caught by an event handler.

[0570] For more information about handling events, see.

[0571] AppendPrivatePath

• [0572] [C#] public void AppendPrivatePath(string path);
• [0573] [C++] public: _sealed void AppendPrivatePath(String* path);
• [0574] [VB] NotOverridable Public Sub AppendPrivatePath(ByVal path As String)
• [0575] [JScript] public function AppendPrivatePath(path: String);
  Description

[0576] Appends the specified name of the directory to the private path.

[0577] The private path, or relative search path, is the path relative to the base directory where the assembly resolver probes for private assemblies. The name of the directory to be appended to the private path.

[0578] ClearPrivatePath

• [0579] [C#] public void ClearPrivatePath( );
• [0580] [C++] public: _sealed void ClearPrivatePath( );
• [0581] [VB] NotOverridable Public Sub ClearPrivatePath( )
• [0582] [JScript] public function ClearPrivatePath( );
  Description

[0583] Resets the System.AppDomainSetup.PrivateBinPath for this instance to null.

[0584] ClearShadowCopyPath

• [0585] [C#] public void ClearShadowCopyPath( );
• [0586] [C++] public: _sealed void ClearShadowCopyPath( );
• [0587] [VB] NotOverridable Public Sub ClearShadowCopyPath( )
• [0588] [JScript] public function ClearShadowCopyPath( );
  Description

[0589] Resets the System.AppDomainSetup.ShadowCopyDirectories property for this instance to null

[0590] CreateComInstanceFrom

• [0591] [C#] public ObjectHandle CreateComInstanceFrom(string assemblyName, string typeName);
• [0592] [C++] public: ObjectHandle* CreateComInstanceFrom(String* assemblyName, String* typeName);
• [0593] [VB] Public Function CreateComInstanceFrom(ByVal assemblyName As String, ByVal typeName As String) As ObjectHandle
• [0594] [JScript] public function CreateComInstanceFrom(assemblyName: String, typeName: String): ObjectHandle;
  Description

[0595] Creates an instance of a COM object. Parameters specify the name of the assembly that can create the object and the name of the type of the object.

Return Value: An object that is a wrapper for the new instance.

[0596] Use this method to create types remotely without having to load the type locally. The return value must to be unwrapped in order to access the real object. The name of the assembly in which this object type resides. The type name of the desired object.

[0597] CreateDomain

• [0598] [C#] public static AppDomain CreateDomain(string friendlyName);
• [0599] [C++] public: static AppDomain* CreateDomain(String* friendlyName);
• [0600] [VB] Public Shared Function CreateDomain(ByVal friendlyName As String) As AppDomain
• [0601] [JScript] public static function CreateDomain(friendlyName: String): AppDomain;
  Description

[0602] Creates a new application domain with the specified name.

Return Value: The newly created application domain.

[0603] friendlyName can be displayed in user interfaces to identify the domain. The friendly name of the domain.

[0604] CreateDomain

• [0605] [C#] public static AppDomain CreateDomain(string friendlyName, Evidence securityInfo);
• [0606] [C++] public: static AppDomain* CreateDomain(String* friendlyName, Evidence* securityInfo);
• [0607] [VB] Public Shared Function CreateDomain(ByVal friendlyName As String, ByVal securityInfo As Evidence) As AppDomain
• [0608] [JScript] public static function CreateDomain(friendlyName: String, securityInfo: Evidence): AppDomain; Creates a new application domain.
  Description

[0609] Creates a new application domain with the given name using the supplied evidence.

[0610] Return Value: The newly created application domain. The friendly name of the domain. This friendly name can be displayed in user interfaces to identify the domain. See the description of System.AppDomain.FriendlyName. Evidence mapped through security policy to establish a top-of-stack permission set.

[0611] CreateDomain

• [0612] [C#] public static AppDomain CreateDomain(string friendlyName, Evidence securityInfo, AppDomainSetup info);
• [0613] [C++] public: static AppDomain* CreateDomain(String* friendlyName, Evidence* securityInfo, AppDomainSetup* info);
• [0614] [VB] Public Shared Function CreateDomain(ByVal friendlyName As String, ByVal securityInfo As Evidence, ByVal info As AppDomainSetup) As AppDomain
• [0615] [JScript] public static function CreateDomain(friendlyName: String, securityInfo: Evidence, info: AppDomainSetup): AppDomain;
  Description

[0616] Creates a new application domain using the specified name, evidence, application domain setup information.

[0617] Return Value: The newly created application domain. The friendly name of the domain. This friendly name can be displayed in user interfaces to identify the domain. See the description of System.AppDomain.FriendlyName. Evidence mapped through security policy to establish a top-of-stack permission set. An object that contains application domain initialization information.

[0618] CreateDomain

• [0619] [C#] public static AppDomain CreateDomain(string friendlyName, Evidence securityInfo, string appBasePath, string appRelativeSearchPath, bool shadowCopyFiles);
• [0620] [C++] public: static AppDomain* CreateDomain(String* friendlyName, Evidence* securityInfo, String* appBasePath, String* appRelativeSearchPath, bool shadowCopyFiles);
• [0621] [VB] Public Shared Function CreateDomain(ByVal friendlyName As String, ByVal securityInfo As Evidence, ByVal appBasePath As String, ByVal appRelativeSearchPath As String, ByVal shadowCopyFiles As Boolean) As AppDomain
• [0622] [JScript] public static function CreateDomain(friendlyName: String, securityInfo: Evidence, appBasePath: String, appRelativeSearchPath: String, shadowCopyFiles: Boolean): AppDomain;
  Description

[0623] Creates a new application domain with the given name using, evidence, application base path, relative search path, and a parameter that specifies whether a shadow copy of an assembly is to be loaded in to the application domain.

[0624] Return Value: The newly created application domain. The friendly name of the domain. This friendly name can be displayed in user interfaces to identify the domain. See the description of System.AppDomain.FriendlyName. Evidence mapped through security policy to establish a top-of-stack permission set. The base directory that the assembly resolver uses to probe for assemblies. See the
Description of System.AppDomain.BaseDirectory. The path relative to the base directory where the assembly resolver should probe for private assemblies. See the
Description of System.AppDomain.RelativeSearchPath. If true, a shadow copy of an assembly is loaded into this application domain.

[0625] CreateInstance

• [0626] [C#] public ObjectHandle CreateInstance(string assemblyName, string typeName);
• [0627] [C++] public: _sealed ObjectHandle* CreateInstance(String* assemblyName, String* typeName);
• [0628] [VB] NotOverridable Public Function CreateInstance(ByVal assemblyName As String, ByVal typeName As String) As ObjectHandle
• [0629] [JScript] public function CreateInstance(assemblyName: String, typeName: String): ObjectHandle; Creates a new instance of a specified type defined in the specified assembly file.
  Description

[0630] Creates a new instance of the specified type defined in the specified assembly.

Return Value: An object that is a wrapper for the new instance, or null if typeName is not found. The return value needs to be unwrapped to access the real object.

[0631] This is a convenience method that calls the default constructor for typeName. The display name of the assembly. See the description of System.Reflection.AssemblyName for the format of the display name. The full name of the type.

[0632] CreateInstance

• [0633] [C#] public ObjectHandle CreateInstance(string assemblyName, string typeName, object[ ] activationAttributes);
• [0634] [C++] public: _sealed ObjectHandle* CreateInstance(String* assemblyName, String* typeName, Object* activationAttributes _gc[ ]);
• [0635] [VB] NotOverridable Public Function CreateInstance(ByVal assemblyName As String, ByVal typeName As String, ByVal activationAttributes( ) As Object) As ObjectHandle
• [0636] [JScript] public function CreateInstance(assemblyName: String, typeName: String, activationAttributes: Object[ ]): ObjectHandle;
  Description

[0637] Creates an instance using the name of the type and the assembly where it exists.

Return Value: A handle to the requested object.

[0638] This method allows types to be created remotely without having to load the type locally. This will return an System.Runtime.Remoting.ObjectHandle that needs to be unwrapped in order to access the real object. The name of the assembly in which this object type resides. The type name of the desired object. One or more attributes that can participate in activation.

[0639] CreateInstance

• [0640] [C#] public ObjectHandle CreateInstance(string assemblyName, string typeName, bool ignoreCase, BindingFlags bindingAttr, Binder binder, object[ ] args, CultureInfo culture, object[ ] activationAttributes, Evidence securityAttributes);
• [0641] [C++] public: _sealed ObjectHandle* CreateInstance(String* assemblyName, String* typeName, bool ignoreCase, BindingFlags bindingAttr, Binder* binder, Object* args _gc[ ], CultureInfo* culture, Object* activationAttributes _gc[ ], Evidence* securityAttributes);
• [0642] [VB] NotOverridable Public Function CreateInstance(ByVal assemblyName As String, ByVal typeName As String, ByVal ignoreCase As Boolean, ByVal bindingAttr As BindingFlags, ByVal binder As Binder, ByVal args( ) As Object, ByVal culture As CultureInfo, ByVal activationAttributes( ) As Object, ByVal securityAttributes As Evidence) As ObjectHandle
• [0643] [JScript] public function CreateInstance(assemblyName: String, typeName: String, ignoreCase: Boolean, bindingAttr: BindingFlags, binder: Binder, args: Object[ ], culture: CultureInfo, activationAttributes: Object[ ], securityAttributes: Evidence): ObjectHandle;
  Description

[0644] Creates an instance using the name of the type and the assembly where it exists.

Return Value: A handle to the requested object.

[0645] This method allows types to be created remotely without having to load the type locally. This will return an System.Runtime.Remoting.ObjectHandle that needs to be unwrapped in order to access the real object. The name of the assembly in which this object type resides. The type name of the desired object. A Boolean value specifying whether to perform a case-sensitive search or not. This bitmask affects the way in which the search is conducted. The value is a combination of zero or more bit flags from System.Reflection.BindingFlags, such as NonPublic and OABinding. An object that enables the binding, coercion of argument types, invocation of members and retrieval of System.Reflection.MemberInfo objects using reflection. If binder is null, the default binder is used. The arguments to be passed to the constructor. This array of arguments must match in number, order, and type the parameters of the constructor to be invoked. If the default constructor is desired, args must be an empty array or null. An instance of System.Globalization.CultureInfo used to govern the coercion of types. If this is null, the CultureInfo for the current thread is used. (Note that this is necessary to, for example, convert a String that represents 1000 to a Double value, since 1000 is represented differently by different cultures.) One or more attributes that can participate in activation.

[0646] CreateInstanceAndUnwrap

• [0647] [C#] public object CreateInstanceAndUnwrap(string assemblyName, string typeName);
• [0648] [C++] public: Object* CreateInstanceAndUnwrap(String* assemblyName, String* typeName);
• [0649] [VB] Public Function CreateInstanceAndUnwrap(ByVal assemblyName As String, ByVal typeName As String) As Object
• [0650] [JScript] public function CreateInstanceAndUnwrap(assemblyName: String, typeName: String): Object; Creates a new instance of a specified type.
  Description

[0651] Creates a new instance of the specified type. Parameters specify the assembly where the type is defined, and the name of the type.

Return Value: An instance of typeName, or null if typeName is not found.

[0652] This a convenience method that combines System.AppDomain.CreateInstance(System.String,System.String) and System.Runtime.Remoting.ObjectHandle.Unwrap. This method calls the default constructor for typeName. The name of the assembly. The fully qualified name of the type.

[0653] CreateInstanceAndUnwrap

• [0654] [C#] public object CreateInstanceAndUnwrap(string assemblyName, string typeName, object[ ] activationAttributes);
• [0655] [C++] public: Object* CreateInstanceAndUnwrap(String* assemblyName, String* typeName, Object* activationAttributes _gc[ ]);
• [0656] [VB] Public Function CreateInstanceAndUnwrap(ByVal assemblyName As String, ByVal typeName As String, ByVal activationAttributes( ) As Object) As Object
• [0657] [JScript] public function CreateInstanceAndUnwrap(assemblyName: String, typeName: String, activationAttributes: Object[ ]): Object;
  Description

[0658] Creates a new instance of the specified type. Parameters specify the assembly where the type is defined, the name of the type, and an array of activation attributes.

Return Value: An instance of typeName, or null if typeName is not found.

[0659] This a convenience method that combines System.AppDomain.CreateInstance(System.String,System.String) and System.Runtime.Remoting.ObjectHandle.Unwrap. This method calls the default constructor for typeName. The name of the assembly. The fully qualified name of the type. An array containing one or more attributes that can participate in activation.

[0660] CreateInstanceAndUnwrap

• [0661] [C#] public object CreateInstanceAndUnwrap(string assemblyName, string typeName, bool ignoreCase, BindingFlags bindingAttr, Binder binder, object[ ] args, CultureInfo culture, object[ ] activationAttributes, Evidence securityAttributes);
• [0662] [C++] public: Object* CreateInstanceAndUnwrap(String* assemblyName, String* typeName, bool ignoreCase, BindingFlags bindingAttr, Binder* binder, Object* args _gc[ ], CultureInfo* culture, Object* activationAttributes _gc[ ], Evidence* securityAttributes);
• [0663] [VB] Public Function CreateInstanceAndUnwrap(ByVal assemblyName As String, ByVal typeName As String, ByVal ignoreCase As Boolean, ByVal bindingAttr As BindingFlags, ByVal binder As Binder, ByVal args( ) As Object, ByVal culture As CultureInfo, ByVal activationAttributes( ) As Object, ByVal securityAttributes As Evidence) As Object
• [0664] [JScript] public function CreateInstanceAndUnwrap(assemblyName: String, typeName: String, ignoreCase: Boolean, bindingAttr: BindingFlags, binder: Binder, args: Object[ ], culture: CultureInfo, activationAttributes: Object[ ], securityAttributes: Evidence): Object;
  Description

[0665] Creates a new instance of the specified type. Parameters specify the name of the type and how it is found and created.

Return Value: An System.Object, which is an instance of typeName, or null if typeName is not found.

[0666] This a convenience method that combines System.AppDomain.CreateInstance(System.String,System.String) and System.Runtime.Remoting.ObjectHandle.Unwrap. The name of the assembly. The fully qualified name of the type. A Boolean value specifying whether to perform a case-sensitive search or not. This bitmask affects the way in which the search is conducted. The value is a combination of zero or more bit flags from System.Reflection.BindingFlags, such as NonPublicand OABinding. An object that enables the binding, coercion of argument types, invocation of members and retrieval of System.Reflection.MemberInfo objects using reflection. If binder is null, the default binder is used. The arguments to be passed to the constructor. This array of arguments must match in number, order, and type the parameters of the constructor to be invoked. If the default constructor is desired, args must be an empty array or null. A culture-specific object used to govern the coercion of types. If culture is null, the CultureInfo for the current thread is used. (Note that this is necessary to, for example, convert a String that represents 1000 to a Double value, since 1000 is represented differently by different cultures.) An System.Object array containing one or more attributes that can participate in activation. An System.Security.Policy.Evidence object used to verify that typeName is allowed to be created.

[0667] CreateInstanceFrom

• [0668] [C#] public ObjectHandle CreateInstanceFrom(string assemblyFile, string typeName);
• [0669] [C++] public: _sealed ObjectHandle* CreateInstanceFrom(String* assemblyFile, String* typeName);
• [0670] [VB] NotOverridable Public Function CreateInstanceFrom(ByVal assemblyFile As String, ByVal typeName As String) As ObjectHandle
• [0671] [JScript] public function CreateInstanceFrom(assemblyFile: String, typeName: String): ObjectHandle; Creates a new instance of a specified type defined in the specified assembly file.
  Description

[0672] Creates a new instance of the specified type defined in the specified assembly file.

Return Value: An object that is a wrapper for the new instance, or null if typeName is not found. The return value needs to be unwrapped to access the real object.

[0673] This is a convenience method that calls the default constructor for typeName. The assembly file name. The full name of the type.

[0674] CreateInstanceFrom

• [0675] [C#] public ObjectHandle CreateInstanceFrom(string assemblyFile, string typeName, object[ ] activationAttributes);
• [0676] [C++] public: _sealed ObjectHandle* CreateInstanceFrom(String* assemblyFile, String* typeName, Object* activationAttributes _gc[ ]);
• [0677] [VB] NotOverridable Public Function CreateInstanceFrom(ByVal assemblyFile As String, ByVal typeName As String, ByVal activationAttributes( ) As Object) As ObjectHandle
• [0678] [JScript] public function CreateInstanceFrom(assemblyFile: String, typeName: String, activationAttributes: Object[ ]): ObjectHandle;
  Description

[0679] Creates a new instance of the specified type defined in the specified assembly file.

Return Value: A handle to the requested object.

[0680] This method allows types to be created remotely without having to load the type locally. This will return an System.Runtime.Remoting.ObjectHandle that needs to be unwrapped in order to access the real object. The file containing the desired object's assembly. The type name of the desired object. One or more attributes that can participate in activation.

[0681] CreateInstanceFrom

• [0682] [C#] public ObjectHandle CreateInstanceFrom(string assemblyFile, string typeName, bool ignoreCase, BindingFlags bindingAttr, Binder binder, object[ ] args, CultureInfo culture, object[ ] activationAttributes, Evidence securityAttributes);
• [0683] [C++] public: _sealed ObjectHandle* CreateInstanceFrom(String* assemblyFile, String* typeName, bool ignoreCase, BindingFlags bindingAttr, Binder* binder, Object* args _gc[ ], CultureInfo* culture, Object* activationAttributes _gc[ ], Evidence* securityAttributes);
• [0684] [VB] NotOverridable Public Function CreateInstanceFrom(ByVal assemblyFile As String, ByVal typeName As String, ByVal ignoreCase As Boolean, ByVal bindingAttr As BindingFlags, ByVal binder As Binder, ByVal args( ) As Object, ByVal culture As CultureInfo, ByVal activationAttributes( ) As Object, ByVal securityAttributes As Evidence) As ObjectHandle
• [0685] [JScript] public function CreateInstanceFrom(assemblyFile: String, typeName: String, ignoreCase: Boolean, bindingAttr: BindingFlags, binder: Binder, args: Object[ ], culture: CultureInfo, activationAttributes: Object[ ], securityAttributes Evidence): ObjectHandle;
  Description

[0686] Creates a new instance of the specified type defined in the specified assembly file.

Return Value: A handle to the requested object.

[0687] This method allows types to be created remotely without having to load the type locally. This will return an System.Runtime.Remoting.ObjectHandle that needs to be unwrapped in order to access the real object. The file for the assembly in which this object type resides. The type name of the desired object. A Boolean value specifying whether to perform a case-sensitive search or not. This bitmask affects the way in which the search is conducted. The value is a combination of zero or more bit flags from System.Reflection.BindingFlags, such as NonPublicand OABinding. An object that enables the binding, coercion of argument types, invocation of members and retrieval of System.Reflection.MemberInfo objects through reflection. If binder is null, the default binder is used. The arguments to be passed to the constructor. This array of arguments must match in number, order, and type the parameters of the constructor to be invoked. If the default constructor is desired, args must be an empty array or null. An instance of System.Globalization.CultureInfo used to govern the coercion of types. If this is null, the CultureInfo for the current thread is used. (Note that this is necessary to, for example, convert a String that represents 1000 to a Double value, since 1000 is represented differently by different cultures.) One or more attributes that can participate in activation.

[0688] CreateInstanceFromAndUnwrap

• [0689] [C#] public object CreateInstanceFromAndUnwrap(string assemblyName, string typeName);
• [0690] [C++] public: Object* CreateInstanceFromAndUnwrap(String* assemblyName, String* typeName);
• [0691] [VB] Public Function CreateInstanceFromAndUnwrap(ByVal assemblyName As String, ByVal typeName As String) As Object
• [0692] [JScript] public function CreateInstanceFromAndUnwrap(assemblyName: String, typeName: String): Object; Creates a new instance of a specified type defined in the specified assembly file.
  Description

[0693] Creates a new instance of the specified type defined in the specified assembly file.

Return Value: Returns an System.Runtime.Remoting.ObjectHandle object that is a wrapper for the new instance. Returns null if the type is not found.

[0694] This a convenience method that combines System.AppDomain.CreateInstance(System.String,System.String) and System.Runtime.Remoting.ObjectHandle.Unwrap. This method calls the default constructor for typeName. The assembly file name. The full name of the type.

[0695] CreateInstanceFromAndUnwrap

• [0696] [C#] public object CreateInstanceFromAndUnwrap(string assemblyName, string typeName, object[ ] activationAttributes);
• [0697] [C++] public: Object* CreateInstanceFromAndUnwrap(String* assemblyName, String* typeName, Object* activationAttributes _gc[ ]);
• [0698] [VB] Public Function CreateInstanceFromAndUnwrap(ByVal assemblyName As String, ByVal typeName As String, ByVal activationAttributes( ) As Object) As Object
• [0699] [JScript] public function CreateInstanceFromAndUnwrap(assemblyName: String, typeName: String, activationAttributes: Object[ ]): Object;
  Description

[0700] Creates an instance using the name of the type and the assembly where it exists. This allows types to be created remotely without having to load the type locally. This will return an ObjectHandle that needs to be unwrapped in order to access the real object.

Return Value: A handle to the desired object.

[0701] This a convenience method that combines System.AppDomain.CreateInstance(System.String,System.String) and System.Runtime.Remoting.ObjectHandle.Unwrap. This method calls the Is default constructor for typeName. The file containing the desired object's assembly. The type name of the desired object. One or more attributes that can participate in activation.

CreateInstanceFromAndUnwrap

• [0702] [C#] public object CreateInstanceFromAndUnwrap(string assemblyName, string typeName, bool ignoreCase, BindingFlags bindingAttr, Binder binder, object[ ] args, CultureInfo culture, object[ ] activationAttributes, Evidence securityAttributes);
• [0703] [C++] public: Object* CreateInstanceFromAndUnwrap(String* assemblyName, String* typeName, bool ignoreCase, BindingFlags bindingAttr, Binder* binder, Object* args _gc[ ], CultureInfo* culture, Object* activationAttributes _gc[ ], Evidence* securityAttributes);
• [0704] [VB] Public Function CreateInstanceFromAndUnwrap(ByVal assemblyName As String, ByVal typeName As String, ByVal ignoreCase As Boolean, ByVal bindingAttr As BindingFlags, ByVal binder As Binder, ByVal args( ) As Object, ByVal culture As CultureInfo, ByVal activationAttributes( ) As Object, ByVal securityAttributes As Evidence) As Object
• [0705] [JScript] public function CreateInstanceFromAndUnwrap(assemblyName: String, typeName: String, ignoreCase: Boolean, bindingAttr: BindingFlags, binder: Binder, args: Object[ ], culture: CultureInfo, activationAttributes: Object[ ], securityAttributes: Evidence): Object;
  Description

[0706] Creates an instance using the name of the type and the assembly where it exists. This allows types to be created remotely without having to load the type locally. This will return an ObjectHandle that needs to be unwrapped in order to access the real object.

Return Value: A handle to the requested object.

[0707] This a convenience method that combines System.AppDomain.CreateInstance(System.String,System.String) and System.Runtime.Remoting.ObjectHandle.Unwrap. The file for the assembly in which this object type resides. The type name of the desired object. A Boolean value specifying whether to perform a case-sensitive search or not. This bitmask affects the way in which the search is conducted. The value is a combination of zero or more bit flags from System.Reflection.BindingFlags, such as NonPublicand OABinding. An object that enables the binding, coercion of argument types, invocation of members and retrieval of System.Reflection.MemberInfo objects through reflection. If binder is null, the default binder is used. The arguments to be passed to the constructor. This array of arguments must match in number, order, and type the parameters of the constructor to be invoked. If the default constructor is desired, args must be an empty array or null. An instance of System.Globalization.CultureInfo used to govern the coercion of types. If culture is null, the CultureInfo for the current thread is used. (Note that this is necessary to, for example, convert a String that represents 1000 to a Double value, since 1000 is represented differently by different cultures.) One or more attributes that can participate in activation.

[0708] DefineDynamicAssembly

• [0709] [C#] public AssemblyBuilder DefineDynamicAssembly(AssemblyName name, AssemblyBuilderAccess access);
• [0710] [C++] public: _sealed AssemblyBuilder* DefineDynamicAssembly(AssemblyName* name, AssemblyBuilderAccess access);
• [0711] [VB] NotOverridable Public Function DefineDynamicAssembly(ByVal name As AssemblyName, ByVal access As AssemblyBuilderAccess) As AssemblyBuilder
• [0712] [JScript] public function DefineDynamicAssembly(name: AssemblyName, access AssemblyBuilderAccess): AssemblyBuilder; Defines a dynamic assembly in the current application domain.
  Description

[0713] Defines a dynamic assembly with the given name and the given access.

Return Value: Represents the dynamic assembly created.

[0714] You can specify partial signing of the assembly by specifying AssemblyName.Originator. You can specify full signing of the assembly by specifying AssemblyName.Originator and AssemblyName.KeyPair. The “strong name”, or unique identity of the dynamic assembly. The access mode for the dynamic assembly.

[0715] DefineDynamicAssembly

• [0716] [C#] public AssemblyBuilder DefineDynamicAssembly(AssemblyName name, AssemblyBuilderAccess access, Evidence evidence);
• [0717] [C++] public: _sealed AssemblyBuilder* DefineDynamicAssembly(AssemblyName* name, AssemblyBuilderAccess access, Evidence* evidence);
• [0718] [VB] NotOverridable Public Function DefineDynamicAssembly(ByVal name As AssemblyName, ByVal access As AssemblyBuilderAccess, ByVal evidence As Evidence) As AssemblyBuilder
• [0719] [JScript] public function DefineDynamicAssembly(name: AssemblyName, access: AssemblyBuilderAccess, evidence: Evidence): AssemblyBuilder;
  Description

[0720] Defines a dynamic assembly with the given name, the given access, and the supplied evidence.

Return Value: Represents the dynamic assembly created.

[0721] Only fully trusted callers can supply evidence when defining a dynamic assembly. The runtime will map the supplied evidence through policy to determine the granted permissions. Semi-trusted callers must supply a null evidence. If evidence is null, the runtime copies the permission sets, that is, the current grant and deny sets, from the caller's assembly to the dynamic assembly being defined and marks policy as resolved. If the dynamic assembly is saved to disk, subsequent loads will get grants based on policies associated with the location where the assembly was saved. The unique identity of the dynamic assembly. The mode in which the dynamic assembly will be accessed. The evidence supplied for the dynamic assembly.

[0722] DefineDynamicAssembly

• [0723] [C#] public AssemblyBuilder DefineDynamicAssembly(AssemblyName name, AssemblyBuilderAccess access, string dir);
• [0724] [C++] public: _sealed AssemblyBuilder* DefineDynamicAssembly(AssemblyName* name, AssemblyBuilderAccess access, String* dir);
• [0725] [VB] NotOverridable Public Function DefineDynamicAssembly(ByVal name As AssemblyName, ByVal access As AssemblyBuilderAccess, ByVal dir As String) As AssemblyBuilder
• [0726] [JScript] public function DefineDynamicAssembly(name: AssemblyName, access AssemblyBuilderAccess, dir: String): AssemblyBuilder;
  Description

[0727] Defines a dynamic assembly with the given name, the given access, and the name of the directory for saving the assembly.

Return Value: Represents the dynamic assembly created.

[0728] You can specify partial signing of the assembly by specifying AssemblyName.Originator. You can specify full signing of the assembly by specifying AssemblyName.Originator and AssemblyName.KeyPair. The unique identity of the dynamic assembly. The mode in which the dynamic assembly will be accessed. The name of the directory in which the assembly will be saved. If dir is null, the directory defaults to the current directory.

[0729] DefineDynamicAssembly

• [0730] [C#] public AssemblyBuilder DefineDynamicAssembly(AssemblyName name, AssemblyBuilderAccess access, string dir, Evidence evidence); [C++] public: _sealed AssemblyBuilder* DefineDynamicAssembly(AssemblyName* name, AssemblyBuilderAccess access, String* dir, Evidence* evidence);
• [0731] [VB] NotOverridable Public Function DefineDynamicAssembly(ByVal name As AssemblyName, ByVal access As AssemblyBuilderAccess, ByVal dir As String, ByVal evidence As Evidence) As AssemblyBuilder
• [0732] [JScript] public function DefineDynamicAssembly(name: AssemblyName, access: AssemblyBuilderAccess, dir: String, evidence: Evidence): AssemblyBuilder;
  Description

[0733] Defines a dynamic assembly with the given name, given access, the name of the directory for saving the assembly, and the supplied evidence.

Return Value: Represents the dynamic assembly created.

[0734] Only fully trusted callers can supply their evidence when defining a dynamic assembly. The runtime will map the evidence through policy to determine the granted permissions. Semi-trusted callers must supply a null evidence. If evidence is null, the runtime copies the permission sets, that is, the current grant and deny sets, from the caller's assembly to the dynamic assembly being defined and marks policy as resolved. If the dynamic assembly is saved to disk, subsequent loads will get grants based on policies associated with the location where the assembly was saved. The unique identity of the dynamic assembly. The mode in which the dynamic assembly will be accessed. The name of the directory in which the assembly will be saved. If dir is null, the directory defaults to the current directory. The evidence supplied for the dynamic assembly.

[0735] DefineDynamicAssembly

• [0736] [C#] public AssemblyBuilder DefineDynamicAssembly(AssemblyName name, AssemblyBuilderAccess access, PermissionSet requiredPermissions, PermissionSet optionalPermissions, PermissionSet refusedPermissions);
• [0737] [C++] public: _sealed AssemblyBuilder* DefineDynamicAssembly(AssemblyName* name, AssemblyBuilderAccess access, PermissionSet* requiredPermissions, PermissionSet* optionalPermissions, PermissionSet* refusedPermissions);
• [0738] [VB] NotOverridable Public Function DefineDynamicAssembly(ByVal name As AssemblyName, ByVal access As AssemblyBuilderAccess, ByVal requiredPermissions As PermissionSet, ByVal optionalPermissions As PermissionSet, ByVal refusedPermissions As PermissionSet) As AssemblyBuilder
• [0739] [JScript] public function DefineDynamicAssembly(name: AssemblyName, access: AssemblyBuilderAccess, requiredPermissions: PermissionSet, optionalPermissions: PermissionSet, refusedPermissions: PermissionSet): AssemblyBuilder;
  Description

[0740] Defines a dynamic assembly with the given name, the given access, and the given permission requests.

Return Value: Represents the dynamic assembly created.

[0741] You can specify partial signing of the assembly by specifying AssemblyName.Originator. You can specify full signing of the assembly by specifying AssemblyName.Originator and AssemblyName.KeyPair. The unique identity of the dynamic assembly. The mode in which the dynamic assembly will be accessed. The required permission request. The optional permission request. The refused permission request.

[0742] DefineDynamicAssembly

• [0743] [C#] public AssemblyBuilder DefineDynamicAssembly(AssemblyName name, AssemblyBuilderAccess access, Evidence evidence, PermissionSet requiredPermissions, PermissionSet optionalPermissions, PermissionSet refusedPermissions);
• [0744] [C++] public: _sealed AssemblyBuilder* DefineDynamicAssembly(AssemblyName* name, AssemblyBuilderAccess access, Evidence* evidence, PermissionSet* requiredPermissions, PermissionSet* optionalPermissions, PermissionSet* refusedPermissions);
• [0745] [VB] NotOverridable Public Function DefineDynamicAssembly(ByVal name As AssemblyName, ByVal access As AssemblyBuilderAccess, ByVal evidence As Evidence, ByVal requiredPermissions As PermissionSet, ByVal optionalPermissions As PermissionSet, ByVal refusedPermissions As PermissionSet) As AssemblyBuilder
• [0746] [JScript] public function DefineDynamicAssembly(name: AssemblyName, access: AssemblyBuilderAccess, evidence: Evidence, requiredPermissions: PermissionSet, optionalPermissions: PermissionSet, refusedPermissions PermissionSet): AssemblyBuilder;
  Description

[0747] Defines a dynamic assembly with the given name, given access, supplied evidence, and the permission requests.

Return Value: Represents the dynamic assembly created.

[0748] Only fully trusted callers can supply their evidence when defining a dynamic assembly. The runtime will map the evidence through policy to determine the granted permissions. Semi-trusted callers must supply a null evidence. If evidence is null, the runtime copies the permission sets (that is, the current grant and deny sets) from the caller's assembly to the dynamic assembly being defined and marks policy as resolved. The unique identity of the dynamic assembly. The mode in which the dynamic assembly will be accessed. The evidence supplied for the dynamic assembly. The required permission request. The optional permission request. The refused permission request.

[0749] DefineDynamicAssembly

• [0750] [C#] public AssemblyBuilder DefineDynamicAssembly(AssemblyName name, AssemblyBuilderAccess access, string dir, PermissionSet requiredPermissions, PermissionSet optionalPermissions, PermissionSet refusedPermissions);
• [0751] [C++] public: _sealed AssemblyBuilder* DefineDynamicAssembly(AssemblyName* name, AssemblyBuilderAccess access, String* dir, PermissionSet* requiredPermissions, PermissionSet* optionalPermissions, PermissionSet* refusedPermissions);
• [0752] [VB] NotOverridable Public Function DefineDynamicAssembly(ByVal name As AssemblyName, ByVal access As AssemblyBuilderAccess, ByVal dir As String, ByVal requiredPermissions As PermissionSet, ByVal optionalPermissions As PermissionSet, ByVal refusedPermissions As PermissionSet) As AssemblyBuilder
• [0753] [JScript] public function DefineDynamicAssembly(name: AssemblyName, access: AssemblyBuilderAccess, dir: String, requiredPermissions: PermissionSet, optionalPermissions: PermissionSet, refusedPermissions: PermissionSet) AssemblyBuilder;
  Description

[0754] Defines a dynamic assembly with the given name, given access, the name of the directory for saving the assembly, and the permission requests.

Return Value: Represents the dynamic assembly created.

[0755] You can specify partial signing of the assembly by specifying AssemblyName.Originator. You can specify full signing of the assembly by specifying AssemblyName.Originator and AssemblyName.KeyPair. The unique identity of the dynamic assembly. The mode in which the dynamic assembly will be accessed. The name of the directory in which the assembly will be saved. If dir is null, the directory defaults to the current directory. The required permission request. The optional permission request. The refused permission request.

[0756] DefineDynamicAssembly

• [0757] [C#] public AssemblyBuilder DefineDynamicAssembly(AssemblyName name, AssemblyBuilderAccess access, string dir, Evidence evidence, PermissionSet requiredPermissions, PermissionSet optionalPermissions, PermissionSet refusedPermissions);
• [0758] [C++] public: _sealed AssemblyBuilder* DefineDynamicAssembly(AssemblyName* name, AssemblyBuilderAccess access, String* dir, Evidence* evidence, PermissionSet* requiredPermissions, PermissionSet* optionalPermissions, PermissionSet* refusedPermissions);
• [0759] [VB] NotOverridable Public Function DefineDynamicAssembly(ByVal name As AssemblyName, ByVal access As AssemblyBuilderAccess, ByVal dir As String, ByVal evidence As Evidence, ByVal requiredPermissions As PermissionSet, ByVal optionalPermissions As PermissionSet, ByVal refusedPermissions As PermissionSet) As AssemblyBuilder
• [0760] [JScript] public function DefineDynamicAssembly(name: AssemblyName, access: AssemblyBuilderAccess, dir: String, evidence: Evidence, requiredPermissions: PermissionSet, optionalPermissions: PermissionSet, refusedPermissions: PermissionSet): AssemblyBuilder;
  Description

[0761] Defines a dynamic assembly with the given name, given access, the name of the directory for saving the assembly, supplied evidence, and the permission requests.

Return Value: Represents the dynamic assembly created.

[0762] Only fully trusted callers can supply their evidence when defining a dynamic assembly. The runtime will map the evidence through policy to determine the granted permissions. Semi-trusted callers must supply a null evidence. If evidence is null, the runtime copies the permission sets, that is, the current grant and deny sets, from the caller's assembly to the dynamic assembly being defined and marks policy as resolved. The unique identity of the dynamic assembly. The mode in which the dynamic assembly will be accessed. The name of the directory in which the assembly will be saved. If dir is null, the directory defaults to the current directory. The evidence supplied for the dynamic assembly. The required permission request. The optional permission request. The refused permission request.

[0763] DefineDynamicAssembly

• [0764] [C#] public AssemblyBuilder DefineDynamicAssembly(AssemblyName name, AssemblyBuilderAccess access, string dir, Evidence evidence, PermissionSet requiredPermissions, PermissionSet optionalPermissions, PermissionSet refusedPermissions, bool is Synchronized);
• [0765] [C++] public: _sealed AssemblyBuilder* DefineDynamicAssembly(AssemblyName* name, AssemblyBuilderAccess access, String* dir, Evidence* evidence, PermissionSet* requiredPermissions, PermissionSet* optionalPermissions, PermissionSet* refusedPermissions, bool is Synchronized);
• [0766] [VB] NotOverridable Public Function DefineDynamicAssembly(ByVal name As AssemblyName, ByVal access As AssemblyBuilderAccess, ByVal dir As String, ByVal evidence As Evidence, ByVal requiredPermissions As PermissionSet, ByVal optionalPermissions As PermissionSet, ByVal refusedPermissions As PermissionSet, ByVal is Synchronized As Boolean) As AssemblyBuilder
• [0767] [JScript] public function DefineDynamicAssembly(name: AssemblyName, access: AssemblyBuilderAccess, dir: String, evidence: Evidence, requiredPermissions: PermissionSet, optionalPermissions: PermissionSet, refusedPermissions PermissionSet, is Synchronized: Boolean): AssemblyBuilder;
  Description

[0768] Defines a dynamic assembly using the specified name, access mode, storage directory, evidence, permission requests, and synchronization option.

Return Value: Represents the dynamic assembly created.

[0769] Only fully trusted callers can supply their evidence when defining a dynamic System.Reflection.Assembly. The runtime will map the System.Security.Policy.Evidence through policy to determine the granted permissions. Semi-trusted callers must supply an System.Security.Policy.Evidence. If evidence is null, the runtime copies the permission sets, that is, the current grant and deny sets, from the caller's System.Reflection.Assembly to the dynamic System.Reflection.Assembly being defined and marks policy as resolved. The unique identity of the dynamic assembly. The mode in which the dynamic assembly will be accessed. The name of the directory in which the dynamic assembly will be saved. If dir is null, the directory defaults to the current directory. The evidence supplied for the dynamic assembly. The required permission request. The optional permission request. The refused permission request. If true, the creation of modules, types, and members in the dynamic assembly are synchronized.

[0770] DoCallBack

• [0771] [C#] public void DoCallBack(CrossAppDomainDelegate callBackDelegate);
• [0772] [C++] public: _sealed void DoCallBack(CrossAppDomainDelegate* callBackDelegate);
• [0773] [VB] NotOverridable Public Sub DoCallBack(ByVal callBack[Delegate As CrossAppDomainDelegate)
• [0774] [JScript] public function DoCallBack(callBackDelegate: CrossAppDomainDelegate);
  Description

[0775] Executes the code in another application domain that is identified by the specified delegate.

• • [0776] callBackDelegate can specify a marshal-by-value, System.MarshalByRefObject, or System.ContextBoundObject object. A delegate that specifies a method to call.

[0777] ExecuteAssembly

• [0778] [C#] public int ExecuteAssembly(string assemblyFile);
• [0779] [C++] public: _sealed int ExecuteAssembly(String* assemblyFile);
• [0780] [VB] NotOverridable Public Function ExecuteAssembly(ByVal assemblyFile As String) As Integer
• [0781] [JScript] public function ExecuteAssembly(assemblyFile: String): int;
  Description

[0782] Execute the System.Reflection.Assembly given its file name. The method specified in the .NET Framework header is called.

Return Value: The value returned by the entry point of the assembly.

[0783] The method does not spawn a new process, create a new application domain, or execute the entry point method on a new thread. The name of the file from which the assembly is to be loaded.

[0784] ExecuteAssembly

• [0785] [C#] public int ExecuteAssembly(string assemblyFile, Evidence assemblySecurity);
• [0786] [C++] public: _sealed int ExecuteAssembly(String* assemblyFile, Evidence* assemblySecurity);
• [0787] [VB] NotOverridable Public Function ExecuteAssembly(ByVal assemblyFile As String, ByVal assemblySecurity As Evidence) As Integer
• [0788] [JScript] public function ExecuteAssembly(assemblyFile: String, assemblySecurity: Evidence): int; Executes the specified assembly.
  Description

[0789] Execute the System.Reflection.Assembly given its file name and supplied evidence.

Return Value: The value returned by the entry point of the assembly.

[0790] The method does not spawn a new process, create a new application domain, or execute the entry point method on a new thread. The name of the file from which the assembly is to be loaded. Evidence for loading the assembly.

[0791] ExecuteAssembly

• [0792] [C#] public int ExecuteAssembly(string assemblyFile, Evidence assemblySecurity, string[ ] args);
• [0793] [C++] public: _sealed int ExecuteAssembly(String* assemblyFile, Evidence* assemblySecurity, String* args _gc[ ]);
• [0794] [VB] NotOverridable Public Function ExecuteAssembly(ByVal assemblyFile As String, ByVal assemblySecurity As Evidence, ByVal args( ) As String) As Integer
• [0795] [JScript] public function ExecuteAssembly(assemblyFile: String, assemblySecurity: Evidence, args: String[ ]): int; Executes the assembly given its file name.
  Description

[0796] Execute the System.Reflection.Assembly given its file name and supplied System.Security.Policy.Evidence. Optionally, the System.Reflection.Assembly can be loaded into the domain-neutral code area for use by multiple AppDomains.

Return Value: The value returned by the entry point of the assembly.

[0797] The method does not spawn a new process, create a new application domain, or execute the entry point method on a new thread. The name of the file from which the assembly is to be loaded. The supplied evidence for the assembly. The arguments to the entry point of the assembly.

[0798] GetAssemblies

• [0799] [C#] public Assembly[ ] GetAssemblies( );
• [0800] [C++] public: _sealed Assembly* GetAssemblies( ) [ ];
• [0801] [VB] NotOverridable Public Function GetAssemblies( ) As Assembly( )
• [0802] [JScript] public function GetAssemblies( ): Assembly[ ];
  Description

[0803] Gets the assemblies that have been loaded into this application domain.

Return Value: An array of assemblies in this application domain.

[0804] GetCurrentThreadId

• [0805] [C#] public static int GetCurrentThreadId( );
• [0806] [C++] public: static int GetCurrentThreadId( );
• [0807] [VB] Public Shared Function GetCurrentThreadId( ) As Integer
• [0808] [JScript] public static function GetCurrentThreadId( ): int;
  Description

[0809] Gets the current thread identifier.

Return Value: A 32-bit signed integer that is the identifier of the current thread.

[0810] GetData

• [0811] [C#] public object GetData(string name);
• [0812] [C++] public: _sealed Object* GetData(String* name);
• [0813] [VB] NotOverridable Public Function GetData(ByVal name As String) As Object
• [0814] [JScript] public function GetData(name: String): Object;
  Description

[0815] Gets the value stored in the current application domain for the specified data name.

Return Value: The value of the name property.

[0816] name can be the value of one of the System.AppDomainSetup properties. The name of an application domain property.

[0817] GetType

• [0818] [C#] public Type GetType( );
• [0819] [C++] public: _sealed Type* GetType( );
• [0820] [VB] NotOverridable Public Function GetType( ) As Type
• [0821] [JScript] public function GetType( ): Type;
  Description

[0822] Gets the type of the current instance.

Return Value: A System.Type object.

Description

[0823] Gets the type of the current instance.

Return Value: A System.Type object.

[0824] InitializeLifetimeService

• [0825] [C#] public override object InitializeLifetimeService( );
• [0826] [C++] public: Object* InitializeLifetimeService( );
• [0827] [VB] Overrides Public Function InitializeLifetimeService( ) As Object
• [0828] [JScript] public override function InitializeLifetimeService( ): Object;
  Description

[0829] Gives the System.AppDomain an infinite lifetime by preventing a lease from being created.

Return Value: Always null.

[0830] IsFinalizingForUnload

• [0831] [C#] public bool IsFinalizingForUnload( );
• [0832] [C++] public: bool IsFinalizingForUnload( );
• [0833] [VB] Public Function IsFinalizingForUnload( ) As Boolean
• [0834] [JScript] public function IsFinalizingForUnload( ): Boolean;
  Description

[0835] Indicates whether the common language runtime has started forcing objects to finalize.

Return Value: true if the common language runtime has started invoking finalizers, forcing objects to finalize; otherwise, false.

[0836] Some of the System.AppDomain infrastructure might have been garbage collected before the finalizers started running.

[0837] Load

• [0838] [C#] public Assembly Load(AssemblyName assemblyRef);
• [0839] [C++] public: _sea led Assembly* Load(AssemblyName* assemblyRef);
• [0840] [VB] NotOverridable Public Function Load(ByVal assemblyRef As AssemblyName) As Assembly
• [0841] [JScript] public function Load(assemblyRef: AssemblyName): Assembly; Loads an System.Reflection.Assembly into this application domain.
  Description

[0842] Loads an System.Reflection.Assembly given its System.Reflection.AssemblyName.

Return Value: The loaded assembly.

[0843] This method should only be used to load an assembly into the current application domain. This method is defined for interoperability callers who cannot call the static Assembly.Load method. An object that describes the assembly to be loaded.

[0844] Load

• [0845] [C#] public Assembly Load(byte[ ] rawAssembly);
• [0846] [C++] public: _sealed Assembly* Load(unsigned char rawAssembly _gc[ ]);
• [0847] [VB] NotOverridable Public Function Load(ByVal rawAssembly( ) As Byte) As Assembly
• [0848] [JScript] public function Load(rawAssembly: Byte[ ]): Assembly;
  Description

[0849] Loads the System.Reflection.Assembly with a COFF based image containing an emitted System.Reflection.Assembly.

Return Value: The loaded assembly.

[0850] This method should only be used to load an assembly into the current application domain. This method is defined for interoperability callers who cannot call the static Assembly.Load method. An array of type byte that is a COFF-based image containing an emitted assembly.

[0851] Load

• [0852] [C#] public Assembly Load(string assemblyString);
• [0853] [C++] public: _sealed Assembly* Load(String* assemblyString);
• [0854] [VB] NotOverridable Public Function Load(ByVal assemblyString As String) As Assembly
• [0855] [JScript] public function Load(assemblyString: String): Assembly;
  Description

[0856] Loads an System.Reflection.Assembly given its display name.

Return Value: The loaded assembly.

[0857] This method should only be used to load an assembly into the current application domain. This method is defined for interoperability callers who cannot call the static Assembly.Load method. The display name of the assembly.

[0858] Load

• [0859] [C#] public Assembly Load(AssemblyName assemblyRef, Evidence assemblySecurity);
• [0860] [C++] public: _sealed Assembly* Load(AssemblyName* assemblyRef, Evidence* assemblySecurity);
• [0861] [VB] NotOverridable Public Function Load(ByVal assemblyRef As AssemblyName, ByVal assemblySecurity As Evidence) As Assembly
• [0862] [JScript] public function Load(assemblyRef: AssemblyName, assemblySecurity: Evidence): Assembly; Loads an System.Reflection.Assembly into this application domain.
  Description

[0863] Loads an System.Reflection.Assembly given its System.Reflection.AssemblyName.

Return Value: The loaded assembly. An object that describes the assembly to be loaded. Evidence for loading the assembly.

[0864] Load

• [0865] [C#] public Assembly Load(byte[ ] rawAssembly, byte[ ] rawSymbolStore);
• [0866] [C++] public: _sealed Assembly* Load(unsigned char rawAssembly _gc[ ], unsigned char rawSymbolStore _gc[ ]);
• [0867] [VB] NotOverridable Public Function Load(ByVal rawAssembly( ) As Byte, ByVal rawSymbolStore( ) As Byte) As Assembly
• [0868] [JScript] public function Load(rawAssembly: Byte[ ], rawSymbolStore: Byte[ ]): Assembly;
  Description

[0869] Loads the System.Reflection.Assembly with a COFF based image containing an emitted System.Reflection.Assembly. The raw bytes representing the symbols for the System.Reflection.Assembly are also loaded.

Return Value: The loaded assembly.

[0870] This method should only be used to load an assembly into the current application domain. This method is defined for interoperability callers who cannot call the static Assembly.Load method. An array of type byte that is a COFF-based image containing an emitted assembly. An array of type byte containing the raw bytes representing the symbols for the assembly. Load

• [0871] [C#] public Assembly Load(string assemblyString, Evidence assemblySecurity);
• [0872] [C++] public: _sealed Assembly* Load(String* assemblyString, Evidence* assemblySecurity);
• [0873] [VB] NotOverridable Public Function Load(ByVal assemblyString As String, ByVal assemblySecurity As Evidence) As Assembly
• [0874] [JScript] public function Load(assemblyString: String, assemblySecurity: Evidence): Assembly;
  Description

[0875] Loads an System.Reflection.Assembly given its display name.

Return Value: The loaded assembly. The display name of the assembly. Evidence for loading the assembly.

[0876] Load

• [0877] [C#] public Assembly Load(byte[ ] rawAssembly, byte[ ] rawSymbolStore, Evidence securityEvidence);
• [0878] [C++] public: _sealed Assembly* Load(unsigned char rawAssembly _gc[ ], unsigned char rawSymbolStore _gc[ ], Evidence* securityEvidence);
• [0879] [VB] NotOverridable Public Function Load(ByVal rawAssembly( ) As Byte, ByVal rawSymbolStore( ) As Byte, ByVal securityEvidence As Evidence) As Assembly
• [0880] [JScript] public function Load(rawAssembly: Byte[ ], rawSymbolStore: Byte[ ], securityEvidence: Evidence): Assembly;
  Description

[0881] Loads the System.Reflection.Assembly with a COFF based image containing an emitted System.Reflection.Assembly. The raw bytes representing the symbols for the System.Reflection.Assembly are also loaded.

Return Value: The loaded assembly.

[0882] This method should only be used to load an assembly into the current application domain. This method is defined for interoperability callers who cannot call the static Assembly.Load method. An array of type byte that is a COFF-based image containing an emitted assembly. An array of type byte containing the raw bytes representing the symbols for the assembly. Evidence for loading the assembly.

[0883] SetAppDomainPolicy

• [0884] [C#] public void SetAppDomainPolicy(PolicyLevel domainPolicy);
• [0885] [C++] public: _sealed void SetAppDomainPolicy(PolicyLevel* domainPolicy);
• [0886] [VB] NotOverridable Public Sub SetAppDomainPolicy(ByVal domain Policy As PolicyLevel)
• [0887] [JScript] public function SetAppDomainPolicy(domainPolicy: PolicyLevel);
  Description

[0888] Establishes the security policy level for this application domain. The security policy level.

[0889] SetCachePath

• [0890] [C#] public void SetCachePath(string path);
• [0891] [C++] public: _sealed void SetCachePath(String* path);
• [0892] [VB] NotOverridable Public Sub SetCachePath(ByVal path As String)
• [0893] [JScript] public function SetCachePath(path: String);
  Description

[0894] Establishes the specified directory path as the location where assemblies are shadow copied. The fully qualified path to the shadow copy location.

[0895] SetData

• [0896] [C#] public void SetData(string name, object data);
• [0897] [C++] public: _—_sealed void SetData(String* name, Object* data);
• [0898] [VB] NotOverridable Public Sub SetData(ByVal name As String, ByVal data As Object)
• [0899] [JScript] public function SetData(name: String, data: Object);
  Description

[0900] Assigns the specified value to the specified application domain property.

[0901] This method has been superseded by properties of the System.AppDomainSetup class. The following table shows the System.AppDomainSetup property that corresponds to a value of name. The name of an application domain property. The value to set the name property.

[0902] SetDynamicBase

• [0903] [C#] public void SetDynamicBase(string path);
• [0904] [C++] public: void SetDynamicBase(String* path);
• [0905] [VB] Public Sub SetDynamicBase(ByVal path As String)
• [0906] [JScript] public function SetDynamicBase(path: String);
  Description

[0907] Establishes the specified directory path as the location where dynamically generated files are stored and accessed.

[0908] This method sets the System.AppDomainSetup.DynamicBase property of the internal System.AppDomnainSetup object associated with this instance. The fully qualified path to where dynamic assemblies are stored.

[0909] SetPrincipalPolicy

• [0910] [C#] public void SetPrincipalPolicy(PrincipalPolicy policy);
• [0911] [C++] public: _—_sealed void SetPrincipalPolicy(PrincipalPolicy policy);
• [0912] [VB] NotOverridable Public Sub SetPrincipalPolicy(ByVal policy As PrincipalPolicy)
• [0913] [JScript] public function SetPrincipalPolicy(policy: PrincipalPolicy);
  Description

[0914] Set the class of the default principal object to be attached to threads if they attempt to bind to a principal while executing in this application domain. The class of the principal object to be attached to threads.

[0915] SetShadowCopyFiles

• [0916] [C#] public void SetShadowCopyFiles( );
• [0917] [C++] public: void SetShadowCopyFiles( );
• [0918] [VB] Public Sub SetShadowCopyFiles( )
• [0919] [JScript] public function SetShadowCopyFiles( );
  Description

[0920] Turns on shadow copying.

[0921] SetShadowCopyPath

• [0922] [C#] public void SetShadowCopyPath(string path);
• [0923] [C++] public: _sealed void SethadowCopyPath(String* path);
• [0924] [VB] NotOverridable Public Sub SetShadowCopyPath(ByVal path As String)
• [0925] [JScript] public function SetShadowCopyPath(path: String);
  Description

[0926] Establishes the specified directory path as the location of assemblies to be “shadow copied”.

[0927] This method sets the System.AppDomainSetup.ShadowCopyDirectories property of the internal System.AppDomainSetup object associated with this instance. A list of directory names, where each name is separated by a semicolon.

[0928] SetThreadPrincipal

• [0929] [C#] public void SetThreadPrincipal(IPrincipal principal);
• [0930] [C++] public: _sealed void SetThreadPrincipal(IPrincipal* principal);
• [0931] [VB] NotOverridable Public Sub SetThreadPrincipal(ByVal principal As IPrincipal)
• [0932] [JScript] public function SetThreadPrincipal(principal: IPrincipal);
  Description

[0933] Set the default principal object to be attached to threads if they attempt to bind to a principal while executing in this application domain. The principal object to be attached to threads.

[0934] ToString

• [0935] [C#] public override string ToString( );
• [0936] [C++] public: String* ToString( );
• [0937] [VB] Overrides Public Function ToString( ) As String
• [0938] [JScript] public override function ToString( ): String;
  Description

[0939] Obtains the System.String representation of the application domain.

Return Value: The friendly name, loader name, and loader context policy of the application domain.

[0940] The string representation specifies the friendly name of the application domain.

[0941] Unload

• [0942] [C#] public static void Unload(AppDomain domain);
• [0943] [C++] public: static void Unload(AppDomain* domain);
• [0944] [VB] Public Shared Sub Unload(ByVal domain As AppDomain)
• [0945] [JScript] public static function Unload(domain: AppDomain);
  Description

[0946] Removes the specified application domain.

[0947] A long period of time can pass before domain unloads because it might be difficult to terminate executing threads. An application domain to be unloaded.

[0948] AppDomainSetup class (System)

[0949] Unload

[0950] Constructors:

[0951] AppDomainSetup

[0952] Example Syntax:

[0953] Unload

[0954] ApplicationBase

[0955] Unload

[0956] ApplicationName

[0957] Unload

[0958] CachePath

[0959] Unload

[0960] ConfigurationFile

[0961] Unload

[0962] DynamicBase

[0963] Unload

[0964] LicenseFile

[0965] Unload

[0966] LoaderOptimization

[0967] Unload

[0968] PrivateBinPath

[0969] Unload

[0970] PrivateBin PathProbe

[0971] Unload

[0972] ShadowCopyDirectories

[0973] Unload

[0974] ShadowCopyFiles

[0975] Unload

[0976] AppDomainUnloadedException class (System)

[0977] ToString

Description

[0978] The exception that is thrown when an attempt is made to access an unloaded application domain.

[0979] System.AppDomainUnloadedException uses the HRESULT COR_E_APPDOMAINUNLOADED, which has the value 0x80131014.

[0980] AppDomainUnloadedException

[0981] Example Syntax:

[0982] ToString

• [0983] [C#] public AppDomainUnloadedException( );
• [0984] [C++] public: AppDomainUnloadedException( );
• [0985] [VB] Public Sub New( )
• [0986] [JScript] public function AppDomainUnloadedException( ); Initializes a new instance of the System.AppDomainUnloadedException class.
  Description

[0987] Initializes a new instance of the System.AppDomainUnloadedException class with default properties.

[0988] The following table shows the initial property values for an instance of System.AppDomainUnloadedException.

[0989] AppDomainUnloadedException

[0990] Example Syntax:

[0991] ToString

• [0992] [C#] public AppDomainUnloadedException(string message);
• [0993] [C++] public: AppDomainUnloadedException(String* message);
• [0994] [VB] Public Sub New(ByVal message As String)
• [0995] [JScript] public function AppDomainUnloadedException(message: String);
  Description

[0996] Initializes a new instance of the System.AppDomainUnloadedException class with a specified error message.

[0997] The following table shows the initial property values for an instance of System.AppDomainUnloadedException. The error message that explains the reason for the exception.

[0998] AppDomainUnloadedException

[0999] Example Syntax:

[1000] ToString

• [1001] [C#] protected AppDomainUnloadedException(SerializationInfo info, StreamingContext context);
• [1002] [C++] protected: AppDomainUnloadedException(SerializationInfo* info, StreamingContext context);
• [1003] [VB] Protected Sub New(ByVal info As SerializationInfo, ByVal context As StreamingContext)
• [1004] [JScript] protected function AppDomainUnloadedException(info: SerializationInfo, context: StreamingContext);
  Description

[1005] Initializes a new instance of the System.AppDomainUnloadedException class with serialized data.

[1006] This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. For more information, see. The object that holds the serialized object data. The contextual information about the source or destination.

[1007] AppDomainUnloadedException

[1008] Example Syntax:

[1009] ToString

• [1010] [C#] public AppDomainUnloadedException(string message, Exception innerException);
• [1011] [C++] public: AppDomainUnloadedException(String* message, Exception* innerException);
• [1012] [VB] Public Sub New(ByVal message As String, ByVal innerException As Exception)
• [1013] [JScript] public function AppDomainUnloadedException(message: String, innerException: Exception);
  Description

[1014] Initializes a new instance of the System.AppDomainUnloadedException class with a specified error message and a reference to the inner exception that is the root cause of this exception.

[1015] When an ExceptionX is thrown as a direct result of a previous exception Y, the System.Exception.InnerException property of X should contain a reference to Y. The InnerException property returns the same value as was passed into the constructor, or null if the inner exception value was not supplied to the constructor. The error message that explains the reason for the exception. An instance of System.Exception that is the cause of the current Exception. If innerException is non-null, then the current Exception is raised in a catch block handling innerException.

[1016] HelpLink

[1017] HResult

[1018] InnerException

[1019] Message

[1020] Source

[1021] StackTrace

[1022] TargetSite

[1023] ApplicationException class (System)

[1024] ToString

Description

[1025] The exception that is thrown when a non-fatal application error occurs.

[1026] System.ApplicationException is thrown by a user program, not by the common language runtime. If you are designing an application that needs to create its own exceptions, derive from the System.ApplicationException class.

[1027] ApplicationException

[1028] Example Syntax:

[1029] ToString

• [1030] [C#] public ApplicationException( );
• [1031] [C++] public: ApplicationException( );
• [1032] [VB] Public Sub New( )
• [1033] [JScript] public function ApplicationException( ); Initializes a new instance of the System.ApplicationException class.
  Description

[1034] Initializes a new instance of the System.ApplicationException class with default properties.

[1035] The following table shows the initial property values for an instance of System.ApplicationException.

[1036] ApplicationException

[1037] Example Syntax:

[1038] ToString

• [1039] [C#] public ApplicationException(string message);
• [1040] [C++] public: ApplicationException(String* message);
• [1041] [VB] Public Sub New(ByVal message As String)
• [1042] [JScript] public function ApplicationException(message: String);
  Description

[1043] Initializes a new instance of the System.ApplicationException class with a specified error message.

[1044] The following table shows the initial property values for an instance of System.ApplicationException. The error message that explains the reason for the exception.

• [1045] ApplicationException

[1046] Example Syntax:

[1047] ToString

• [1048] [C#] protected ApplicationException(SerializationInfo info, StreamingContext context);
• [1049] [C++] protected: ApplicationException(SerializationInfo* info, StreamingContext context);
• [1050] [VB] Protected Sub New(ByVal info As SerializationInfo, ByVal context As StreamingContext)
• [1051] [JScript] protected function ApplicationException(info: SerializationInfo, context StreamingContext);
  Description

[1052] Initializes a new instance of the System.ApplicationException class with serialized data.

[1053] This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. For more information, see. The object that holds the serialized object data. The contextual information about the source or destination.

[1054] ApplicationException

[1055] Example Syntax:

[1056] ToString

• [1057] [C#] public ApplicationException(string message, Exception innerException);
• [1058] [C++] public: ApplicationException(String* message, Exception* innerException);
• [1059] [VB] Public Sub New(ByVal message As String, ByVal innerException As Exception)
• [1060] [JScript] public function ApplicationException(message: String, innerException: Exception);
  Description

[1061] Initializes a new instance of the System.ApplicationException class with a specified error message and a reference to the inner exception that is the root cause It of this exception.

[1062] When an ExceptionX is thrown as a direct result of a previous exception Y, the System.Exception.InnerException property of X should contain a reference to Y. The InnerException property returns the same value as was passed into the constructor, or null if the inner exception value was not supplied to the constructor. The error message that explains the reason for the exception. An instance of System.Exception that is the cause of the current Exception. If innerException is non-null, then the current Exception is raised in a catch block handling innerException.

[1063] HelpLink

[1064] HResult

[1065] InnerException

[1066] Message

[1067] Source

[1068] StackTrace

[1069] TargetSite

[1070] ArgIterator structure (System)

[1071] ToString

Description

[1072] Represents a variable-length argument list; that is, the parameters of a function that takes a variable number of arguments.

[1073] Typically, you use this class for writing compilers. The methods in this class are not generally useful in other kinds of applications.

[1074] ArgIterator

[1075] Example Syntax:

[1076] ToString

• [1077] [C#] public ArgIterator(RuntimeArgumentHandle arglist);
• [1078] [C++] public: ArgIterator(RuntimeArgumentHandle arglist);
• [1079] [VB] Public Sub New(ByVal arglist As RuntimeArgumentHandle)
• [1080] [JScript] public function ArgIterator(arglist: RuntimeArgumentHandle); Initializes a new instance of the ArgIterator class.
  Description

[1081] Initializes a new instance of the ArgIterator class using the specified argument list. An argument list consisting of both required and optional items.

[1082] ArgIterator

[1083] Example Syntax:

[1084] ToString

• [1085] [C#] unsafe public ArgIterator(RuntimeArgumentHandle arglist, void* ptr);
• [1086] [C++] public: ArgIterator(RuntimeArgumentHandle arglist, void* ptr);

[1087] End

• [1088] [C#] public void End( );
• [1089] [C++] public: void End( );
• [1090] [VB] Public Sub End( )
• [1091] [JScript] public function End( );
  Description

[1092] Moves the iterator to the end of the variable-length argument list; that is, it invalidates the iterator.

[1093] Conceptually, this method moves the iterator to the end of the list so that the next call to System.ArgIterator.GetNextArg generates an exception.

[1094] Equals

• [1095] [C#] public override bool Equals(object o);
• [1096] [C++] public: bool Equals(Object* o);
• [1097] [VB] Overrides Public Function Equals(ByVal o As Object) As Boolean
• [1098] [JScript] public override function Equals(o: Object): Boolean;
  Description

[1099] This method is not supported, and always throws NotSupportedException An object to be compared to this instance.

[1100] GetHashCode

• [1101] [C#] public override int GetHashCode( );
• [1102] [C++] public: int GetHashCode( );
• [1103] [VB] Overrides Public Function GetHashCode( ) As Integer
• [1104] [JScript] public override function GetHashCode( ): int;
  Description

[1105] Returns the hash code of this object.

Return Value: A 32-bit signed integer hash code.

[1106] GetNextArg

• [1107] [C#] public TypedReference GetNextArg( );
• [1108] [C++] public: TypedReference GetNextArg( );
• [1109] [VB] Public Function GetNextArg( ) As TypedReference
• [1110] [JScript] public function GetNextArg( ): TypedReference; Returns the next argument in a variable-length argument list.
  Description

[1111] Returns the next argument in a variable-length argument list.

Return Value: The next argument as a System.TypedReference object. The iterator is automatically advanced to the next argument.

[1112] GetNextArg

• [1113] [C#] public TypedReference GetNextArg(RuntimeTypeHandle rth);
• [1114] [C++] public: TypedReference GetNextArg(RuntimeTypeHandle rth);
• [1115] [VB] Public Function GetNextArg(ByVal rth As RuntimeTypeHandle) As TypedReference
• [1116] [JScript] public function GetNextArg(rth: RuntimeTypeHandle): TypedReference;
  Description

[1117] Returns the next argument in a variable-length argument list that has a specified type.

Return Value: The next argument as a System.TypedReference object.

[1118] The iterator is automatically advanced to the next argument. A runtime type handle that identifies the type of the argument to retrieve.

[1119] GetNextArgType

• [1120] [C#] public RuntimeTypeHandle GetNextArgType( );
• [1121] [C++] public: RuntimeTypeHandle GetNextArgType( );
• [1122] [VB] Public Function GetNextArgType( ) As RuntimeTypeHandle
• [1123] [JScript] public function GetNextArgType( ): RuntimeTypeHandle;
  Description

[1124] Returns the type of the next argument.

Return Value: The type of the next argument.

[1125] This method does not advance the iterator to the next argument.

[1126] GetRemainingCount

• [1127] [C#] public int GetRemainingCount( );
• [1128] [C++] public: int GetRemainingCount( );
• [1129] [VB] Public Function GetRemainingCount( ) As Integer
• [1130] [JScript] public function GetRemainingCount( ): int;
  Description

[1131] Returns the number of arguments remaining in the argument list.

Return Value: The number of remaining arguments.

[1132] ArgumentException class (System)

[1133] ToString

Description

[1134] The exception that is thrown when one of the arguments provided to a method is not valid.

[1135] System.ArgumentException is thrown when a method is invoked and at least one of the passed arguments does not meet the parameter specification of the called method. All instances of System.ArgumentException should carry a meaningful error message describing the invalid argument, as well as the expected range of values for the argument.

[1136] ArgumentException

[1137] Example Syntax:

[1138] ToString

• [1139] [C#] public ArgumentException( );
• [1140] [C++] public: ArgumentException( );
• [1141] [VB] Public Sub New( )
• [1142] [JScript] public function ArgumentException( ); Initializes a new instance of the System.ArgumentException class.
  Description

[1143] Initializes a new instance of the System.ArgumentException class with default properties.

[1144] The following table shows the initial property values for an instance of System.ArgumentException.

[1145] ArgumentException

[1146] Example Syntax:

[1147] ToString

• [1148] [C#] public ArgumentException(string message);
• [1149] [C++] public: ArgumentException(String* message);
• [1150] [VB] Public Sub New(ByVal message As String)
• [1151] [JScript] public function ArgumentException(message: String);
  Description

[1152] Initializes a new instance of the System.ArgumentException class with a specified error message.

[1153] The following table shows the initial property values for an instance of System.ArgumentException. The error message that explains the reason for the exception.

[1154] ArgumentException

[1155] Example Syntax:

[1156] ToString

• [1157] [C#] protected ArgumentException(SerializationInfo info, StreamingContext context);
• [1158] [C++] protected: ArgumentException(SerializationInfo* info, StreamingContext context);
• [1159] [VB] Protected Sub New(ByVal info As SerializationInfo, ByVal context As StreamingContext)
• [1160] [JScript] protected function ArgumentException(info: SerializationInfo, context: StreamingContext);
  Description

[1161] Initializes a new instance of the System.ArgumentException class with serialized data.

[1162] This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. For more information, see. The object that holds the serialized object data. The contextual information about the source or destination.

[1163] ArgumentException

[1164] Example Syntax:

[1165] ToString

• [1166] [C#] public ArgumentException(string message, Exception innerException);
• [1167] [C++] public: ArgumentException(String* message, Exception* innerException);
• [1168] [VB] Public Sub New(ByVal message As String, ByVal innerException As Exception)
• [1169] [JScript] public function ArgumentException(message: String, innerException: Exception);
  Description

[1170] Initializes a new instance of the System.ArgumentException class with a specified error message and a reference to the inner exception that is the root cause of this exception.

[1171] When an ExceptionX is thrown as a direct result of a previous exception Y. Is the System.Exception.InnerException property of X should contain a reference to Y. The InnerException property returns the same value as was passed into the constructor, or null if the inner exception value was not supplied to the constructor. The error message that explains the reason for the exception. An instance of System.Exception that is the cause of the current Exception. If innerException is non-null, then the current Exception is raised in a catch block handling innerException.

[1172] ArgumentException

[1173] Example Syntax:

[1174] ToString

• [1175] [C#] public ArgumentException(string message, string paramName);
• [1176] [C++] public: ArgumentException(String* message, String* paramName);
• [1177] [VB] Public Sub New(ByVal message As String, ByVal paramName As String)
• [1178] [JScript] public function ArgumentException(message: String, paramName: String);
  Description

[1179] Initializes a new instance of the System.ArgumentException class with a specified error message and the name of the parameter that causes this exception.

[1180] The following table shows the initial property values for an instance of System.ArgumentException. The error message that explains the reason for the exception. The name of the invalid parameter.

[1181] ArgumentException

[1182] Example Syntax:

[1183] ToString

• [1184] [C#] public ArgumentException(string message, string paramName, Exception innerException);
• [1185] [C++] public: ArgumentException(String* message, String* paramName, Exception* innerException);
• [1186] [VB] Public Sub New(ByVal message As String, ByVal paramName As String, ByVal innerException As Exception)
• [1187] [JScript] public function ArgumentException(message: String, paramName: String, innerException: Exception);
  Description

[1188] Initializes a new instance of the System.ArgumentException class with a specified error message, the parameter name, and a reference to the inner exception that is the root cause of this exception.

[1189] When an ExceptionX is thrown as a direct result of a previous exception Y, the System.Exception.InnerException property of X should contain a reference to Y. The InnerException property returns the same value as was passed into the constructor, or null if the inner exception value was not supplied to the constructor. The error message that explains the reason for the exception. The name of the invalid parameter. An instance of System.Exception that is the cause of the current Exception. If innerException is non-null, then the current Exception is raised in a catch block handling innerException.

[1190] HelpLink

[1191] HResult

[1192] InnerException

[1193] Message

[1194] ToString

Description

[1195] Gets the error message and the parameter name, or only the error message if no parameter name is s et.

[1196] This property overrides System.Exception.Message. The error message should be localized.

[1197] ParamName

[1198] ToString

• [1199] [C#] public virtual string ParamName {get;}
• [1200] [C++] public: _property virtual String* get_ParamName( );
• [1201] [VB] Overridable Public ReadOnly Property ParamName As String
• [1202] [JScript] public function get ParamName( ): String;
  Description

[1203] Gets the name of the parameter that causes this exception.

[1204] Every System.ArgumentException should carry the name of the parameter that causes this exception. The parameter name should not be localized.

[1205] Source

[1206] StackTrace

[1207] TargetSite

[1208] GetObjectData

• [1209] [C#] public override void GetObjectData(SerializationInfo info, StreamingContext context);
• [1210] [C++] public: void GetObjectData(SerializationInfo* info, StreamingContext context);
• [1211] [VB] Overrides Public Sub GetObjectData(ByVal info As SerializationInfo, ByVal context As StreamingContext)
• [1212] [JScript] public override function GetObjectData(info: SerializationInfo, context: StreamingContext);
  Description

[1213] Sets the System.Runtime.Serialization.SerializationInfo object with the parameter name and additional exception information.

[1214] System.ArgumentException.GetObjectData(System.Runtime.Serialization. SerializationInfo,System.Runtime.Serialization.StreamingContext) sets a System.Runtime.Serialization.SerializationInfo with all the exception object data targeted for serialization. During deserialization, the exception object is reconstituted from the System.Runtime.Serialization.SerializationInfo transmitted over the stream. The object that holds the serialized object data. The contextual information about the source or destination.

[1215] ArgumentNullException class (System)

[1216] ToString

Description

[1217] The exception that is thrown when null is passed to a method that does not accept it as a valid argument.

[1218] System.ArgumentNullException uses the HRESULT E_POINTER, which has the value 0x80004003.

[1219] ArgumentNullException

[1220] Example Syntax:

[1221] ToString

• [1222] [C#] public ArgumentNullException( );
• [1223] [C++] public: ArgumentNullException( );
• [1224] [VB] Public Sub New( )
• [1225] [JScript] public function ArgumentNullException( ); Initializes a new instance of the System.ArgumentNullException class.
  Description

[1226] Initializes a new instance of the System.ArgumentNullException class with default properties.

[1227] The following table shows the initial property values for an instance of System.ArgumentNullException

[1228] ArgumentNullException

[1229] Example Syntax:

[1230] ToString

• [1231] [C#] public ArgumentNullException(string paramName);
• [1232] [C++] public: ArgumentNullException(String* paramName);
• [1233] [VB] Public Sub New(ByVal paramName As String)
• [1234] [JScript] public function ArgumentNullException(paramName: String);
  Description

[1235] Initializes a new instance of the System.ArgumentNullException class with the name of the parameter that causes this exception.

[1236] The following table shows the initial property values for an instance of System.ArgumentNullException. The name of the parameter that is assigned null.

[1237] ArgumentNullException

[1238] Example Syntax:

[1239] ToString

• [1240] [C#] protected ArgumentNullException(SerializationInfo info, StreamingContext context);
• [1241] [C++] protected: ArgumentNullException(SerializationInfo* info, StreamingContext context);
• [1242] [VB] Protected Sub New(ByVal info As SerializationInfo, ByVal context As StreamingContext)
• [1243] [JScript] protected function ArgumentNullException(info: SerializationInfo, context: StreamingContext);
  Description

[1244] Initializes a new instance of the System.ArgumentNullException class with serialized data.

[1245] This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. For more information, see. The object that holds the serialized object data. The contextual information about the source or destination.

[1246] ArgumentNullException

[1247] Example Syntax:

[1248] ToString

• [1249] [C#] public ArgumentNullException(string paramName, string message);
• [1250] [C++] public: ArgumentNullException(String* paramName, String* message);
• [1251] [VB] Public Sub New(ByVal paramName As String, ByVal message As String)
• [1252] [JScript] public function ArgumentNullException(paramName: String, message: String);
  Description

[1253] Initializes an instance of the System.ArgumentNullException class with a specified error message and the name of the parameter that causes this exception.

[1254] The following table shows the initial property values for an instance of System.ArgumentNullException. The name of the parameter that is assigned null. The error message that explains the reason for the exception.

[1255] HelpLink

[1256] HResult

[1257] InnerException

[1258] Message

[1259] ParamName

[1260] Source

[1261] StackTrace

[1262] TargetSite

[1263] ArgumentOutOfRangeException class (System)

[1264] ToString

Description

[1265] The exception that is thrown when the value of an argument is outside the allowable range of values as defined by the invoked method.

[1266] System.ArgumentOutOfRangeException is used extensively by: Classes in the System.Collections and System.IO namespaces.

[1267] ArgumentOutOfRangeException

[1268] Example Syntax:

[1269] ToString

• [1270] [C#] public ArgumentOutOfRangeException( );
• [1271] [C++] public: ArgumentOutOfRangeException( );
• [1272] [VB] Public Sub New( )
• [1273] [JScript] public function ArgumentOutOfRangeException( ); Initializes a new instance of the System.ArgumentOutOfRangeException class.
  Description

[1274] Initializes a new instance of the System.ArgumentOutOfRangeException class with default properties. The following table shows the initial property values for an instance of System.ArgumentOutOfRangeException.

[1275] ArgumentOutOfRangeException

[1276] Example Syntax:

[1277] ToString

• [1278] [C#] public ArgumentOutOfRangeException(string paramName);
• [1279] [C++] public: ArgumentOutOfRangeException(String* paramName);
• [1280] [VB] Public Sub New(ByVal paramName As String)
• [1281] [JScript] public function ArgumentOutOfRangeException(paramName: String);
  Description

[1282] Initializes a new instance of the System.ArgumentOutOfRangeException class with the name of the parameter that causes this exception.

[1283] The following table shows the initial property values for an instance of System.ArgumentOutOfRangeException. The name of the invalid parameter.

[1284] ArgumentOutOfRangeException

[1285] Example Syntax:

[1286] ToString

• [1287] [C#] protected ArgumentOutOfRangeException(SerializationInfo info, StreamingContext context);
• [1288] [C++] protected: ArgumentOutOfRangeException(SerializationInfo* info, StreamingContext context);
• [1289] [VB] Protected Sub New(ByVal info As SerializationInfo, ByVal context As StreamingContext)
• [1290] [JScript] protected function ArgumentOutOfRangeException(info: SerializationInfo, context: StreamingContext);
  Description

[1291] Initializes a new instance of the System.ArgumentOutOfRangeException class with serialized data.

[1292] This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. For more information, see. The object that holds the serialized object data. The contextual information about the source or destination.

[1293] ArgumentOutOfRangeException

[1294] Example Syntax:

[1295] ToString

• [1296] [C#] public ArgumentOutOfRangeException(string paramName, string message);
• [1297] [C++] public: ArgumentOutOfRangeException(String* paramName, String* message);
• [1298] [VB] Public Sub New(ByVal paramName As String, ByVal message As String)
• [1299] [JScript] public function ArgumentOutOfRangeException(paramName: String, message: String);
  Description

[1300] Initializes a new instance of the System.ArgumentOutOfRangeException class with a specified error message and the name of the parameter that causes this exception.

[1301] The following table shows the initial property values for an instance of System.ArgumentOutOfRangeException. The name of the invalid parameter. The error message that explains the reason for the exception.

[1302] ArgumentOutOfRangeException

[1303] Example Syntax:

[1304] ToString

• [1305] [C#) public ArgumentOutOfRangeException(string paramName, object actualValue, string message);
• [1306] [C++] public: ArgumentOutOfRangeException(String* paramName, Object* actualValue, String* message);
• [1307] [VB] Public Sub New(ByVal paramName As String, ByVal actualValue As Object, ByVal message As String)
• [1308] [JScript] public function ArgumentOutOfRangeException(paramName: String, actualValue: Object, message: String);
  Description

[1309] Initializes a new instance of the System.ArgumentOutOfRangeException class with a specified error message, the parameter name, and the value of the argument.

[1310] This constructor with the additional argument actualValue is not used within the .NET Framework class library. The System.ArgumentOutOfRangeException.ActualValue property is provided so that applications can make use of the available argument value. The name of the invalid parameter. The value of the argument that causes this exception. The error message that explains the reason for the exception.

[1311] ActualValue

[1312] ToString

• [1313] [C#] public virtual object ActualValue {get;}
• [1314] [C++] public: _property virtual Object* get_ActualValue( );
• [1315] [VB] Overridable Public ReadOnly Property ActualValue As Object
• [1316] [JScript] public function get ActualValue( ): Object;
  Description

[1317] Gets the argument value that causes this exception.

[1318] The System.ArgumentOutOfRangeException.ActualValue property is assigned a value at the time of object construction. If the System.ArgumentOutOfRangeException.ActualValue property value is not null, a string representation of the value is then appended to the message string held by the System.ArgumentOutOfRangeException.Message property.

[1319] HelpLink

[1320] HResult

[1321] InnerException

[1322] Message

[1323] ToString

Description

[1324] Gets the error message and the string representation of the invalid argument value, or only the error message if the argument value is null.

[1325] This property overrides System.ArgumentException.Message.

[1326] ParamName

[1327] Source

[1328] StackTrace

[1329] TargetSite

[1330] GetObjectData

• [1331] [C#] public override void GetObjectData(SerializationInfo info, StreamingContext context);
• [1332] [C++] public: void GetObjectData(SerializationInfo* info, StreamingContext context);
• [1333] [VB] Overrides Public Sub GetObjectData(ByVal info As SerializationInfo, ByVal context As StreamingContext)
• [1334] [JScript] public override function GetObjectData(info: SerializationInfo, context: StreamingContext);
  Description

[1335] Sets the System.Runtime.Serialization.SerializationInfo object with the invalid argument value and additional exception information.

[1336] System.ArgumentOutOfRangeException.GetObjectData(System.Runtime. Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext) sets a System.Runtime.Serialization.SerializationInfo with all the exception object data targeted for serialization. During deserialization, the exception object is reconstituted from the System.Runtime.Serialization.SerializationInfo transmitted over the stream. The object that holds the serialized object data. The contextual information about the source or destination.

[1337] ArithmeticException class (System)

[1338] ToString

Description

[1339] The exception that is thrown for errors in an arithmetic, casting, or conversion operation. System.ArithmeticException is the base class for System.DivideByZeroException, System.NotFiniteNumberException, and System.OverflowException. In general, use one of the derived classes of System.ArithmeticException to more precisely indicate the exact nature of the error. Throw an System.ArithmeticException if you are only interested in capturing a general arithmetic error.

[1340] ArithmeticException

[1341] Example Syntax:

[1342] ToString

• [1343] [C#] public ArithmeticException( );
• [1344] [C++] public: ArithmeticException( );
• [1345] [VB] Public Sub New( )
• [1346] [JScript] public function ArithmeticException( ); Initializes a new instance of the System.ArithmeticException class.
  Description

[1347] Initializes a new instance of the System.ArithmeticException class with

[1348] The following table shows initial property values for an instance of System.ArithmeticException.

[1349] ArithmeticException

[1350] Example Syntax:

[1351] ToString

• [1352] [C#] public ArithmeticException(string message);
• [1353] [C++] public: ArithmeticException(String* message);
• [1354] [VB] Public Sub New(ByVal message As String)
• [1355] [JScript] public function ArithmeticException(message: String);
  Description

[1356] Initializes a new instance of the System.ArithmeticException class with a specified error message.

[1357] The following table shows initial property values for an instance of System.ArithmeticException. The error message that explains the reason for the exception.

[1358] ArithmeticException

[1359] Example Syntax:

[1360] ToString

• [1361] [C#] protected ArithmeticException(SerializationInfo info, StreamingContext context);
• [1362] [C++] protected: ArithmeticException(SerializationInfo* info, StreamingContext context);
• [1363] [VB] Protected Sub New(ByVal info As SerializationInfo, ByVal context As StreamingContext)
• [1364] [JScript] protected function ArithmeticException(info: SerializationInfo, context: StreamingContext);
  Description

[1365] Initializes a new instance of the System.ArithmeticException class with serialized data.

[1366] This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. For more information, see. The object that holds the serialized object data. The contextual information about the source or destination.

[1367] ArithmeticException

[1368] Example Syntax:

[1369] ToString

• [1370] [C#] public ArithmeticException(string message, Exception innerException);
• [1371] [C++] public: ArithmeticException(String* message, Exception* innerException);
• [1372] [VB] Public Sub New(ByVal message As String, ByVal innerException As Exception)
• [1373] [JScript] public function ArithmeticException(message: String, innerException: Exception);
  Description

[1374] Initializes a new instance of the System.ArithmeticException class with a specified error message and a reference to the exception that is the root cause of this exception.

[1375] When an ExceptionX is thrown as a direct result of a previous exception Y, the System.Exception.InnerException property of X should contain a reference to Y. The InnerException property returns the same value as was passed into the constructor, or null if the inner exception value was not supplied to the constructor. The error message that explains the reason for the exception. An instance of System.Exception that is the cause of the current Exception. If innerException is non-null, then the current Exception is raised in a catch block handling innerException.

[1376] HelpLink

[1377] HResult

[1378] InnerException

[1379] Message

[1380] Source

[1381] StackTrace

[1382] TargetSite

[1383] Array class (System)

[1384] ToString

Description

[1385] Provides methods for creating, manipulating, searching and sorting arrays, thereby serving as the base class for all arrays in the common language runtime.

[1386] An element is a value in the System.Array. The length of an System.Array is the total number of elements it can contain. The rank of an System.Array is the number of dimensions in the System.Array. The lower bound or lowbound of a dimension of an System.Array is the starting index of that dimension of the System.Array; a multidimensional System.Array can have different bounds for each dimension.

[1387] Array

[1388] Example Syntax:

[1389] ToString

• [1390] [C#] protected Array( );
• [1391] [C++] protected: Array( );
• [1392] [VB] Protected Sub New( )
• [1393] [JScript] protected function Array( );

[1394] IsFixedSize

[1395] ToString

• [1396] [C#] public virtual bool IsFixedSize {get;}
• [1397] [C++] public: _property virtual bool get_IsFixedSize( );
• [1398] [VB] Overridable Public ReadOnly Property IsFixedSize As Boolean
• [1399] [JScript] public function get IsFixedSize( ): Boolean;
  Description

[1400] Gets a value indicating whether the System.Array has a fixed size.

[1401] This method implements the System.Collections.IList interface. It can be overridden by a derived class.

[1402] IsReadOnly

[1403] ToString

• [1404] [C#] public virtual bool IsReadOnly {get;}
• [1405] [C++] public: _property virtual bool get_IsReadOnly( );
• [1406] [VB] Overridable Public ReadOnly Property IsReadOnly As Boolean
• [1407] [JScript] public function get IsReadOnly( ): Boolean;
  Description

[1408] Gets a value indicating whether the System.Array is read-only.

[1409] This method implements the System.Collections.IList interface. It can be overridden by a derived class.

[1410] IsSynchronized

[1411] ToString

• [1412] [C#] public virtual bool IsSynchronized {get;}
• [1413] [C++] public: _property virtual bool get_IsSynchronized( );
• [1414] [VB] Overridable Public ReadOnly Property IsSynchronized As Boolean
• [1415] [JScript] public function get IsSynchronized( ): Boolean;
  Description

[1416] Gets a value indicating whether access to the System.Array is synchronized (thread-safe).

[1417] This property implements the System.Collections.ICollection interface.

[1418] Length

[1419] ToString

• [1420] [C#] public int Length {get;}
• [1421] [C++] public: _property int get_Length( );
• [1422] [VB] Public ReadOnly Property Length As Integer
• [1423] [JScript] public function get Length( ): int;
  Description

[1424] Gets the total number of elements in all the dimensions of the System.Array.

[1425] Rank

[1426] ToString

• [1427] [C#] public int Rank {get;}
• [1428] [C++] public: _property int get_Rank( );
• [1429] [VB] Public ReadOnly Property Rank As Integer
• [1430] [JScript] public function get Rank( ): int;
  Description

[1431] Gets the rank (number of dimensions) of the System.Array.

[1432] SyncRoot

[1433] ToString

• [1434] [C#] public virtual object SyncRoot {get;}
• [1435] [C++] public: _property virtual Object* get_SyncRoot( );
• [1436] [VB] Overridable Public ReadOnly Property SyncRoot As Object
• [1437] [JScript] public function get SyncRoot( ): Object;
  Description

[1438] Gets an object that can be used to synchronize access to the System.Array

[1439] This property implements the System.Collections.ICollection interface.

[1440] BinarySearch

• [1441] [C#] public static int BinarySearch(Array array, object value);
• [1442] [C++] public: static int BinarySearch(Array* array, Object* value);
• [1443] [VB] Public Shared Function BinarySearch(ByVal array As Array, ByVal value As Object) As Integer
• [1444] [JScript] public static function BinarySearch(array: Array, value: Object): int; Searches a one-dimensional sorted System.Array for a value, using a binary search algorithm.
  Description

[1445] Searches a one-dimensional sorted System.Array for a specific element, using the System.IComparable interface implemented by each element of the System.Array and by the specified System.Object.

Return Value: The index of value in the System.Array, if value is found; otherwise, a negative number, which is the bitwise complement of the index of the first element that is larger than value.

[1446] The value parameter and each element of array must implement the System.IComparable interface, which is used for comparisons. If array's elements are not already sorted in increasing value according to the System.IComparable implementation, the result might be incorrect. Duplicate elements are allowed. The one-dimensional System.Array to search. The System.Object to search for.

[1447] BinarySearch

• [1448] [C#] public static int BinarySearch(Array array, object value, IComparer comparer);
• [1449] [C++] public: static int BinarySearch(Array* array, Object* value, IComparer* comparer);
• [1450] [VB] Public Shared Function BinarySearch(ByVal array As Array, ByVal value As Object, ByVal comparer As IComparer) As Integer
• [1451] [JScript] public static function BinarySearch(array: Array, value: Object, comparer: IComparer): int;
  Description

[1452] Searches a one-dimensional sorted System.Array for a value, using the specified System.Collections.IComparer interface.

Return Value: The index of value in the System.Array, if value is found; otherwise, a negative number, which is the bitwise complement of the index of the first element that is larger than value.

[1453] The comparer customizes how the elements are compared. For example, you can use a System.Collections.CaseInsensitiveComparer instance as the comparer to perform case-insensitive string searches. The one-dimensional System.Array to search. The System.Object to search for. The System.Collections.IComparer implementation to use when comparing elements.

[1454] BinarySearch

• [1455] [C#] public static int BinarySearch(Array array, int index, int length, object value);
• [1456] [C++] public: static int BinarySearch(Array* array, int index, int length, Object* value);
• [1457] [VB] Public Shared Function BinarySearch(ByVal array As Array, ByVal index As Integer, ByVal length As Integer, ByVal value As Object) As Integer
• [1458] [JScript] public static function BinarySearch(array: Array, index: int, length: int, value: Object): int;
  Description

[1459] Searches a section of a one-dimensional sorted System.Array for a value, using the System.IComparable interface implemented by each element of the System.Array and by the specified value.

Return Value: The index of value in the System.Array, if value is found; otherwise, a negative number, which is the bitwise complement of the index of the first element that is larger than value.

[1460] The value parameter and each element of array must implement the System.IComparable interface, which is used for comparisons. If array's elements are not already sorted in increasing value according to the System.IComparable implementation, the result might be incorrect. Duplicate elements are allowed. The one-dimensional System.Array to search. The starting index of the range to search. The length of the range to search. The System.Object to search for.

[1461] BinarySearch

• [1462] [C#] public static int BinarySearch(Array array, int index, int length, object value, IComparer comparer);
• [1463] [C++] public: static int BinarySearch(Array* array, int index, int length, Object* value, IComparer* comparer);
• [1464] [VB] Public Shared Function BinarySearch(ByVal array As Array, ByVal index As Integer, ByVal length As Integer, ByVal value As Object, ByVal comparer As IComparer) As Integer
• [1465] [JScript] public static function BinarySearch(array: Array, index: int, length: int, value: Object, comparer: IComparer) int;
  Description

[1466] Searches a section of a one-dimensional sorted System.Array for a value, using the specified System.Collections.IComparer interface.

Return Value: The index of value in the System.Array, if value is found; otherwise, a negative number, which is the bitwise complement of the index of the first element that is larger than value.

[1467] The comparer customizes how the elements are compared. For example, you can use a System.Collections.CaseInsensitiveComparer instance as the comparer to perform case-insensitive string searches. The one-dimensional System.Array to search. The starting index of the range to search. The length of the range to search. The System.Object to search for. The System.Collections.IComparer implementation to use when comparing elements.

[1468] Clear

• [1469] [C#] public static void Clear(Array array, int index, int length);
• [1470] [C++] public: static void Clear(Array* array, int index, int length);
• [1471] [VB] Public Shared Sub Clear(ByVal array As Array, ByVal index As Integer, ByVal length As Integer)
• [1472] [JScript] public static function Clear(array: Array, index: int, length: int);
  Description

[1473] Sets a range of elements in the System.Array to zero or to null.

[1474] Reference-type elements are set to null. Value-type elements are set to zero. The System.Array whose elements need to be cleared. The starting index of the range of elements to clear. The number of elements to clear.

[1475] Clone

• [1476] [C#] public virtual object Clone( );
• [1477] [C++] public: virtual Object* Clone( );
• [1478] [VB] Overridable Public Function Clone( ) As Object
• [1479] [JScript] public function Clone( ): Object;
  Description

[1480] Creates a shallow copy of the System.Array

Return Value: A shallow copy of the System.Array.

[1481] This method can be overridden by a derived class.

[1482] Copy

• [1483] [C#] public static void Copy(Array sourceArray, Array destinationArray, int length);
• [1484] [C++] public: static void Copy(Array* sourceArray, Array* destinationArray, int length);
• [1485] [VB] Public Shared Sub Copy(ByVal sourceArray As Array, ByVal destinationArray As Array, ByVal length As Integer)
• [1486] [JScript] public static function Copy(sourceArray: Array, destinationArray: Array, length: int); Copies a section of one System.Array to another System.Array and performs type downcasting as required.
  Description

[1487] Copies a range of elements from an System.Array starting at the first element and pastes them into another System.Array starting at the first element.

[1488] sourceArray and destinationArray must have the same number of dimensions. The System.Array that contains the data to copy. The System.Array that receives the data. The number of elements to copy.

[1489] Copy

• [1490] [C#] public static void Copy(Array sourceArray, int sourceIndex, Array destinationArray, int destinationIndex, int length);
• [1491] [C++] public: static void Copy(Array* sourceArray, int sourceIndex, Array* destinationArray, int destinationIndex, int length);
• [1492] [VB] Public Shared Sub Copy(ByVal sourceArray As Array, ByVal sourceIndex As Integer, ByVal destinationArray As Array, ByVal destinationIndex As Integer, ByVal length As Integer)
• [1493] [JScript] public static function Copy(sourceArray: Array, sourceIndex: int, destinationArray: Array, destinationIndex: int, length: int);
  Description

[1494] Copies a range of elements from an System.Array starting at the specified source index and pastes them to another System.Array starting at the specified destination index.

[1495] sourceArray and destinationArray must have the same number of dimensions. The System.Array that contains the data to copy. The index in the sourceArray at which copying begins. The System.Array that receives the data. The index in the destinationArray at which storing begins. The number of elements to copy.

[1496] CopyTo

• [1497] [C#] public virtual void CopyTo(Array array, int index);
• [1498] [C++] public: virtual void CopyTo(Array* array, int index);
• [1499] [VB] Overridable Public Sub CopyTo(ByVal array As Array, ByVal index As Integer)
• [1500] [JScript] public function CopyTo(array: Array, index: int);
  Description

[1501] Copies all the elements of the current one-dimensional System.Array to the specified one-dimensional System.Array starting at the specified destination System.Array index.

[1502] This method can be overridden by a derived class. The one-dimensional System.Array that is the destination of the elements copied from the current System.Array. The zero-based relative index in array at which copying begins.

[1503] CreateInstance

• [1504] [C#] public static Array CreateInstance(Type elementType, int length);
• [1505] [C++] public: static Array* CreateInstance(Type* elementType, int length);
• [1506] [VB] Public Shared Function CreateInstance(ByVal elementType As Type, ByVal length As Integer) As Array
• [1507] [JScript] public static function CreateInstance(elementType: Type, length: int) Array; Initializes a new instance of the System.Array class.
  Description

[1508] Creates a one-dimensional System.Array of the specified System.Type and length, with zero-based indexing.

Return Value: A new one-dimensional System.Array of the specified System.Type with the specified length, using zero-based indexing.

[1509] Unlike most classes, System.Array provides the System.Array.CreateInstance(System.Type,System.Int32) method, instead of public constructors, to allow for late bound access. The System.Type of System.Array to create. The size of the System.Array to create.

[1510] CreateInstance

• [1511] [C#] public static Array CreateInstance(Type elementType, int[ ] lengths);
• [1512] [C++] public: static Array* CreateInstance(Type* elementType, int lengths _gc[ ]);
• [1513] [VB] Public Shared Function CreateInstance(ByVal elementType As Type, ByVal lengths( ) As Integer) As Array
• [1514] [JScript] public static function CreateInstance(elementType: Type, lengths: int[ ]): Array;
  Description

[1515] Creates a multidimensional System.Array of the specified System.Type and dimension lengths, with zero-based indexing.

Return Value: A new multidimensional System.Array of the specified System.Type with the specified length for each dimension, using zero-based indexing.

[1516] Unlike most classes, System.Array provides the System.Array.CreateInstance(System.Type,System.Int32) method, instead of public constructors, to allow for late bound access. The System.Type of System.Array to create. An array that contains the size of each dimension of the System.Array to create.

[1517] CreateInstance

• [1518] [C#] public static Array CreateInstance(Type elementType, int length, int Length2);
• [1519] [C++] public: static Array* CreateInstance(Type* elementType, int length, int length2);
• [1520] [VB] Public Shared Function CreateInstance(ByVal elementType As Type, ByVal length1 As Integer, ByVal length2 As Integer) As Array
• [1521] [JScript] public static function CreateInstance(elementType: Type, length1: int, length2: int): Array;
  Description

[1522] Creates a two-dimensional System.Array of the specified System.Type and dimension lengths, with zero-based indexing.

Return Value: A new two-dimensional System.Array of the specified System.Type with the specified length for each dimension, using zero-based indexing.

[1523] Unlike most classes, System.Array provides the System.Array.CreateInstance(System.Type,System.Int32) method, instead of public constructors, to allow for late bound access. The System.Type of System.Array to create. The size of the first dimension of the System.Array to create. The size of the second dimension of the System.Array to create.

[1524] CreateInstance

• [1525] [C#] public static Array CreateInstance(Type elementType, int[ ] lengths, int[ ] lowerBounds);
• [1526] [C++] public: static Array* CreateInstance(Type* elementType, int lengths _gc[ ], int lowerBounds _gc[ ]);
• [1527] [VB] Public Shared Function CreateInstance(ByVal elementType As Type, ByVal lengths( ) As Integer, ByVal lowerBounds( ) As Integer) As Array
• [1528] [JScript] public static function CreateInstance(elementType: Type, lengths: int[ ], lowerBounds: int[ ]): Array;
  Description

[1529] Creates a multidimensional System.Array of the specified System.Type and dimension lengths, with the specified lower bounds.

Return Value: A new multidimensional System.Array of the specified System.Type with the specified length and lower bound for each dimension.

[1530] Unlike most classes, System.Array provides the System.Array.CreateInstance(System.Type,System.Int32) method, instead of public constructors, to allow for late bound access. The System.Type of System.Array to create. A one-dimensional array that contains the size of each dimension of the System.Array to create. A one-dimensional array that contains the lower bound (starting index) of each dimension of the System.Array to create.

[1531] CreateInstance

• [1532] [C#] public static Array CreateInstance(Type elementType, int length1, int length2, int length3);
• [1533] [C++] public: static Array* CreateInstance(Type* elementType, int length1, int length2, int length3);
• [1534] [VB] Public Shared Function CreateInstance(ByVal elementType As Type, ByVal length1 As Integer, ByVal length2 As Integer, ByVal length3 As Integer) As Array
• [1535] [JScript] public static function CreateInstance(elementType: Type, length1: int, length2: int, length3: int): Array;
  Description

[1536] Creates a three-dimensional System.Array of the specified System.Type and dimension lengths, with zero-based indexing.

Return Value: A new three-dimensional System.Array of the specified System.Type with the specified length for each dimension, using zero-based indexing.

[1537] Unlike most classes, System.Array provides the System.Array.CreateInstance(System.Type,System.Int32) method, instead of public constructors, to allow for late bound access. The System.Type of System.Array to create. The size of the first dimension of the System.Array to create. The size of the second dimension of the System.Array to create. The size of the third dimension of the System.Array to create.

[1538] GetEnumerator

• [1539] [C#] public virtual IEnumerator GetEnumerator( );
• [1540] [C++] public: virtual IEnumerator* GetEnumerator( );
• [1541] [VB] Overridable Public Function GetEnumerator( ) As IEnumerator
• [1542] [JScript] public function GetEnumerator( ): IEnumerator;
  Description

[1543] Returns an System.Collections.IEnumerator for the System.Array.

Return Value: An System.Collections.IEnumerator for the System.Array.

[1544] This method can be overridden by a derived class.

[1545] GetLength

• [1546] [C#] public int GetLength(int dimension);
• [1547] [C++] public: int GetLength(int dimension);
• [1548] [VB] Public Function GetLength(ByVal dimension As Integer) As Integer
• [1549] [JScript] public function GetLength(dimension: int): int;
  Description

[1550] Gets the number of elements in the specified dimension of the System.Array.

Return Value: The number of elements in the specified dimension.

[1551] For example, GetLength(0) returns the number of elements in the first dimension of the System.Array. A zero-based dimension of the System.Array whose length needs to be determined.

[1552] GetLowerBound

• [1553] [C#] public int GetLowerBound(int dimension);
• [1554] [C++] public: int GetLowerBound(int dimension);
• [1555] [VB] Public Function GetLowerBound(ByVal dimension As Integer) As Integer
• [1556] [JScript] public function GetLowerBound(dimension: int): int;
  Description

[1557] Gets the lower bound of the specified dimension in the System.Array

[1558] Return Value: The lower bound of the specified dimension in the System.Array. For example, GetLowerBound(0) returns the lower bound for the indexes of the first dimension of the System.Array, and GetLowerBound(Rank−1) returns the lower bound of the last dimension of the System.Array. A zero-based dimension of the System.Array whose lower bound needs to be determined.

[1559] GetUpperBound

• [1560] [C#] public int GetUpperBound(int dimension);
• [1561] [C++] public: int GetUpperBound(int dimension);
• [1562] [VB] Public Function GetUpperBound(ByVal dimension As Integer) As Integer
• [1563] [JScript] public function GetUpperBound(dimension: int): int;
  Description

[1564] Gets the upper bound of the specified dimension in the System.Array.

Return Value: The upper bound of the specified dimension in the System.Array.

[1565] For example, GetUpperBound(0) returns the upper bound for the indexes of the first dimension of the System.Array and GetUpperBound(Rank−1) returns the upper bound of the last dimension of the System.Array. A zero-based dimension of the System.Array whose upper bound needs to be determined.

[1566] GetValue

• [1567] [C#] public object GetValue(int index);
• [1568] [C++] public: Object* GetValue(int index);
• [1569] [VB] Public Function GetValue(ByVal index As Integer) As Object
• [1570] [JScript] public function GetValue(index: int): Object;
  Description

[1571] Gets the value at the specified position in a one-dimensional System.Array

Return Value: The value at the specified position in the one-dimensional System.Array.

[1572] The System.Array.GetLowerBound(System.Int32) and ISystem.Array.GetUpperBound(System.Int32) methods can determine whether the value of index is out of bounds. The position of the value to get from the System.Array.

[1573] GetValue

• [1574] [C#] public object GetValue(int[ ] indices);
• [1575] [C++] public: Object* GetValue(int indices_gc[ ]);
• [1576] [VB] Public Function GetValue(ByVal indices( ) As Integer) As Object
• [1577] [JScript] public function GetValue(indices: int[ ]): Object; Gets the values of the System.Array elements at the specified indexes.
  Description

[1578] Gets the value at the specified position in a multidimensional System.Array.

Return Value: The value at the specified position in the System.Array.

[1579] The number of elements in indices must equal the number of dimensions in the System.Array. All elements in the indices array must collectively specify the position of the desired element in the multidimensional System.Array. A one-dimensional array of indexes that specifies the position of the element to get from the System.Array.

[1580] GetValue

• [1581] [C#] public object GetValue(int index1, int index2);
• [1582] [C++] public: Object* GetValue(int index1, int index2);
• [1583] [VB] Public Function GetValue(ByVal index1 As Integer, ByVal index2 As Integer) As Object
• [1584] [JScript] public function GetValue(index1: int, index2: int): Object;
  Description

[1585] Gets the value at the specified position in a two-dimensional System.Array

Return Value: The value at the specified position in the System.Array.

[1586] The System.Array.GetLowerBound(System.Int32) and System.Array.GetUpperBound(System.Int32) methods can determine whether any of the indexes is out of bounds. The first-dimension index of the System.Array element to get. The second-dimension index of the System.Array element to get.

[1587] GetValue

• [1588] [C#] public object GetValue(int index1, int index2, int index3);
• [1589] [C++] public: Object* GetValue(int index1, int index2, int index3);
• [1590] [VB] Public Function GetValue(ByVal index1 As Integer, ByVal index2 As Integer, ByVal index3 As Integer) As Object
• [1591] [JScript] public function GetValue(index1: int, index2: int, index3: int): Object;
  Description

[1592] Gets the value at the specified position in a three-dimensional System.Array.

Return Value: The value at the specified position in the System.Array.

[1593] The System.Array.GetLowerBound(System.Int32) and System.Array.GetUpperBound(System.Int32) methods can determine whether any of the indexes is out of bounds. The first-dimension index of the System.Array element to get. The second-dimension index of the System.Array element to get. The third-dimension index of the System.Array element to get.

[1594] IndexOf

• [1595] [C#] public static int IndexOf(Array array, object value);
• [1596] [C++] public: static int IndexOf(Array* array, Object* value);
• [1597] [VB] Public Shared Function IndexOf(ByVal array As Array, ByVal value As Object) As Integer
• [1598] [JScript] public static function IndexOf(array: Array, value: Object): int; Returns the index of the first occurrence of a value in a one-dimensional System.Array or in a portion of the System.Array.
  Description

[1599] Searches for the specified System.Object and returns the index of the first occurrence within the entire one-dimensional System.Array.

Return Value: The index of the first occurrence of value within the entire array, if found; otherwise, the lower bound of the array−1.

[1600] The one-dimensional System.Array is searched forward starting at the first element and ending at the last element. The elements are compared to the specified value using the System.Object.Equals(System.Object) method. The one-dimensional System.Array to search. The System.Object to locate in array.

[1601] IndexOf

• [1602] [C#] public static int IndexOf(Array array, object value, int startIndex);
• [1603] [C++] public: static int IndexOf(Array* array, Object* value, int startIndex);
• [1604] [VB] Public Shared Function IndexOf(ByVal array As Array, ByVal value As Object, ByVal startIndex As Integer) As Integer
• [1605] [JScript] public static function IndexOf(array: Array, value: Object, startIndex: int): int;
  Description

[1606] Searches for the specified System.Object and returns the index of the first occurrence within the section of the one-dimensional System.Array that extends from the specified index to the last element.

Return Value: The index of the first occurrence of value within the section of array that extends from startIndex to the last element, if found; otherwise, the lower bound of the array−1.

[1607] The one-dimensional System.Array is searched forward starting at startIndex and ending at the last element. The elements are compared to the specified value using the System.Object.Equals(System.Object) method. The one-dimensional System.Array to search. The System.Object to locate in array. The starting index of the search.

[1608] IndexOf

• [1609] [C#] public static int IndexOf(Array array, object value, int startIndex, it count);
• [1610] [C++] public: static int IndexOf(Array* array, Object* value, int startIndex, int count);
• [1611] [VB] Public Shared Function IndexOf(ByVal array As Array, ByVal value As Object, ByVal startIndex As Integer, ByVal count As Integer) As Integer
• [1612] [JScript] public static function IndexOf(array: Array, value: Object, startIndex: int, count: int): int;
  Description

[1613] Searches for the specified System.Object and returns the index of the first occurrence within the section of the one-dimensional System.Array that starts at g the specified index and contains the specified number of elements.

Return Value: The index of the first occurrence of value within the section of array that starts at startIndex and contains count number of elements, if found; otherwise, the lower bound of the array−1.

[1614] The one-dimensional System.Array is searched forward starting at startIndex and ending at startIndex+count−1. The elements are compared to the specified value using the System.Object.Equals(System.Object) method. The one-dimensional System.Array to search. The System.Object to locate in array. The starting index of the search. The number of elements in the section to search.

[1615] Initialize

• [1616] [C#] public void Initialize( );
• [1617] [C++] public: void Initialize( );
• [1618] [VB] Public Sub Initialize( )
• [1619] [JScript] public function Initialize( );
  Description

[1620] Initializes every element of the value-type System.Array by calling the default constructor of the value type.

[1621] This method must not be used on reference-type arrays.

[1622] LastIndexOf

• [1623] [C#] public static int LastIndexOf(Array array, object value);
• [1624] [C++] public: static int LastIndexOf(Array* array, Object* value);
• [1625] [VB] Public Shared Function LastIndexOf(ByVal array As Array, ByVal value As Object) As Integer
• [1626] [JScript] public static function LastIndexOf(array: Array, value: Object): int; Returns the index of the last occurrence of a value in a one-dimensional System.Array or in a portion of the System.Array.
  Description

[1627] Searches for the specified System.Object and returns the index of the last occurrence within the entire one-dimensional System.Array.

Return Value: The index of the last occurrence of value within the entire array, if found; otherwise, the lower bound of the array−1.

[1628] The one-dimensional System.Array is searched backward starting at the last element and ending at the first element. The elements are compared to the specified value using the System.Object.Equals(System.Object) method. The one-dimensional System.Array to search. The System.Object to locate in array.

[1629] LastIndexOf

• [1630] [C#] public static int LastIndexOf(Array array, object value, int startIndex);
• [1631] [C++] public: static int LastIndexOf(Array* array, Object* value, int startIndex);
• [1632] [VB] Public Shared Function LastIndexOf(ByVal array As Array, ByVal value As Object, ByVal startIndex As Integer) As Integer
• [1633] [JScript] public static function LastIndexOf(array: Array, value: Object, startIndex: int): int;
  Description

[1634] Searches for the specified System.Object and returns the index of the last occurrence within the section of the one-dimensional System.Array that extends from the first element to the specified index.

Return Value: The index of the last occurrence of value within the section of array that extends from the first element to startIndex, if found; otherwise, the lower bound of the array−1.

[1635] The one-dimensional System.Array is searched backward starting at startIndex and ending at the first element. The elements are compared to the specified value using the System.Object.Equals(System.Object) method. The one-dimensional System.Array to search. The System.Object to locate in array. The starting index of the backward search.

[1636] LastIndexOf

• [1637] [C#] public static int LastIndexOf(Array array, object value, int startIndex, int count);
• [1638] [C++] public: static int LastIndexOf(Array* array, Object* value, int startIndex, int count);
• [1639] [VB] Public Shared Function LastIndexOf(ByVal array As Array, ByVal value As Object, ByVal startIndex As Integer, ByVal count As Integer) As Integer
• [1640] [JScript] public static function LastIndexOf(array: Array, value: Object, startIndex: int, count: int): int;
  Description

[1641] Searches for the specified System.Object and returns the index of the last occurrence within the section of the one-dimensional System.Array that contains the specified number of elements and ends at the specified index.

Return Value: The index of the last occurrence of value within the section of array that contains count number of elements and ends at startIndex, if found; otherwise, the lower bound of the array−1.

[1642] The one-dimensional System.Array is searched backward starting at startIndex and ending at startIndex−count+1. The elements are compared to the specified value using the System.Object.Equals(System.Object) method. The one-dimensional System.Array to search. The System.Object to locate in array. The starting index of the backward search. The number of elements in the section to search.

[1643] Reverse

• [1644] [C#] public static void Reverse(Array array);
• [1645] [C++] public: static void Reverse(Array* array);
• [1646] [VB] Public Shared Sub Reverse(ByVal array As Array) to [JScript] public static function Reverse(array: Array); Reverses the order of the elements in a one-dimensional System.Array or in a portion of the System.Array
  Description

[1647] Reverses the sequence of the elements in the entire one-dimensional System.Array.

[1648] After a call to this method, the element at myArray[i], where i is any index in the array, moves to myArray[j], where j equals (myArray.Length+myArray.GetLowerBound(0))−(i−myArray.GetLowerBound(0))−1. The one-dimensional System.Array to reverse.

[1649] Reverse

• [1650] [C#] public static void Reverse(Array array, int index, int length);
• [1651] [C++] public: static void Reverse(Array* array, int index, int length);
• [1652] [VB] Public Shared Sub Reverse(ByVal array As Array, ByVal index As Integer, ByVal length As Integer)
• [1653] [JScript] public static function Reverse(array: Array, index: int, length: int);
  Description

[1654] Reverses the sequence of the elements in a section of the one-dimensional System.Array.

[1655] After a call to this method, the element at myArray[i], where i is any index in the array, moves to myArray[j], where j equals (myArray.Length+myArray.GetLowerBound(0))−(i−myArray.GetLowerBound(0))−1. The one-dimensional System.Array to reverse. The starting index of the section to reverse. The number of elements in the section to reverse.

[1656] SetValue

• [1657] [C#] public void SetValue(object value, int index);
• [1658] [C++] public: void SetValue(Object* value, int index);
• [1659] [VB] Public Sub SetValue(ByVal value As Object, ByVal index As Integer)
• [1660] [JScript] public function SetValue(value: Object, index: int); Sets the specified System.Array elements to the specified value.
  Description

[1661] Sets a value to the element at the specified position in a one-dimensional System.Array.

[1662] The System.Array.GetLowerBound(System.Int32) and System.Array.GetUpperBound(System.Int32) methods can determine whether the value of index is out of bounds. The new value for the specified element. The position of the System.Array element to set.

[1663] SetValue

• [1664] [C#] public void SetValue(object value, int[ ] indices);
• [1665] [C++] public: void SetValue(Object* value, int indices_gc[ ]);
• [1666] [VB] Public Sub SetValue(ByVal value As Object, ByVal indices( ) As Integer)
• [1667] [JScript] public function SetValue(value: Object, indices: int[ ]);
  Description

[1668] Sets a value to the element at the specified position in a multidimensional System.Array.

[1669] The number of elements in indices must equal the number of dimensions in the System.Array. All elements in the indices array must collectively specify the Is position of the desired element in the multidimensional System.Array. The new value for the specified element. A one-dimensional array of indexes that specifies the position of the element to set.

[1670] SetValue

• [1671] [C#] public void SetValue(object value, int index1, it index2);
• [1672] [C++] public: void SetValue(Object* value, int index1, int index2);
• [1673] [VB] Public Sub SetValue(ByVal value As Object, ByVal index1 As Integer, ByVal index2 As Integer)
• [1674] [JScript] public function SetValue(value: Object, index1: int, index2: int);
  Description

[1675] Sets a value to the element at the specified position in a two-dimensional System.Array.

[1676] The System.Array.GetLowerBound(System.Int32) and System.Array.GetUpperBound(System.Int32) methods can determine whether any of the indexes is out of bounds. The new value for the specified element. The first-dimension index of the System.Array element to set. The second-dimension index of the System.Array element to set.

[1677] SetValue

• [1678] [C#] public void SetValue(object value, int index1, int index2, int index3);
• [1679] [C++] public: void SetValue(Object* value, int index1, int index2, int index3);
• [1680] [VB] Public Sub SetValue(ByVal value As Object, ByVal index1 As Integer, ByVal index2 As Integer, ByVal index3 As Integer)
• [1681] [JScript] public function SetValue(value: Object, index1: int, index2: int, index3 int);
  Description

[1682] Sets a value to the element at the specified position in a three-dimensional System.Array.

[1683] The System.Array.GetLowerBound(System.Int32) and System.Array.GetUpperBound(System.Int32) methods can determine whether any of the indexes is out of bounds. The new value for the specified element. The first-dimension index of the System.Array element to set. The second-dimension index of the System.Array element to set. The third-dimension index of the System.Array element to set.

[1684] Sort

• [1685] [C#] public static void Sort(Array array);
• [1686] [C++] public: static void Sort(Array* array);
• [1687] [VB] Public Shared Sub Sort(ByVal array As Array)
• [1688] [JScript] public static function Sort(array: Array); Sorts the elements in one-dimensional System.Array objects.
  Description

[1689] Sorts the elements in an entire one-dimensional System.Array using the System.IComparable interface implemented by each element of the System.Array.

[1690] Each element of array must implement the System.IComparable interface to be capable of comparisons with every other element in array. The one-dimensional System.Array to sort.

[1691] Sort

• [1692] [C#] public static void Sort(Array keys, Array items);
• [1693] [C++] public: static void Sort(Array* keys, Array* items);
• [1694] [VB] Public Shared Sub Sort(ByVal keys As Array, ByVal items As Array)
• [1695] [JScript] public static function Sort(keys: Array, items: Array);
  Description

[1696] Sorts a pair of one-dimensional System.Array objects (one contains the keys and the other contains the corresponding items) based on the keys in the first System.Array using the System.IComparable interface implemented by each key.

[1697] Each key in the keysSystem.Array has a corresponding item in the itemsSystem.Array. When a key is repositioned during the sorting, the corresponding item in the itemsSystem.Array is similarly repositioned. Therefore, the itemsSystem.Array is sorted according to the arrangement of the corresponding keys in the keysSystem.Array. The one-dimensional System.Array that contains the keys to sort. The one-dimensional System.Array that contains the items that correspond to each of the keys in the keysSystem.Array.

[1698] Sort

• [1699] [C#] public static void Sort(Array array, IComparer comparer);
• [1700] [C++] public: static void Sort(Array* array, IComparer* comparer);
• [1701] [VB] Public Shared Sub Sort(ByVal array As Array, ByVal comparer As IComparer)
• [1702] [JScript] public static function Sort(array: Array, comparer: IComparer);
  Description

[1703] Sorts the elements in a one-dimensional System.Array using the specified System.Collections.IComparer interface.

[1704] If comparer is null, each element of array must implement the System.IComparable interface to be capable of comparisons with every other element in array. The one-dimensional System.Array to sort. The System.Collections.IComparer implementation to use when comparing elements.

[1705] Sort

• [1706] [C#] public static void Sort(Array keys, Array items, IComparer comparer);
• [1707] [C++] public: static void Sort(Array* keys, Array* items, IComparer* comparer);
• [1708] [VB] Public Shared Sub Sort(ByVal keys As Array, ByVal items As Array, ByVal comparer As IComparer)
• [1709] [JScript] public static function Sort(keys: Array, items: Array, comparer: IComparer);
  Description

[1710] Sorts a pair of one-dimensional System.Array objects (one contains the keys and the other contains the corresponding items) based on the keys in the first System.Array using the specified System.Collections.IComparer interface.

[1711] Each key in the keysSystem.Array has a corresponding item in the itemsSystem.Array. When a key is repositioned during the sorting, the corresponding item in the itemsSystem.Array is similarly repositioned. Therefore, the itemsSystem.Array is sorted according to the arrangement of the corresponding keys in the keysSystem.Array. The one-dimensional System.Array that contains the keys to sort. The one-dimensional System.Array that contains the items that correspond to each of the keys in the keysSystem.Array. The System.Collections.IComparer implementation to use when comparing elements.

[1712] Sort

• [1713] [C#] public static void Sort(Array array, int index, int length);
• [1714] [C++] public: static void Sort(Array* array, int index, int length);
• [1715] [VB] Public Shared Sub Sort(ByVal array As Array, ByVal index As Integer, ByVal length As Integer)
• [1716] [JScript] public static function Sort(array: Array, index: int, length: int);
  Description

[1717] Sorts the elements in a section of a one-dimensional System.Array using the System.IComparable interface implemented by each element of the System.Array.

[1718] Each element within the specified section of array must implement the System.IComparable interface to be capable of comparisons with every other element in array. The one-dimensional System.Array to sort. The starting index of the range to sort. The number of elements in the range to sort.

[1719] Sort

• [1720] [C#] public static void Sort(Array keys, Array items, int index, int length);
• [1721] [C++] public: static void Sort(Array* keys, Array* items, int index, int length);
• [1722] [VB] Public Shared Sub Sort(ByVal keys As Array, ByVal items As Array, ByVal index As Integer, ByVal length As Integer)
• [1723] [JScript] public static function Sort(keys: Array, items: Array, index: int, length int);
  Description

[1724] Sorts a section of a pair of one-dimensional System.Array objects (one contains the keys and the other contains the corresponding items) based on the keys in the first System.Array using the System.IComparable interface implemented by each key.

[1725] Each key in the keysSystem.Array has a corresponding item in the itemsSystem.Array. When a key is repositioned during the sorting, the corresponding item in the itemsSystem.Array is similarly repositioned. Therefore, the itemsSystem.Array is sorted according to the arrangement of the corresponding keys in the keysSystem.Array. The one-dimensional System.Array that contains the keys to sort. The one-dimensional System.Array that contains the items that correspond to each of the keys in the keysSystem.Array. The starting index of the range to sort. The number of elements in the range to sort.

[1726] Sort

• [1727] [C#] public static void Sort(Array array, int index, int length, IComparer comparer);
• [1728] [C++] public: static void Sort(Array* array, int index, int length, IComparer* comparer);
• [1729] [VB] Public Shared Sub Sort(ByVal array As Array, ByVal index As Integer, ByVal length As Integer, ByVal comparer As IComparer)
• [1730] [JScript] public static function Sort(array: Array, index: int, length: int, comparer: IComparer);
  Description

[1731] Sorts the elements in a section of a one-dimensional System.Array using the specified System.Collections.IComparer interface.

[1732] If comparer is null, each element within the specified section of array must implement the System.IComparable interface to be capable of comparisons with every other element in array. The one-dimensional System.Array to sort. The starting index of the range to sort. The number of elements in the range to sort. The System.Collections.IComparer implementation to use when comparing elements.

[1733] Sort

• [1734] [C#] public static void Sort(Array keys, Array items, int index, int length, IComparer comparer);
• [1735] [C++] public: static void Sort(Array* keys, Array* items, int index, int length, IComparer* comparer);
• [1736] [VB] Public Shared Sub Sort(ByVal keys As Array, ByVal items As Array, ByVal index As Integer, ByVal length As Integer, ByVal comparer As IComparer)
• [1737] [JScript] public static function Sort(keys: Array, items: Array, index: int, length: int, comparer: IComparer);
  Description

[1738] Sorts a section of a pair of one-dimensional System.Array objects (one contains the keys and the other contains the corresponding items) based on the keys in the first System.Array using the specified System.Collections.IComparer interface.

[1739] Each key in the keysSystem.Array has a corresponding item in the itemsSystem.Array. When a key is repositioned during the sorting, the corresponding item in the itemsSystem.Array is similarly repositioned. Therefore, the itemsSystem.Array is sorted according to the arrangement of the corresponding keys in the keysSystem.Array. The one-dimensional System.Array that contains the keys to sort. The one-dimensional System.Array that contains the items that correspond to each of the keys in the keysSystem.Array. The starting index of the range to sort. The number of elements in the range to sort. The System.Collections.IComparer implementation to use when comparing elements.

[1740] IList.Add

• [1741] [C#] int IList.Add(object value);
• [1742] [C++] int IList::Add(Object* value);
• [1743] [VB] Function Add(ByVal value As Object) As Integer Implements IList.Add
• [1744] [JScript] function IList.Add(value: Object): int;

[1745] IList.Clear

• [1746] [C#] void IList.Clear( );
• [1747] [C++] void IList::Clear( );
• [1748] [VB] Sub Clear( ) Implements IList.Clear
• [1749] [JScript] function IList.Clear( );

[1750] IList.Contains

• [1751] [C#] bool IList.Contains(object value);
• [1752] [C++] bool IList::Contains(Object* value);
• [1753] [VB] Function Contains(ByVal value As Object) As Boolean Implements IList.Contains
• [1754] [JScript] function IList.Contains(value: Object): Boolean;

[1755] IList.IndexOf

• [1756] [C#] int IList.IndexOf(object value);
• [1757] [C++] int IList::IndexOf(Object* value);
• [1758] [VB] Function IndexOf(ByVal value As Object) As Integer Implements IList.IndexOf
• [1759] [JScript] function IList.IndexOf(value: Object): int;

[1760] IList.Insert

• [1761] [C#] void IList.Insert(int index, object value);
• [1762] [C++] void IList::Insert(int index, Object* value);
• [1763] [VB] Sub Insert(ByVal index As Integer, ByVal value As Object) Implements IList.Insert
• [1764] [JScript] function IList.Insert(index: int, value: Object);

[1765] IList.Remove

• [1766] [C#] void IList.Remove(object value);
• [1767] [C++] void IList::Remove(Object* value);
• [1768] [VB] Sub Remove(ByVal value As Object) Implements IList.Remove
• [1769] [JScript] function IList.Remove(value: Object);

[1770] IList.RemoveAt

• [1771] [C#] void IList.RemoveAt(int index);
• [1772] [C++] void IList::RemoveAt(int index);
• [1773] [VB] Sub RemoveAt(ByVal index As Integer) Implements IList.RemoveAt
• [1774] [JScript] function IList.RemoveAt(index: int);

[1775] ArrayTypeMismatchException class (System)

[1776] ToString

Description

[1777] The exception that is thrown when an attempt is made to store an element of the wrong type within an array.

[1778] System.ArrayTypeMismatchException uses the HRESULT COR_E_ARRAYTYPEMISMATCH, which has the value 0x80131503.

[1779] ArrayTypeMismatchException

[1780] Example Syntax:

[1781] ToString

• [1782] [C#] public ArrayTypeMismatchException( );
• [1783] [C++] public: ArrayTypeMismatchException( );
• [1784] [VB] Public Sub New( )
• [1785] [JScript] public function ArrayTypeMismatchException( ); Initializes a new instance of the System.ArrayTypeMismatchException class.
  Description

[1786] Initializes a new instance of the System.ArrayTypeMismatchException class with default properties.

[1787] The following table shows the initial property values for an instance of System.ArrayTypeMismatchException.

[1788] ArrayTypeMismatchException

[1789] Example Syntax:

[1790] ToString

• [1791] [C#] public ArrayTypeMismatchException(string message);
• [1792] [C++] public: ArrayTypeMismatchException(String* message);
• [1793] [VB] Public Sub New(ByVal message As String)
• [1794] [JScript] public function ArrayTypeMismatchException(message: String);
  Description

[1795] Initializes a new instance of the System.ArrayTypeMismatchException class with a specified error message.

[1796] The following table shows the initial property values for an instance of System.ArrayTypeMismatchException. The error message that explains the reason for the exception.

[1797] ArrayTypeMismatchException

[1798] Example Syntax:

[1799] ToString

• [1800] [C#] protected ArrayTypeMismatchException(SerializationInfo info, StreamingContext context);
• [1801] [C++] protected: ArrayTypeMismatchException(SerializationInfo* info, StreamingContext context);
• [1802] [VB] Protected Sub New(ByVal info As SerializationInfo, ByVal context As StreamingContext)
• [1803] [JScript] protected function ArrayTypeMismatchException(info: SerializationInfo, context: StreamingContext);
  Description

[1804] Initializes a new instance of the System.ArrayTypeMismatchException class with serialized data.

[1805] This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. For more information, see. The object that holds the serialized object data. The contextual information about the source or destination.

[1806] ArrayTypeMismatchException

[1807] Example Syntax:

[1808] ToString

• [1809] [C#] public ArrayTypeMismatchException(string message, Exception innerException);
• [1810] [C++] public: ArrayTypeMismatchException(String* message, Exception* innerException);
• [1811] [VB] Public Sub New(ByVal message As String, ByVal innerException As Exception)
• [1812] [JScript] public function ArrayTypeMismatchException(message: String, innerException: Exception);
  Description

[1813] Initializes a new instance of the System.ArrayTypeMismatchException class with a specified error message and a reference to the inner exception that is the root cause of this exception.

[1814] When an ExceptionX is thrown as a direct result of a previous exception Y, the System.Exception.InnerException property of X should contain a reference to Y. The InnerException property returns the same value as was passed into the constructor, or null if the inner exception value was not supplied to the constructor. The error message that explains the reason for the exception. An instance of System.Exception that is the cause of the current Exception. If innerException is non-null, then the current Exception is raised in a catch block handling innerException.

[1815] HelpLink

[1816] HResult

[1817] InnerException

[1818] Message

[1819] Source

[1820] StackTrace

[1821] TargetSite

[1822] AssemblyLoadEventArgs class (System)

[1823] ToString

Description

[1824] Provides data for the System.AppDomain.AssemblyLoad event.

[1825] AssemblyLoadEventArgs

[1826] Example Syntax:

[1827] ToString

• [1828] [C#] public AssemblyLoadEventArgs(Assembly loadedAssembly);
• [1829] [C++] public: AssemblyLoadEventArgs(Assemnbly* loadedAssembly);
• [1830] [VB] Public Sub New(ByVal loadedAssembly As Assembly)
• [1831] [JScript] public function AssemblyLoadEventArgs(loadedAssembly: Assembly);
  Description

[1832] Initializes a new instance of the System.AssemblyLoadEventArgs.AssemblyLoadEventArgs class, using the specified System.Reflection.Assembly object. An instance that represents the currently loaded assembly.

[1833] LoadedAssembly

[1834] ToString

• [1835] [C#] public Assembly LoadedAssembly {get;}
• [1836] [C++] public: _property Assembly* get_LoadedAssembly( );
• [1837] [VB] Public ReadOnly Property LoadedAssembly As Assembly
• [1838] [JScript] public function get LoadedAssembly( ): Assembly;
  Description

[1839] Gets an System.Reflection.Assembly object that represents the currently loaded assembly.

[1840] AssemblyLoadEventHandler delegate (System)

[1841] ToString

Description

[1842] Represents the method that will handle the System.AppDomain.AssemblyLoad event of an System.AppDomain. The source of the event. An System.AssemblyLoadEventArgs that contains the event data.

[1843] AsyncCallback delegate (System)

[1844] ToString

Description

[1845] References the callback method to be called when the asynchronous operation is completed. The result of the asynchronous operation.

[1846] System.AsyncCallback provides a way for client applications to complete an asynchronous operation. This callback delegate is supplied to the client when the asynchronous operation is initiated. The event handler referenced by System.AsyncCallback contains program logic to finish processing the asynchronous task for the client.

[1847] Attribute class (System)

[1848] ToString

Description

[1849] Base class for custom attributes.

[1850] The Attribute class contains convenience methods to access and test custom attributes. While any user-defined type can be used as an attribute, it is expected that most attributes will be instances of types derived from Attribute.

[1851] Attribute

[1852] Example Syntax:

[1853] ToString

• [1854] [C#] protected Attribute( );
• [1855] [C++] protected: Attribute( );
• [1856] [VB] Protected Sub New( )
• [1857] [JScript] protected function Attribute( );
  Description

[1858] Initializes a new instance of the Attribute class.

[1859] TypeId

[1860] ToString

• [1861] [C#] public virtual object TypeId {get;}
• [1862] [C++] public: _property virtual Object* get_TypeId( );
• [1863] [VB] Overridable Public ReadOnly Property TypeId As Object
• [1864] [JScript] public function get TypeId( ): Object;
  Description

[1865] When implemented in a derived class, gets a unique identifier for this Attribute.

[1866] As implemented, this identifier is merely the System.Type of the attribute. However, it is intended that the unique identifier be used to identify two attributes of the same type.

[1867] Equals

• [1868] [C#] public override bool Equals(object obj);
• [1869] [C++] public: bool Equals(Object* obj);
• [1870] [VB] Overrides Public Function Equals(ByVal obj As Object) As Boolean
• [1871] [JScript] public override function Equals(obj: Object): Boolean;
  Description

[1872] Returns a value indicating whether this instance is equal to a specified object.

Return Value: true if obj equals the type and value of this instance; otherwise, false. An System.Object to compare with this instance or null.

[1873] GetCustomAttribute

• [1874] [C#] public static Attribute GetCustomAttribute(Assembly element, Type attributeType);
• [1875] [C++] public: static Attribute* GetCustomAttribute(Assembly* element, Type* attributeType);
• [1876] [VB] Public Shared Function GetCustomAttribute(ByVal element As Assembly, ByVal attributeType As Type) As Attribute
• [1877] [JScript] public static function GetCustomAttribute(element: Assembly, attributeType: Type): Attribute;
  Description

[1878] Retrieves a custom attribute of a specified type applied to a specified assembly and its ancestors.

[1879] Return Value: null, if no custom attribute of type attributeType is applied to element. An object derived from class System.Reflection.Assembly that describes a reusable, versionable, collection of modules. The System.Type object to which the custom attributes are applied. GetCustomAttribute

• [1880] [C#] public static Attribute GetCustomAttribute(MemberInfo element, Type attributeType);
• [1881] [C++] public: static Attribute* GetCustomAttribute(MemberInfo* element, Type* attributeType);
• [1882] [VB] Public Shared Function GetCustomAttribute(ByVal element As MemberInfo, ByVal attributeType As Type) As Attribute
• [1883] [JScript] public static function GetCustomAttribute(element: MemberInfo, attributeType: Type): Attribute;
  Description

[1884] Retrieves a custom attribute of a specified type applied to a specified member of a class and its ancestors.

[1885] Return Value: null, if no custom attribute of type attributeType is applied to element. An object derived from class System.Reflection.MemberInfo that describes a constructor, event, field, method, or property member of a class. The System.Type object to which the custom attributes are applied.

[1886] It GetCustomAttribute

• [1887] [C#] public static Attribute GetCustomAttribute(Module element, Type attributeType);
• [1888] [C++] public: static Attribute* GetCustomAttribute(Module* element, Type* attributeType);
• [1889] [VB] Public Shared Function GetCustomAttribute(ByVal element As Module, ByVal attributeType As Type) As Attribute
• [1890] [JScript] public static function GetCustomAttribute(element: Module, attributeType: Type): Attribute;
  Description

[1891] Retrieves a custom attribute of a specified type applied to a specified module and its ancestors.

Return Value: null, if no custom attribute of type attributeType is applied to element. An object derived from class System.Reflection.Module that describes a portable executable file. The System.Type object to which the custom attributes are applied.

[1892] GetCustomAttribute

• [1893] [C#] public static Attribute GetCustomAttribute(ParameterInfo element, Type attributeType);
• [1894] [C++] public: static Attribute* GetCustomAttribute(ParameterInfo* element, Type* attributeType);
• [1895] [VB] Public Shared Function GetCustomAttribute(ByVal element As ParameterInfo, ByVal attributeType As Type) As Attribute
• [1896] [JScript] public static function GetCustomAttribute(element: ParameterInfo, attributeType: Type): Attribute;
  Description

[1897] Retrieves a custom attribute of a specified type applied to a specified parameter of a member of a class and its ancestors.

[1898] Return Value: null, if no custom attribute of type attributeType is applied to element. An object derived from class System.Reflection.ParameterInfo that describes a parameter of a member of a class. The System.Type object to which the custom attributes are applied.

[1899] GetCustomAttribute

• [1900] [C#] public static Attribute GetCustomAttribute(Assembly element, Type attributeType, bool inherit);
• [1901] [C++] public: static Attribute* GetCustomAttribute(Assembly* element, Type* attributeType, bool inherit);
• [1902] [VB] Public Shared Function GetCustomAttribute(ByVal element As Assembly, ByVal attributeType As Type, ByVal inherit As Boolean) As Attribute
• [1903] [JScript] public static function GetCustomAttribute(element: Assembly, attributeType: Type, inherit: Boolean): Attribute;
  Description

[1904] Retrieves a custom attribute of a specified type applied to a specified assembly and optionally its ancestors.

[1905] Return Value: null, if no custom attribute of type attributeType is applied to element. An object derived from class System.Reflection.Assembly that describes a reusable, versionable, collection of modules. The System.Type object to which the custom attributes are applied. If true, specifies to also search the ancestors of element for custom attributes.

[1906] GetCustomAttribute

• [1907] [C#] public static Attribute GetCustomAttribute(MemberInfo element, Type attributeType, bool inherit);
• [1908] [C++] public: static Attribute* GetCustomAttribute(MemberInfo* element, Type* attributeType, bool inherit);
• [1909] [VB] Public Shared Function GetCustomAttribute(ByVal element As MemberInfo, ByVal attributeType As Type, ByVal inherit As Boolean) As Attribute
• [1910] [JScript] public static function GetCustomAttribute(element: MemberInfo, attributeType: Type, inherit: Boolean): Attribute; Retrieves a custom attribute of a specified type applied to a specified member of a class.
  Description

[1911] Retrieves a custom attribute of a specified type applied to a specified member of a class and optionally its ancestors.

[1912] Return Value: null, if no custom attribute of type attributeType is applied to element. An object derived from class System.Reflection.MemberInfo that describes a constructor, event, field, method, or property member of a class. The System.Type object to which the custom attributes are applied. If true, specifies to also search the ancestors of element for custom attributes.

[1913] GetCustomAttribute

• [1914] [C#] public static Attribute GetCustomAttribute(Module element, Type attributeType, bool inherit);
• [1915] [C++] public: static Attribute* GetCustomAttribute(Module* element, Type* attributeType, bool inherit);
• [1916] [VB] Public Shared Function GetCustomAttribute(ByVal element As Module, ByVal attributeType As Type, ByVal inherit As Boolean) As Attribute
• [1917] [JScript] public static function GetCustomAttribute(element: Module, attributeType: Type, inherit: Boolean): Attribute;
  Description

[1918] Retrieves a custom attribute of a specified type applied to a specified module and optionally its ancestors.

[1919] Return Value: null, if no custom attribute of type attributeType is applied to element. An object derived from class System.Reflection.Module that describes a portable executable file. The System.Type object to which the custom attributes are applied. If true, specifies to also search the ancestors of element for custom attributes.

[1920] GetCustomAttribute

• [1921] [C#] public static Attribute GetCustomAttribute(ParameterInfo element, Type attributeType, bool inherit);
• [1922] [C++] public: static Attribute* GetCustomAttribute(ParameterInfo* element, Type* attributeType, bool inherit);
• [1923] [VB] Public Shared Function GetCustomAttribute(ByVal element As ParameterInfo, ByVal attributeType As Type, ByVal inherit As Boolean) As Attribute
• [1924] [JScript] public static function GetCustomAttribute(element: ParameterInfo, attributeType: Type, inherit: Boolean): Attribute;
  Description

[1925] Retrieves a custom attribute of a specified type applied to a specified parameter of a member of a class and optionally its ancestors.

[1926] Return Value: null, if no custom attribute of type attributeType is applied to element. An object derived from class System.Reflection.ParameterInfo that describes a parameter of a member of a class. The System.Type object to which the custom attributes are applied. If true, specifies to also search the ancestors of element for custom attributes.

[1927] GetCustomAttributes

• [1928] [C#] public static Attribute[ ] GetCustomAttributes(Assembly element);
• [1929] [C++] public: static Attribute* GetCustomAttributes(Assembly* element)[ ]
• [1930] [VB] Public Shared Function GetCustomAttributes(ByVal element As Assembly) As Attribute( )
• [1931] [JScript] public static function GetCustomAttributes(element: Assembly) Attribute[ ];
  Description

[1932] Retrieves an array of the custom attributes of a specified type applied to a specified assembly and its ancestors.

Return Value: An System.Attribute array containing the custom attributes applied to element.—or—An empty array if no such custom attributes exist.

[1933] Return value contains the custom attributes for ancestors of element. An object derived from class System.Reflection.Assembly that describes a reusable, versionable, collection of modules.

[1934] GetCustomAttributes

• [1935] [C#] public static Attribute[ ] GetCustomAttributes(MemberInfo element);
• [1936] [C++] public: static Attribute* GetCustomAttributes(MemberInfo* element)[ ]
• [1937] [VB] Public Shared Function GetCustomAttributes(ByVal element As MemberInfo) As Attribute( )
• [1938] [JScript] public static function GetCustomAttributes(element: MemberInfo): Attribute[ ];
  Description

[1939] Retrieves an array of the custom attributes applied to a specified member of a class and its ancestors.

Return Value: An System.Attribute array containing the custom attributes applied to element.—or—An empty array if no such custom attributes exist.

Return value contains the custom attributes for ancestors of element. An object derived from class System.Reflection.MemberInfo that describes a constructor, event, field, method, or property member of a class.

[1940] GetCustomAttributes

• [1941] [C#] public static Attribute[ ] GetCustomAttributes(Module element);
• [1942] [C++] public: static Attribute* GetCustomAttributes(Module* element)[ ]
• [1943] [VB] Public Shared Function GetCustomAttributes(ByVal element As Module) As Attribute( )
• [1944] [JScript] public static function GetCustomAttributes(element: Module) Attribute[ ];
  Description

[1945] Retrieves an array of the custom attributes of a specified type applied to a specified module and its ancestors.

Return Value: An System.Attribute array containing the custom attributes applied to element.—or—An empty array if no such custom attributes exist.

[1946] Return value contains the custom attributes for ancestors of element. An object derived from class System.Reflection.Module that describes a portable executable file.

[1947] GetCustomAttributes

• [1948] [C#] public static Attribute[ ] GetCustomAttributes(ParameterInfo element);
• [1949] [C++] public: static Attribute* GetCustomAttributes(ParameterInfo* element)]
• [1950] [VB] Public Shared Function GetCustomAttributes(ByVal element As ParameterInfo) As Attribute( )
• [1951] [JScript] public static function GetCustomAttributes(element: ParameterInfo) Attribute[ ];
  Description

[1952] Retrieves an array of the custom attributes of a specified type applied to a specified parameter of a member of a class and its ancestors.

Return Value: An System.Attribute array containing the custom attributes applied to element.—or—An empty array if no such custom attributes exist.

[1953] Return value contains the custom attributes for ancestors of element. An object derived from class System.Reflection.ParameterInfo that describes a parameter of a member of a class.

[1954] GetCustomAttributes

• [1955] [C#] public static Attribute[ ] GetCustomAttributes(Assembly element, bool inherit);
• [1956] [C++] public: static Attribute* GetCustomAttributes(Assembly* element, bool inherit)[ ];
• [1957] [VB] Public Shared Function GetCustomAttributes(ByVal element As Assembly, ByVal inherit As Boolean) As Attribute( )
• [1958] [JScript] public static function GetCustomAttributes(element: Assembly, inherit: Boolean): Attribute[ ];
  Description

[1959] Retrieves an array of the custom attributes of a specified type applied to a specified assembly and optionally its ancestors.

Return Value: An System.Attribute array containing the custom attributes applied to element.—or—An empty array if no such custom attributes exist.

[1960] Return value contains the custom attributes for ancestors of element if inherit is true. An object derived from class System.Reflection.Assembly that describes a reusable, versionable, collection of modules. If true, specifies to also search the ancestors of element for custom attributes.

[1961] GetCustomAttributes

• [1962] [C#] public static Attribute[ ] GetCustomAttributes(Assembly element, Type attributeType);
• [1963] [C++] public: static Attribute* GetCustomAttributes(Assembly* element, Type* attributeType) [ ];
• [1964] [VB] Public Shared Function GetCustomAttributes(ByVal element As Assembly, ByVal attributeType As Type) As Attribute( )
• [1965] [JScript] public static function GetCustomAttributes(element: Assembly, attributeType: Type): Attribute[ ];
  Description

[1966] Retrieves an array of the custom attributes of a specified type applied to a specified assembly and its ancestors.

Return Value: An System.Attribute array containing the custom attributes of type attributeType applied to element.—or—An empty array if no such custom attributes exist.

[1967] Return value contains the custom attributes for ancestors of element. An object derived from class System.Reflection.Assembly that describes a reusable, versionable, collection of modules. The System.Type object to which the custom attributes are applied.

[1968] GetCustomAttributes

• [1969] [C#] public static Attribute[ ] GetCustomAttributes(MemberInfo element, bool inherit);
• [1970] [C++] public: static Attribute* GetCustomAttributes(MemberInfo* element, bool inherit) [ ];
• [1971] [VB] Public Shared Function GetCustomAttributes(ByVal element As MemberInfo, ByVal inherit As Boolean) As Attribute( )
• [1972] [JScript] public static function GetCustomAttributes(element: MemberInfo, inherit: Boolean): Attribute[ ];
  Description

[1973] Retrieves an array of the custom attributes of a specified member of a class and its ancestors.

Return Value: An System.Attribute array containing the custom attributes applied to element.—or—An empty array if no such custom attributes exist.

[1974] Return value contains the custom attributes for ancestors of element if inherit is true. An object derived from class System.Reflection.MemberInfo that describes a constructor, event, field, method, or property member of a class. If true, specifies to also search the ancestors of element for custom attributes.

[1975] GetCustomAttributes

• [1976] [C#] public static Attribute[ ] GetCustomAttributes(MemberInfo element, Type type);
• [1977] [C++] public: static Attribute* GetCustomAttributes(MemberInfo* element, Type* type) [ ];
• [1978] [VB] Public Shared Function GetCustomAttributes(ByVal element As MemberInfo, ByVal type As Type) As Attribute( )
• [1979] [JScript] public static function GetCustomAttributes(element: MemberInfo, type: Type): Attribute[ ]; Retrieves an array of the custom attributes of a specified type applied to a specified member of a class.
  Description

[1980] Retrieves an array of the custom attributes of a specified type applied to a specified member of a class and its ancestors.

Return Value: An System.Attribute array containing the custom attributes of type type applied to element.—or—An empty array if no such custom attributes exist.

[1981] Return value contains the custom attributes for ancestors of element. An object derived from class System.Reflection.MemberInfo that describes a constructor, event, field, method, or property member of a class. The System.Type object to which the custom attributes are applied.

[1982] GetCustomAttributes

• [1983] [C#] public static Attribute[ ] GetCustomAttributes(Module element, bool inherit);
• [1984] [C++] public: static Attribute* GetCustomAttributes(Module* element, bool inherit) [ ];
• [1985] [VB] Public Shared Function GetCustomAttributes(ByVal element As Module, ByVal inherit As Boolean) As Attribute( )
• [1986] [JScript] public static function GetCustomAttributes(element: Module, inherit: Boolean): Attribute[ ];
  Description

[1987] Retrieves an array of the custom attributes of a specified type applied to a specified module and optionally its ancestors.

Return Value: An System.Attribute array containing the custom attributes applied to element.—or—An empty array if no such custom attributes exist.

[1988] Return value contains the custom attributes for ancestors of element if inherit is true. An object derived from class System.Reflection.Module that describes a portable executable file. If true, specifies to also search the ancestors of element for custom attributes.

[1989] GetCustomAttributes

• [1990] [C#] public static Attribute[ ] GetCustomAttributes(Module element, Type attributeType);
• [1991] [C++] public: static Attribute* GetCustomAttributes(Module* element, Type* attributeType) [ ];
• [1992] [VB] Public Shared Function GetCustomAttributes(ByVal element As Module, ByVal attributeType As Type) As Attribute( )
• [1993] [JScript] public static function GetCustomAttributes(element: Module, attributeType: Type): Attribute[ ];
  Description

[1994] Retrieves an array of the custom attributes of a specified type applied to a specified module and its ancestors.

Return Value: An System.Attribute array containing the custom attributes of type attributeType applied to element.—or—An empty array if no such custom attributes exist.

[1995] Return value contains the custom attributes for ancestors of element. An is object derived from class System.Reflection.Module that describes a portable executable file. The System.Type object to which the custom attributes are applied.

[1996] GetCustomAttributes

• [1997] [C#] public static Attribute[ ] GetCustomAttributes(ParameterInfo element, bool inherit);
• [1998] [C++] public: static Attribute* GetCustomAttributes(ParameterInfo* element, bool inherit) [ ];
• [1999] [VB] Public Shared Function GetCustomAttributes(ByVal element As ParameterInfo, ByVal inherit As Boolean) As Attribute( )
• [2000] [JScript] public static function GetCustomAttributes(element: ParameterInfo, inherit: Boolean): Attribute[ ];
  Description

[2001] Retrieves an array of the custom attributes of a specified type applied to a specified parameter of a member of a class and optionally its ancestors.

Return Value: An System.Attribute array containing the custom attributes applied to element.—or—An empty array if no such custom attributes exist.

[2002] Return value contains the custom attributes for ancestors of element if inherit is true. An object derived from class System.Reflection.ParameterInfo that describes a parameter of a member of a class. If true, specifies to also search the ancestors of element for custom attributes.

[2003] GetCustomAttributes

• [2004] [C#] public static Attribute[ ] GetCustomAttributes(ParameterInfo element, Type attributeType);
• [2005] [C++] public: static Attribute* GetCustomAttributes(ParameterInfo* element, Type* attributeType) [ ];
• [2006] [VB] Public Shared Function GetCustomAttributes(ByVal element As ParameterInfo, ByVal attributeType As Type) As Attribute( )
• [2007] [JScript] public static function GetCustomAttributes(element: ParameterInfo, attributeType: Type): Attribute[ ];
  Description

[2008] Retrieves an array of the custom attributes of a specified type applied to a specified parameter of a member of a class and its ancestors.

Return Value: An System.Attribute array containing the custom attributes of type attributeType applied to element.—or—An empty array if no such custom attributes exist.

[2009] Return value contains the custom attributes for ancestors of element. An object derived from class System.Reflection.ParameterInfo that describes a parameter of a member of a class. The System.Type object to which the custom attributes are applied.

[2010] GetCustomAttributes

• [2011] [C#] public static Attribute[ ] GetCustomAttributes(Assembly element, Type attributeType, bool inherit);
• [2012] [C++] public: static Attribute* GetCustomAttributes(Assembly* element, Type* attributeType, bool inherit) [ ];
• [2013] [VB] Public Shared Function GetCustomAttributes(ByVal element As Assembly, ByVal attributeType As Type, ByVal inherit As Boolean) As Attribute( )
• [2014] [JScript] public static function GetCustomAttributes(element: Assembly, attributeType: Type, inherit: Boolean): Attribute[ ];
  Description

[2015] Retrieves an array of the custom attributes of a specified type applied to a specified assembly and optionally its ancestors.

Return Value: An System.Attribute array containing the custom attributes of type attributeType applied to element.—or—An empty array if no such custom attributes exist.

[2016] Return value contains the custom attributes for ancestors of element if inherit is true. An object derived from class System.Reflection.Assembly that describes a reusable, versionable, collection of modules. The System.Type object to which the custom attributes are applied. If true, specifies to also search the ancestors of element for custom attributes.

[2017] GetCustomAttributes

• [2018] [C#] public static Attribute[ ] GetCustomAttributes(MemberInfo element, Type type, bool inherit);
• [2019] [C++] public: static Attribute* GetCustomAttributes(MemberInfo* element, Type* type, bool inherit) [ ];
• [2020] [VB] Public Shared Function GetCustomAttributes(ByVal element As MemberInfo, ByVal type As Type, ByVal inherit As Boolean) As Attribute( )
• [2021] [JScript] public static function GetCustomAttributes(element: MemberInfo, type: Type, inherit: Boolean): Attribute[ ];
  Description

[2022] Retrieves an array of the custom attributes of a specified type applied to a specified member of a class and optionally its ancestors.

Return Value: An System.Attribute array containing the custom attributes of type type applied to element.—or—An empty array if no such custom attributes exist.

[2023] Return value contains the custom attributes for ancestors of element if inherit is true. An object derived from class System.Reflection.MemberInfo that describes a constructor, event, field, method, or property member of a class. The System.Type object to which the custom attributes are applied. If true, specifies to also search the ancestors of element for custom attributes.

[2024] GetCustomAttributes

• [2025] [C#] public static Attribute[ ] GetCustomAttributes(Module element, Type attributeType, bool inherit);
• [2026] [C++] public: static Attribute* GetCustomAttributes(Module* element, Type* attributeType, bool inherit) [ ];
• [2027] [VB] Public Shared Function GetCustomAttributes(ByVal element As Module, ByVal attributeType As Type, ByVal inherit As Boolean) As Attribute( )
• [2028] [JScript] public static function GetCustomAttributes(element: Module, attributeType: Type, inherit: Boolean): Attribute[ ];
  Description

[2029] Retrieves an array of the custom attributes of a specified type applied to a specified module and optionally its ancestors.

Return Value: An System.Attribute array containing the custom attributes of type attributeType applied to element.—or—An empty array if no such custom attributes exist.

[2030] Return value contains the custom attributes for ancestors of element if inherit is true. An object derived from class System.Reflection.Module that describes a portable executable file. The System.Type object to which the custom attributes are applied. If true, specifies to also search the ancestors of element for custom attributes.

[2031] GetCustomAttributes

• [2032] [C#] public static Attribute[ ] GetCustomAttributes(ParameterInfo element, Type attributeType, bool inherit);
• [2033] [C++] public: static Attribute* GetCustomAttributes(ParameterInfo* element, Type* attributeType, bool inherit) [ ];
• [2034] [VB] Public Shared Function GetCustomAttributes(ByVal element As ParameterInfo, ByVal attributeType As Type, ByVal inherit As Boolean) As Attribute( )
• [2035] [JScript] public static function GetCustomAttributes(element: ParameterInfo, attributeType: Type, inherit: Boolean): Attribute[ ];
  Description

[2036] Retrieves an array of the custom attributes of a specified type applied to a specified parameter of a member of a class and optionally its ancestors.

Return Value: An System.Attribute array containing the custom attributes of type attributeType applied to element.—or—An empty array if no such custom attributes exist.

[2037] Return value contains the custom attributes for ancestors of element if inherit is true. An object derived from class System.Reflection.ParameterInfo that describes a parameter of a member of a class. The System.Type object to which the custom attributes are applied. If true, specifies to also search the ancestors of element for custom attributes.

[2038] GetHashCode

• [2039] [C#] public override int GetHashCode( );
• [2040] [C++] public: int GetHashCode( );
• [2041] [VB] Overrides Public Function GetHashCode( ) As Integer
• [2042] [JScript] public override function GetHashCode( ): int;
  Description

[2043] Returns the hash code for this instance.

Return Value: A 32-bit signed integer hash code.

[2044] IsDefaultAttribute

• [2045] [C#] public virtual bool IsDefaultAttribute( );
• [2046] [C++] public: virtual bool IsDefaultAttribute( );
• [2047] [VB] Overridable Public Function IsDefaultAttribute( ) As Boolean
• [2048] [JScript] public function IsDefaultAttribute( ): Boolean;
  Description

[2049] When overridden in a derived class, returns an indication whether the value of this instance is the default value for the derived class.

Return Value: true if this instance is the default attribute for the class; otherwise, false.

[2050] The default implementation of this class returns false, and must be implemented in the derived class to be useful to that class.

[2051] IsDefined

• [2052] [C#] public static bool IsDefined(Assembly element, Type attributeType);
• [2053] [C++] public: static bool IsDefined(Assembly* element, Type* attributeType);
• [2054] [VB] Public Shared Function IsDefined(ByVal element As Assembly, ByVal attributeType As Type) As Boolean
• [2055] [JScript] public static function IsDefined(element: Assembly, attributeType Type): Boolean;
  Description

[2056] Determines whether any custom attributes of a specified type are applied to a specified assembly.

Return Value: true if a custom attribute of type attributeType is applied to element; otherwise, false.

[2057] The ancestors of element are not searched for custom attributes. An object derived from class System.Reflection.Assembly that describes a reusable, versionable, collection of modules. The System.Type object to which the custom attributes are applied.

[2058] IsDefined

• [2059] [C#] public static bool IsDefined(MemberInfo element, Type attributeType);
• [2060] [C++] public: static bool IsDefined(MemberInfo* element, Type* attributeType);
• [2061] [VB] Public Shared Function IsDefined(ByVal element As MemberInfo, ByVal attributeType As Type) As Boolean
• [2062] [JScript] public static function IsDefined(element: MemberInfo, attributeType: Type): Boolean; Determines whether any custom attributes of a specified type are applied to a specified member of a class.
  Description

[2063] Determines whether any custom attributes of a specified type are applied to a specified member of a class and its ancestors.

Return Value: true if a custom attribute of type attributeType is applied to element; otherwise, false.

[2064] The ancestors of element are searched for custom attributes if element is a method or a type. An object derived from class System.Reflection.MemberInfo that describes a constructor, event, field, method, type, or property member of a class. The System.Type object to which the custom attributes are applied.

[2065] IsDefined

• [2066] [C#] public static bool IsDefined(Module element, Type attributeType);
• [2067] [C++] public: static bool IsDefined(Module* element, Type* attributeType);
• [2068] [VB] Public Shared Function IsDefined(ByVal element As Module, ByVal attributeType As Type) As Boolean
• [2069] [JScript] public static function IsDefined(element: Module, attributeType: Type): Boolean;
  Description

[2070] Determines whether any custom attributes of a specified type are applied to a specified module.

Return Value: true if a custom attribute of type attributeType is applied to element; otherwise, false.

[2071] The ancestors of element are not searched for custom attributes. An object derived from class System.Reflection.Module that describes a portable executable file. The System.Type object to which the custom attributes are applied.

[2072] IsDefined

• [2073] [C#] public static bool IsDefined(ParameterInfo element, Type attributeType);
• [2074] [C++] public: static bool IsDefined(ParameterInfo* element, Type* attributeType);
• [2075] [VB] Public Shared Function IsDefined(ByVal element As ParameterInfo, ByVal attributeType As Type) As Boolean
• [2076] [JScript] public static function IsDefined(element: ParameterInfo, attributeType: Type): Boolean;
  Description

[2077] Determines whether any custom attributes of a specified type are applied to a specified parameter of a member of a class and its ancestors.

Return Value: true if a custom attribute of type attributeType is applied to element; otherwise, false.

[2078] The ancestors of element are searched for custom attributes. An object derived from class System.Reflection.ParameterInfo that describes a parameter of a member of a class. The System.Type object to which the custom attributes are applied.

[2079] IsDefined

• [2080] [C#] public static bool IsDefined(Assembly element, Type attributeType, bool inherit);
• [2081] [C++] public: static bool IsDefined(Assembly* element, Type* attributeType, bool inherit);
• [2082] [VB] Public Shared Function IsDefined(ByVal element As Assembly, ByVal attributeType As Type, ByVal inherit As Boolean) As Boolean
• [2083] [JScript] public static function IsDefined(element: Assembly, attributeType: Type, inherit: Boolean): Boolean;
  Description

[2084] Determines whether any custom attributes of a specified type are applied to a specified assembly.

Return Value: true if a custom attribute of type attributeType is applied to element; otherwise, false.

[2085] This method ignores the value of parameter inherit. The ancestors of element are not searched for custom attributes. An object derived from class System.Reflection.Assembly that describes a reusable, versionable, collection of modules. The System.Type object to which the custom attributes are applied. If true, specifies to also search the ancestors of element for custom attributes.

[2086] IsDefined

• [2087] [C#] public static bool IsDefined(MemberInfo element, Type attributeType, bool inherit);
• [2088] [C++] public: static bool IsDefined(MemberInfo* element, Type* attributeType, bool inherit);
• [2089] [VB] Public Shared Function IsDefined(ByVal element As MemberInfo, ByVal attributeType As Type, ByVal inherit As Boolean) As Boolean
• [2090] [JScript] public static function IsDefined(element: MemberInfo, attributeType: Type, inherit: Boolean): Boolean;
  Description

[2091] Determines whether any custom attributes of a specified type are applied to a specified member of a class and optionally its ancestors.

Return Value: true if a custom attribute of type attributeType is applied to element otherwise, false.

[2092] The ancestors of element are searched for custom attributes if inherit is true and element is a method or a type. An object derived from class System.Reflection.MemberInfo that describes a constructor, event, field, method, type, or property member of a class. The System.Type object to which the custom attributes are applied. If true, specifies to also search the ancestors of element for custom attributes.

[2093] IsDefined

• [2094] [C#] public static bool IsDefined(Module element, Type attributeType, bool inherit);
• [2095] [C++] public: static bool IsDefined(Module* element, Type* attributeType, bool inherit);
• [2096] [VB] Public Shared Function IsDefined(ByVal element As Module, ByVal attributeType As Type, ByVal inherit As Boolean) As Boolean
• [2097] [JScript] public static function IsDefined(element: Module, attributeType: Type, inherit: Boolean): Boolean;
  Description

[2098] Determines whether any custom attributes of a specified type are applied to a specified module.

Return Value: true if a custom attribute of type attributeType is applied to element; otherwise, false.

[2099] This method ignores the value of parameter inherit. The ancestors of element are not searched for custom attributes. An object derived from class System.Reflection.Module that describes a portable executable file. The System.Type object to which the custom attributes are applied. If true, specifies to also search the ancestors of element for custom attributes.

[2100] IsDefined

• [2101] [C#] public static bool IsDefined(ParameterInfo element, Type attributeType, bool inherit);
• [2102] [C++] public: static bool IsDefined(ParameterInfo* element, Type* attributeType, bool inherit);
• [2103] [VB] Public Shared Function IsDefined(ByVal element As ParameterInfo, ByVal attributeType As Type, ByVal inherit As Boolean) As Boolean
• [2104] [JScript] public static function IsDefined(element: ParameterInfo, attributeType Type, inherit: Boolean): Boolean;
  Description

[2105] Determines whether any custom attributes of a specified type are applied to a specified parameter of a member of a class and optionally its ancestors.

Return Value: true if a custom attribute of type attributeType is applied to element; otherwise, false.

[2106] The ancestors of element are searched for custom attributes if inherit is true and element is a method. An object derived from class System.Reflection.ParameterInfo that describes a parameter of a member of a class. The System.Type object to which the custom attributes are applied. If true, specifies to also search the ancestors of element for custom attributes.

[2107] Match

• [2108] [C#] public virtual bool Match(object obj);
• [2109] [C++] public: virtual bool Match(Object* obj);
• [2110] [VB] Overridable Public Function Match(ByVal obj As Object) As Boolean
• [2111] [JScript] public function Match(obj: Object): Boolean;
  Description

[2112] When overridden in a derived class, returns a value indicating whether this instance equals a specified object.

Return Value: true if this instance equals obj; otherwise, false.

[2113] This method determines if one Attribute equals another. Its default implementation is the same as System.Attribute.Equals(System.Object), which performs a value and reference comparison. Override this method to implement support for attribute values, such as flags or bitfields, that consist of components that are meaningful in themselves. An System.Object to compare with this instance of Attribute.

[2114] AttributeTargets enumeration (System)

[2115] ToString

Description

[2116] Specifies the elements to which it is valid to apply an attribute.

[2117] AttributeTargets enumeration values can be combined with a bitwise OR operation to get the desired combination.

[2118] ToString

• [2119] [C#] public const AttributeTargets All;
• [2120] [C++] public: const AttributeTargets All;
• [2121] [VB] Public Const All As AttributeTargets
• [2122] [JScript] public var All: AttributeTargets;
  Description

[2123] Attribute can be applied to any element.

[2124] ToString

• [2125] [C#] public const AttributeTargets Assembly;
• [2126] [C++] public: const AttributeTargets Assembly;
• [2127] [VB] Public Const Assembly As AttributeTargets
• [2128] [JScript] public var Assembly: AttributeTargets;
  Description

[2129] Attribute can be applied to an assembly.

[2130] ToString

• [2131] [C#] public const AttributeTargets Class;
• [2132] [C++] public: const AttributeTargets Class;
• [2133] [VB] Public Const Class As AttributeTargets
• [2134] [JScript] public var Class: AttributeTargets;
  Description

[2135] Attribute can be applied to a class.

[2136] ToString

• [2137] [C#] public const AttributeTargets Constructor;
• [2138] [C++] public: const AttributeTargets Constructor;
• [2139] [VB] Public Const Constructor As AttributeTargets
• [2140] [JScript] public var Constructor: AttributeTargets;
  Description

[2141] Attribute can be applied to a constructor.

[2142] ToString

• [2143] [C#] public const AttributeTargets Delegate;
• [2144] [C++] public: const AttributeTargets Delegate;
• [2145] [VB] Public Const Delegate As AttributeTargets
• [2146] [JScript] public var Delegate: AttributeTargets;
  Description

[2147] Attribute can be applied to a delegate.

[2148] ToString

• [2149] [C#] public const AttributeTargets Enum;
• [2150] [C++] public: const AttributeTargets Enum;
• [2151] [VB] Public Const Enum As AttributeTargets
• [2152] [JScript] public var Enum: AttributeTargets;
  Description

[2153] Attribute can be applied to an enumeration.

[2154] ToString

• [2155] [C#] public const AttributeTargets Event;
• [2156] [C++] public: const AttributeTargets Event;
• [2157] [VB] Public Const Event As AttributeTargets
• [2158] [JScript] public var Event: AttributeTargets;
  Description

[2159] Attribute can be applied to an event.

[2160] ToString

• [2161] [C#] public const AttributeTargets Field;
• [2162] [C++] public: const AttributeTargets Field;
• [2163] [VB] Public Const Field As AttributeTargets
• [2164] [JScript] public var Field: AttributeTargets;
  Description

[2165] Attribute can be applied to a field.

[2166] ToString

• [2167] [C#] public const AttributeTargets Interface;
• [2168] [C++] public: const AttributeTargets Interface;
• [2169] [VB] Public Const Interface As AttributeTargets
• [2170] [JScript] public var Interface: AttributeTargets;
  Description

[2171] Attribute can be applied to an interface.

[2172] ToString

• [2173] [C#] public const AttributeTargets Method;
• [2174] [C++] public: const AttributeTargets Method;
• [2175] [VB] Public Const Method As AttributeTargets
• [2176] [JScript] public var Method: AttributeTargets;
  Description

[2177] Attribute can be applied to a method.

[2178] ToString

• [2179] [C#] public const AttributeTargets Module;
• [2180] [C++] public: const AttributeTargets Module;
• [2181] [VB] Public Const Module As AttributeTargets
• [2182] [JScript] public var Module: AttributeTargets;
  Description

[2183] Attribute can be applied to a module.

[2184] ToString

• [2185] [C#] public const AttributeTargets Parameter;
• [2186] [C++] public: const AttributeTargets Parameter;
• [2187] [VB] Public Const Parameter As AttributeTargets
• [2188] [JScript] public var Parameter: AttributeTargets;
  Description

[2189] Attribute can be applied to a parameter.

[2190] ToString

• [2191] [C#] public const AttributeTargets Property;
• [2192] [C++] public: const AttributeTargets Property;
• [2193] [VB] Public Const Property As AttributeTargets
• [2194] [JScript] public var Property: AttributeTargets;
  Description

[2195] Attribute can be applied to a property.

[2196] ToString

• [2197] [C#] public const AttributeTargets ReturnValue;
• [2198] [C++] public: const AttributeTargets ReturnValue;
• [2199] [VB] Public Const ReturnValue As AttributeTargets
• [2200] [JScript] public var ReturnValue: AttributeTargets;
  Description

[2201] Attribute can be applied to a Return value.

[2202] ToString

• [2203] [C#] public const AttributeTargets Struct;
• [2204] [C++] public: const AttributeTargets Struct;
• [2205] [VB] Public Const Struct As AttributeTargets
• [2206] [JScript] public var Struct: AttributeTargets;
  Description

[2207] Attribute can be applied to a value type.

AttributeUsageAttribute class (System)

[2208] ToString

Description

[2209] Specifies the usage of another attribute class. This class cannot be inherited.

[2210] When you are defining your own attribute class, you can control the manner in which it is used by placing an System.AttributeUsageAttribute on your attribute class. The indicated attribute class must derive from System.Attribute, either directly or indirectly.

[2211] AttributeUsageAttribute

[2212] Example Syntax:

[2213] ToString

• [2214] [C#] public AttributeUsageAttribute(AttributeTargets validOn);
• [2215] [C++] public: AttributeUsageAttribute(AttributeTargets validOn);
• [2216] [VB] Public Sub New(ByVal validOn As AttributeTargets)
• [2217] [JScript] public function AttributeUsageAttribute(validOn: AttributeTargets);
  Description

[2218] Initializes a new instance of the System.AttributeUsageAttribute class with the specified list of System.AttributeTargets, the System.AttributeUsageAttribute.AllowMultiple value, and the System.AttributeUsageAttribute.Inherited value.

[2219] You can combine several System.AttributeTargets values using a bitwise OR operation to get the desired combination of valid program elements. The set of values combined using a bitwise OR operation to indicate which program elements are valid.

[2220] AllowMultiple

[2221] ToString

• [2222] [C#] public bool AllowMultiple {get; set;}
• [2223] [C++] public: _property bool get_AllowMultiple( );public: _property void set_AllowMultiple(bool);
• [2224] [VB] Public Property AllowMultiple As Boolean
• [2225] [JScript] public function get AllowMultiple( ): Boolean;public function set AllowMultiple(Boolean);
  Description

[2226] Gets or sets a Boolean value indicating whether more than one instances of the indicated attribute can be specified for a single program element.

[2227] An attribute that can be specified more than once for a program element is called a multi-use attribute. An attribute that can be specified only once is called a single-use attribute.

[2228] Inherited

[2229] ToString

• [2230] [C#] public bool Inherited {get; set;}
• [2231] [C++] public: _property bool get_Inherited( );public: _property void set_Inherited(bool);
• [2232] [VB] Public Property Inherited As Boolean
• [2233] [JScript] public function get Inherited( ): Boolean;public function set Inherited(Boolean);
  Description

[2234] Gets or sets a Boolean value indicating whether the indicated attribute is inherited by derived classes or overridden members.

[2235] TypeId

[2236] ValidOn

[2237] ToString

Description

[2238] Gets a set of values identifying which program elements that the indicated attribute can be applied to.

[2239] BadImageFormatException class (System)

[2240] ToString

Description

[2241] The exception that is thrown when the file image of a DLL or an executable program is invalid.

[2242] System.BadImageFormatException uses the HRESULT COR_E_BADIMAGEFORMAT, which has the value 0x8007000B.

[2243] BadImageFormatException

[2244] Example Syntax:

[2245] ToString

• [2246] [C#] public BadImageFormatException( );
• [2247] [C++] public: BadImageFormatException( );
• [2248] [VB] Public Sub New( )
• [2249] [JScript] public function BadImageFormatException( ); Initializes a new instance of the System.BadImageFormatException class.
  Description

[2250] Initializes a new instance of the System.BadImageFormatException class with default properties.

[2251] The following table shows the initial property values for an instance of System.BadImageFormatException.

[2252] BadImageFormatException

[2253] Example Syntax:

[2254] ToString

• [2255] [C#] public BadImageFormatException(string message);
• [2256] [C++] public: BadImageFormatException(String* message);
• [2257] [VB] Public Sub New(ByVal message As String)
• [2258] [JScript] public function BadImageFormatException(message: String);
  Description

[2259] Initializes a new instance of the System.BadImageFormatException class with a specified error message.

[2260] The following table shows the initial property values for an instance of System.BadImageFormatException. The error message that explains the reason for the exception.

[2261] BadImageFormatException

[2262] Example Syntax:

[2263] ToString

• [2264] [C#] protected BadImageFormatException(SerializationInfo info, StreamingContext context);
• [2265] [C++] protected: BadImageFormatException(SerializationInfo* info, StreamingContext context);
• [2266] [VB] Protected Sub New(ByVal info As SerializationInfo, ByVal context As StreamingContext)
• [2267] [JScript] protected function BadImageFormatException(info: SerializationInfo, context: StreamingContext);
  Description

[2268] Initializes a new instance of the System.BadImageFormatException class with serialized data.

[2269] This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. For more information, see. The object that holds the serialized object data. The contextual information about the source or destination.

[2270] BadImageFormatException

[2271] Example Syntax:

[2272] ToString

• [2273] [C#] public BadImageFormatException(string message, Exception inner);
• [2274] [C++] public: BadImageFormatException(String* message, Exception* inner);
• [2275] [VB] Public Sub New(ByVal message As String, ByVal inner As Exception)
• [2276] [JScript] public function BadImageFormatException(message: String, inner: Exception);
  Description

[2277] Initializes a new instance of the System.BadImageFormatException class with a specified error message and a reference to the inner exception that is the root cause of this exception.

[2278] When an ExceptionX is thrown as a direct result of a previous exception Y, the System.Exception.InnerException property of X should contain a reference to Y. The InnerException property returns the same value as was passed into the constructor, or null if the inner exception value was not supplied to the constructor. The error message that explains the reason for the exception. An instance of System.Exception that is the cause of the current Exception. If inner is non-null, then the current Exception is raised in a catch block handling inner.

[2279] BadImageFormatException

[2280] Example Syntax:

[2281] ToString

• [2282] [C#] public BadImageFormatException(string message, string fileName);
• [2283] [C++] public: BadImageFormatException(String* message, String* filename);
• [2284] [VB] Public Sub New(ByVal message As String, ByVal fileName As String)
• [2285] [JScript] public function BadImageFormatException(message: String, fileName: String);
  Description

[2286] Initializes a new instance of the System.BadImageFormatException class with serialized data.

[2287] This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. For more information, see. A reference to the inner exception.

[2288] BadImageFormatException

[2289] Example Syntax:

[2290] ToString

• [2291] [C#] public BadImageFormatException(string message, string fileName, Exception inner);
• [2292] [C++] public: BadImageFormatException(String* message, String* fileName, Exception* inner);
• [2293] [VB] Public Sub New(ByVal message As String, ByVal fileName As String, ByVal inner As Exception)
• [2294] [JScript] public function BadImageFormatException(message: String, fileName: String, inner: Exception);
  Description

[2295] Initializes a new instance of the System.BadImageFormatException class with a specified error message and a reference to the inner exception that is the root cause of this exception.

[2296] When an ExceptionX is thrown as a direct result of a previous exception Y, the System.Exception.InnerException property of X should contain a reference to Y. The InnerException property returns the same value as was passed into the constructor, or null if the inner exception value was not supplied to the constructor. The error message that explains the reason for the exception. An instance of System.Exception that is the cause of the current Exception. If inner is non-null, then the current Exception is raised in a catch block handling inner.

[2297] FileName

[2298] ToString

• [2299] [C#] public string FileName {get;}
• [2300] [C++] public: _property String* get_FileName( );
• [2301] [VB] Public ReadOnly Property FileName As String
• [2302] [JScript] public function get FileName( ): String;
  Description

[2303] Gets the name of the file that causes this exception.

[2304] FusionLog

[2305] ToString

• [2306] [C#] public string FusionLog {get;}
• [2307] [C++] public: _property String* get_FusionLog( );
• [2308] [VB] Public ReadOnly Property FusionLog As String
• [2309] [JScript] public function get FusionLog( ): String;
  Description

[2310] Gets the log file that describes why loading of an assembly failed.

[2311] HelpLink

[2312] HResult

[2313] InnerException

[2314] Message

[2315] ToString

Description

[2316] Gets the error message and the name of the file that caused this exception.

[2317] Source

[2318] StackTrace

[2319] TargetSite

[2320] GetObjectData

• [2321] [C#] public override void GetObjectData(SerializationInfo info, StreamingContext context);
• [2322] [C++] public: void GetObjectData(SerializationInfo* info, StreamingContext context);
• [2323] [VB] Overrides Public Sub GetObjectData(ByVal info As SerializationInfo, ByVal context As StreamingContext)
• [2324] [JScript] public override function GetObjectData(info: SerializationInfo, context: StreamingContext);
  Description

[2325] Sets the System.Runtime.Serialization.SerializationInfo object with the file name, fusion log, and additional exception information.

[2326] ToString

• [2327] [C#] public override string ToString( );
• [2328] [C++] public: String* ToString( );
• [2329] [VB] Overrides Public Function ToString( ) As String
• [2330] [JScript] public override function ToString( ): String;
  Description

[2331] Returns the fully qualified name of this exception and possibly the error message, the name of the inner exception, and the stack trace.

Return Value: A string containing the fully qualified name of this exception and possibly the error message, the name of the inner exception, and the stack trace.

[2332] BitConverter class (System)

[2333] ToString

Description

[2334] Converts base data types to an array of bytes, and an array of bytes to base data types.

[2335] This class facilitates manipulating value types in their fundamental form. A byte is defined as an 8-bit unsigned integer.

[2336] ToString

• [2337] [C#] public static readonly bool IsLittleEndian;
• [2338] [C++] public: static bool IsLittleEndian;
• [2339] [VB] Public Shared ReadOnly IsLittleEndian As Boolean
• [2340] [JScript] public static var IsLittleEndian: Boolean;
  Description

[2341] Indicates the byte order (“endianess”) in which data is stored in this computer architecture.

[2342] This value is true if the architecture is little-endian; false if it is big-endian.

[2343] DoubleToInt64 Bits

• [2344] [C#] public static long DoubleToInt64 Bits(double value);
• [2345] [C++] public: static _int64 DoubleToInt64 Bits(double value);
• [2346] [VB] Public Shared Function DoubleToInt64 Bits(ByVal value As Double) As Long
• [2347] [JScript] public static function DoubleToInt64 Bits(value: double): long;
  Description

[2348] Converts the specified double-precision floating point number to a 64-bit signed integer.

Return Value: A 64-bit signed integer whose value is equivalent to value. The number to convert.

[2349] GetBytes

• [2350] [C#] public static byte[ ] GetBytes(bool value);
• [2351] [C++] public: static unsigned char GetBytes(bool value) _gc[ ];
• [2352] [VB] Public Shared Function GetBytes(ByVal value As Boolean) As Byte( )
• [2353] [JScript] public static function GetBytes(value: Boolean): Byte[ ]; Converts the specified data to an array of bytes.
  Description

[2354] Returns the specified Boolean value as an array of bytes.

Return Value: An array of bytes with length 1. A Boolean value.

[2355] GetBytes

• [2356] [C#] public static byte[ ] GetBytes(char value);
• [2357] [C++] public: static unsigned char GetBytes(_wchar_t value) _gc[ ];
• [2358] [VB] Public Shared Function GetBytes(ByVal value As Char) As Byte( )
• [2359] [JScript] public static function GetBytes(value: Char): Byte [ ];
  Description

[2360] Returns the specified Unicode character value as an array of bytes.

Return Value: An array of bytes with length 2. A character to convert.

[2361] GetBytes

• [2362] [C#] public static byte[ ] GetBytes(double value);
• [2363] [C++] public: static unsigned char GetBytes(double value) _gc[ ];
• [2364] [VB] Public Shared Function GetBytes(ByVal value As Double) As Byte( )
• [2365] [JScript] public static function GetBytes(value: double): Byte[ ];
  Description

[2366] Returns the specified double-precision floating point value as an array of bytes.

Return Value: An array of bytes with length 8. The number to convert.

[2367] GetBytes

• [2368] [C#] public static byte[ ] GetBytes(short value);
• [2369] [C++] public: static unsigned char GetBytes(short value) _gc[ ];
• [2370] [VB] Public Shared Function GetBytes(ByVal value As Short) As Byte( )
• [2371] [JScript] public static function GetBytes(value: Int16): Byte[ ];
  Description

[2372] Returns the specified 16-bit signed integer value as an array of bytes.

Return Value: An array of bytes with length 2. The number to convert.

[2373] GetBytes

• [2374] [C#] public static byte[ ] GetBytes(int value);
• [2375] [C++] public: static unsigned char GetBytes(int value) _gc[ ];
• [2376] [VB] Public Shared Function GetBytes(ByVal value As Integer) As Byte( )
• [2377] [JScript] public static function GetBytes(value: int): Byte[ ];
  Description

[2378] Returns the specified 32-bit signed integer value as an array of bytes.

Return Value: An array of bytes with length 4. The number to convert.

[2379] GetBytes

• [2380] [C#] public static byte[ ] GetBytes(long value);
• [2381] [C++] public: static unsigned char GetBytes(_int64 value) _gc[ ];
• [2382] [VB] Public Shared Function GetBytes(ByVal value As Long) As Byte( )
• [2383] [JScript] public static function GetBytes(value: long): Byte[ ];
  Description

[2384] Returns the specified 64-bit signed integer value as an array of bytes.

Return Value: An array of bytes with length 8. The number to convert.

[2385] GetBytes

• [2386] [C#] public static byte[ ] GetBytes(float value);
• [2387] [C++] public: static unsigned char GetBytes(float value) _gc[ ];
• [2388] [VB] Public Shared Function GetBytes(ByVal value As Single) As Byte( )
• [2389] [JScript] public static function GetBytes(value: float): Byte[ ];
  Description

[2390] Returns the specified single-precision floating point value as an array of bytes.

Return Value: An array of bytes with length 4. The number to convert.

[2391] GetBytes

• [2392] [C#] public static byte[ ] GetBytes(ushort value);
• [2393] [C++] public: static unsigned char GetBytes(unsigned short value) _gc[ ];
• [2394] [VB] Public Shared Function GetBytes(ByVal value As UInt16) As Byte( )
• [2395] [JScript] public static function GetBytes(value: UInt16): Byte[ ];
  Description

[2396] Returns the specified 16-bit unsigned integer value as an array of bytes.

Return Value: An array of bytes with length 2. The number to convert.

[2397] GetBytes

• [2398] [C#] public static byte[ ] GetBytes(uint value);
• [2399] [C++] public: static unsigned char GetBytes(unsigned int value) _gc[ ];
• [2400] [VB] Public Shared Function GetBytes(ByVal value As UInt32) As Byte( )
• [2401] [JScript] public static function GetBytes(value: UInt32): Byte[ ];
  Description

[2402] Returns the specified 32-bit unsigned integer value as an array of bytes.

Return Value: An array of bytes with length 4. The number to convert.

[2403] GetBytes

• [2404] [C#] public static byte[ ] GetBytes(ulong value);
• [2405] [C++] public: static unsigned char GetBytes(unsigned _int64 value) _gc[ ];
• [2406] [VB] Public Shared Function GetBytes(ByVal value As UInt64) As Byte( )
• [2407] [JScript] public static function GetBytes(value: UInt64): Byte[ ];
  Description

[2408] Returns the specified 64-bit unsigned integer value as an array of bytes.

Return Value: An array of bytes with length 8. The number to convert.

[2409] Int64 BitsToDouble

• [2410] [C#] public static double Int64 BitsToDouble(long value);
• [2411] [C++] public: static double Int64 BitsToDouble(_int64 value);
• [2412] [VB] Public Shared Function Int64 BitsToDouble(ByVal value As Long) As Double
• [2413] [JScript] public static function Int64 BitsToDouble(value: long): double;
  Description

[2414] Converts the specified 64-bit signed integer to a double-precision floating point number.

Return Value: A double-precision floating point number whose value is equivalent to value. The number to convert.

[2415] ToBoolean

• [2416] [C#] public static bool ToBoolean(byte[ ] value, int startIndex);
• [2417] [C++] public: static bool ToBoolean(unsigned char value _gc[ ], int startIndex);
• [2418] [VB] Public Shared Function ToBoolean(ByVal value( ) As Byte, ByVal startIndex As Integer) As Boolean
• [2419] [JScript] public static function ToBoolean(value: Byte[ ], startIndex: int) Boolean;
  Description

[2420] Returns a Boolean value converted from one byte at a specified position in a byte array.

Return Value: true if the byte at startIndex in value is nonzero; otherwise, false. An array of bytes. The starting position within value.

[2421] ToChar

• [2422] [C#] public static char ToChar(byte[ ] value, int startIndex);
• [2423] [C++] public: static _wchar_t ToChar(unsigned char value _gc[ ], int startIndex);
• [2424] [VB] Public Shared Function ToChar(ByVal value( ) As Byte, ByVal startIndex As Integer) As Char
• [2425] [JScript] public static function ToChar(value: Byte[ ], startIndex: int): Char;
  Description

[2426] Returns a Unicode character converted from two bytes at a specified position in a byte array.

Return Value: A character formed by two bytes beginning at startIndex. An array. The starting position within value.

[2427] ToDouble

• [2428] [C#] public static double ToDouble(byte[ ] value, int startIndex);
• [2429] [C++] public: static double ToDouble(unsigned char value _gc[ ], int startIndex);
• [2430] [VB] Public Shared Function ToDouble(ByVal value( ) As Byte, ByVal startIndex As Integer) As Double
• [2431] [JScript] public static function ToDouble(value: Byte[ ], startIndex: int): double;
  Description

[2432] Returns a double-precision floating point number converted from eight bytes at a specified position in a byte array.

Return Value: A double precision floating point number formed by eight bytes beginning at startIndex. An array of bytes. The starting position within value.

[2433] ToInt16

• [2434] [C#] public static short ToInt16(byte[ ] value, int startIndex);
• [2435] [C++] public: static short ToInt16(unsigned char value _gc[ ], int startIndex);
• [2436] [VB] Public Shared Function ToInt16(ByVal value( ) As Byte, ByVal startIndex As Integer) As Short
• [2437] [JScript] public static function ToInt16(value: Byte[ ], startIndex: int): Int16;
  Description

[2438] Returns a 16-bit signed integer converted from two bytes at a specified position in a byte array.

Return Value: A 16-bit signed integer formed by two bytes beginning at startIndex. An array of bytes. The starting position within value.

[2439] ToInt32

• [2440] [C#] public static int ToInt32(byte[ ] value, int startIndex);
• [2441] [C++] public: static int ToInt32(unsigned char value _gc[ ], int startIndex);
• [2442] [VB] Public Shared Function ToInt32(ByVal value( ) As Byte, ByVal startIndex As Integer) As Integer
• [2443] [JScript] public static function ToInt32(value: Byte[ ], startIndex: int): int;
  Description

[2444] Returns a 32-bit signed integer converted from four bytes at a specified position in a byte array.

Return Value: A 32-bit signed integer formed by four bytes beginning at startIndex.value is null. An array of bytes. The starting position within value.

[2445] ToInt64

• [2446] [C#] public static long ToInt64(byte[ ] value, int startIndex);
• [2447] [C++] public: static _int64 ToInt64(unsigned char value _gc[ ], int startIndex);
• [2448] [VB] Public Shared Function ToInt64(ByVal value( ) As Byte, ByVal startIndex As Integer) As Long
• [2449] [JScript] public static function ToInt64(value: Byte[ ], startIndex: int): long;
  Description

[2450] Returns a 64-bit signed integer converted from eight bytes at a specified position in a byte array.,

Return Value: A 64-bit signed integer formed by eight bytes beginning at startIndex. An array of bytes. The starting position within value.

[2451] ToSingle

• [2452] [C#] public static float ToSingle(byte[ ] value, int startIndex);
• [2453] [C++] public: static float ToSingle(unsigned char value _gc[ ], int startIndex);
• [2454] [VB] Public Shared Function ToSingle(ByVal value( ) As Byte, ByVal startIndex As Integer) As Single
• [2455] [JScript] public static function ToSingle(value: Byte[ ], startIndex: int): float;
  Description

[2456] Returns a single-precision floating point number converted from four bytes at a specified position in a byte array.

Return Value: A single-precision floating point number formed by four bytes beginning at startIndex. An array of bytes. The starting position within value.

[2457] ToString

• [2458] [C#] public static string ToString(byte[ ] value);
• [2459] [C++] public: static String* ToString(unsigned char value _gc[ ]);
• [2460] [VB] Public Shared Function ToString(ByVal value( ) As Byte) As String
• [2461] [JScript] public static function ToString(value: Byte[ ]): String;
  Description

[2462] Returns a String converted from the elements of a byte array.

Return Value: A System.String of hexadecimal pairs separated by hyphens, where each pair represents the corresponding element in value; for example, “7F-2C-4A”.

[2463] All the elements of value are converted. An array of bytes.

[2464] ToString

• [2465] [C#] public static string ToString(byte[ ] value, int startIndex);
• [2466] [C++] public: static String* ToString(unsigned char value _gc[ ], int startIndex);
• [2467] [VB] Public Shared Function ToString(ByVal value( ) As Byte, ByVal startIndex As Integer) As String
• [2468] [JScript] public static function ToString(value: Byte[ ], startIndex: int): String;
  Description

[2469] Returns a String converted from the elements of a byte array starting at a specified array position.

Return Value: A System.String of hexadecimal pairs separated by hyphens, where each pair represents the corresponding element in value; for example, “7F-2C-4A”.

[2470] The elements from array position startIndex to the end of the array are converted. An array of bytes. The starting position within value.

[2471] ToString

• [2472] [C#] public static string ToString(byte[ ] value, int startIndex, int length);
• [2473] [C++] public: static String* ToString(unsigned char value _gc[ ], int startIndex, int length);
• [2474] [VB] Public Shared Function ToString(ByVal value( ) As Byte, ByVal startIndex As Integer, ByVal length As Integer) As String
• [2475] [JScript] public static function ToString(value: Byte[ ], startIndex: int, length int): String; Returns a String converted from the elements of a byte array.
  Description

[2476] Returns a String converted from a specified number of bytes at a specified position in a byte array.

Return Value: A System.String of hexadecimal pairs separated by hyphens, where each pair represents the corresponding element in value; for example, “7F-2C-4A”.

[2477] The length elements from array position startIndex are converted. An array of bytes. The starting position within value. The number of bytes to convert.

[2478] ToUInt16

• [2479] [C#] public static ushort ToUInt16(byte[ ] value, int startIndex);
• [2480] [C++] public: static unsigned short ToUInt16(unsigned char value _gc[ ], int startIndex);
• [2481] [VB] Public Shared Function ToUInt16(ByVal value( ) As Byte, ByVal startIndex As Integer) As UInt16
• [2482] [JScript] public static function ToUInt16(value: Byte[ ], startIndex: int): UInt16;
  Description

[2483] Returns a 16-bit unsigned integer converted from two bytes at a specified position in a byte array.

Return Value: A 16-bit unsigned integer formed by two bytes beginning at startIndex. The array of bytes. The starting position within value.

[2484] ToUInt32

• [2485] [C#] public static uint ToUInt32(byte[ ] value, int startIndex);
• [2486] [C++] public: static unsigned int ToUInt32(unsigned char value _gc[ ], int startIndex);
• [2487] [VB] Public Shared Function ToUInt32(ByVal value( ) As Byte, ByVal startIndex As Integer) As UInt32
• [2488] [JScript] public static function ToUInt32(value: Byte[ ], startIndex: int): UInt32;
  Description

[2489] Returns a 32-bit unsigned integer converted from four bytes at a specified position in a byte array.

Return Value: A 32-bit unsigned integer formed by four bytes beginning at startIndex. An array of bytes. The starting position within value.

[2490] ToUInt64

• [2491] [C#] public static ulong ToUInt64(byte[ ] value, int startIndex);
• [2492] [C++] public: static unsigned _int64 ToUInt64(unsigned char value _gc[ ], int startIndex);
• [2493] [VB] Public Shared Function ToUInt64(ByVal value( ) As Byte, ByVal startIndex As Integer) As UInt64
• [2494] [JScript] public static function ToUInt64(value: Byte[ ], startIndex: int): UInt64;
  Description

[2495] Returns a 64-bit unsigned integer converted from eight bytes at a specified position in a byte array.

Return Value: A 64-bit unsigned integer formed by the eight bytes beginning at startIndex. An array of bytes. The starting position within value.

[2496] Boolean structure (System)

[2497] ToUInt64

Description

[2498] Represents a boolean value.

[2499] Instances of this type have values of either true or false.

[2500] ToUInt64

• [2501] [C#] public static readonly string FalseString;
• [2502] [C++] public: static String* FalseString;
• [2503] [VB] Public Shared ReadOnly FalseString As String
• [2504] [JScript] public static var FalseString: String;
  Description

[2505] Represents the boolean value false as a System.String. This field is read-only.

[2506] This field is equal to the System.String “False”.

[2507] ToUInt64

• [2508] [C#] public static readonly string TrueString;
• [2509] [C++] public: static String* TrueString;
• [2510] [VB] Public Shared ReadOnly TrueString As String
• [2511] [JScript] public static var TrueString: String;
  Description

[2512] Represents the boolean value true as a System.String. This field is read-only.

[2513] This field is equal to the System.String “True”.

[2514] CompareTo

• [2515] [C#] public int CompareTo(object obj);
• [2516] [C++] public: _sealed int CompareTo(Object* obj);
• [2517] [VB] NotOverridable Public Function CompareTo(ByVal obj As Object) As Integer
• [2518] [JScript] public function CompareTo(obj: Object): int;
  Description

[2519] Compares this instance to a specified object and returns an indication of their relative values.

Return Value: A signed integer that indicates the relative order of this instance and obj.

[2520] obj must be null or an instance of Boolean; otherwise, an exception is thrown. An System.Object to compare to this instance. It may be a null reference.

[2521] Equals

• [2522] [C#] public override bool Equals(object obj);
• [2523] [C++] public: bool Equals(Object* obj);
• [2524] [VB] Overrides Public Function Equals(ByVal obj As Object) As Boolean
• [2525] [JScript] public override function Equals(obj: Object): Boolean;
  Description

[2526] Returns a value indicating whether this instance is equal to a specified object.

Return Value: true if obj is a Boolean and has the same value as this instance; otherwise, false.

[2527] This method overrides System.Object.Equals(System.Object). An System.Object to compare to this instance.

[2528] GetHashCode

• [2529] [C#] public override int GetHashCode( );
• [2530] [C++] public: int GetHashCode( );
• [2531] [VB] Overrides Public Function GetHashCode( ) As Integer
• [2532] [JScript] public override function GetHashCode( ): int;
  Description

[2533] Returns the hash code for this instance.

Return Value: A hash code for the current System.Boolean.

[2534] The System.Boolean class implements true as the integer, one, and false as the integer, zero. However, a particular programming language might represent true and false with other values.

GetTypeCode

• [2535] [C#] public TypeCode GetTypeCode( );
• [2536] [C++] public: _sealed TypeCode GetTypeCode( );
• [2537] [VB] NotOverridable Public Function GetTypeCode( ) As TypeCode
• [2538] [JScript] public function GetTypeCode( ): TypeCode;
  Description

[2539] Returns the TypeCode for value type Boolean.

Return Value: The enumerated constant, System.TypeCode.Boolean.

[2540] Parse

• [2541] [C#] public static bool Parse(string value);
• [2542] [C++] public: static bool Parse(String* value);
• [2543] [VB] Public Shared Function Parse(ByVal value As String) As Boolean
• [2544] [JScript] public static function Parse(value: String): Boolean;
  Description

[2545] Converts the specified System.String representation of a logical value to its System.Boolean equivalent.

Return Value: true if value is equivalent to System.Boolean.TrueString; otherwise false.value is a null reference.

[2546] The value parameter, optionally preceded or trailed by white space, must contain either TrueString or FalseString; otherwise, an exception is thrown. The comparison is case-insensitive. A System.String containing the value to convert.

[2547] IConvertible.ToBoolean

• [2548] [C#] bool IConvertible.ToBoolean(IFormatProvider provider);
• [2549] [C++] bool IConvertible::ToBoolean(IFormatProvider* provider);
• [2550] [VB] Function ToBoolean(ByVal provider As IFormatProvider) As Boolean Implements IConvertible.ToBoolean
• [2551] [JScript] function IConvertible.ToBoolean(provider: IFormatProvider): Boolean;

[2552] IConvertible.ToByte

• [2553] [C#] byte IConvertible.ToByte(IFormatProvider provider);
• [2554] [C++] unsigned char IConvertible::ToByte(IFormatProvider* provider);
• [2555] [VB] Function ToByte(ByVal provider As IFormatProvider) As Byte Implements IConvertible.ToByte
• [2556] [JScript] function IConvertible.ToByte(provider: IFormatProvider): Byte;

[2557] IConvertible.ToChar

• [2558] [C#] char IConvertible.ToChar(IFormatProvider provider);
• [2559] [C++] _wchar_t IConvertible::ToChar(IFormatProvider* provider);
• [2560] [VB] Function ToChar(ByVal provider As IFormatProvider) As Char Implements IConvertible.ToChar
• [2561] [JScript] function IConvertible.ToChar(provider: IFormatProvider): Char;

[2562] IConvertible.ToDateTime

• [2563] [C#] DateTime IConvertible.ToDateTime(IFormatProvider provider);
• [2564] [C++] DateTime IConvertible::ToDateTime(IFormatProvider* provider);
• [2565] [VB] Function ToDateTime(ByVal provider As IFormatProvider) As DateTime Implements IConvertible.ToDateTime
• [2566] [JScript] function IConvertible.ToDateTime(provider: IFormatProvider): DateTime;

[2567] IConvertible.ToDecimal

• [2568] [C#] decimal IConvertible.ToDecimal(IFormatProvider provider);
• [2569] [C++] Decimal IConvertible::ToDecimal(IFormatProvider* provider);
• [2570] [VB] Function ToDecimal(ByVal provider As IFormatProvider) As Decimal Implements IConvertible.ToDecimal
• [2571] [JScript] function IConvertible.ToDecimal(provider: IFormatProvider): Decimal;

[2572] IConvertible.ToDouble

• [2573] [C#] double IConvertible.ToDouble(IFormatProvider provider);
• [2574] [C++] double IConvertible::ToDouble(IFormatProvider* provider);
• [2575] [VB] Function ToDouble(ByVal provider As IFormatProvider) As Double Implements IConvertible.ToDouble
• [2576] [JScript] function IConvertible.ToDouble(provider: IFormatProvider): double;

[2577] IConvertible.ToInt16

• [2578] [C#] short IConvertible.ToInt16(IFormatProvider provider);
• [2579] [C++] short IConvertible::ToInt16(IFormatProvider* provider);
• [2580] [VB] Function ToInt16(ByVal provider As IFormatProvider) As Short Implements IConvertible.ToInt16
• [2581] [JScript] function IConvertible.ToInt16(provider: IFormatProvider): Int16;

[2582] IConvertible.ToInt32

• [2583] [C#] int IConvertible.ToInt32(IFormatProvider provider);
• [2584] [C++] int IConvertible::ToInt32(IFormatProvider* provider);
• [2585] [VB] Function ToInt32(ByVal provider As IFormatProvider) As Integer Implements IConvertible.ToInt32
• [2586] [JScript] function IConvertible.ToInt32(provider: IFormatProvider): int;

[2587] IConvertible.ToInt64

• [2588] [C#] long IConvertible.ToInt64(IFormatProvider provider);
• [2589] [VB] Function ToInt64(ByVal provider As IFormatProvider) As Long Implements IConvertible.ToInt64
• [2590] [JScript] function IConvertible.ToInt64(provider: IFormatProvider): long;

[2591] IConvertible.ToSByte

• [2592] [C#] sbyte IConvertible.ToSByte(IFormatProvider provider);
• [2593] [C++] char IConvertible::ToSByte(IFormatProvider* provider);
• [2594] [VB] Function ToSByte(ByVal provider As IFormatProvider) As SByte Implements IConvertible.ToSByte
• [2595] [JScript] function IConvertible.ToSByte(provider: IFormatProvider): SByte;

[2596] IConvertible.ToSingle

• [2597] [C#] float IConvertible.ToSingle(IFormatProvider provider);
• [2598] [C++] float IConvertible::ToSingle(IFormatProvider* provider);
• [2599] [VB] Function ToSingle(ByVal provider As IFormatProvider) As Single Implements IConvertible.ToSingle
• [2600] [JScript] function IConvertible.ToSingle(provider: IFormatProvider): float;

[2601] IConvertible.ToType

• [2602] [C#] object IConvertible.ToType(Type type, IFormatProvider provider);
• [2603] [C++] Object* IConvertible::ToType(Type* type, IFormatProvider* provider);
• [2604] [VB] Function ToType(ByVal type As Type, ByVal provider As IFormatProvider) As Object Implements IConvertible.ToType
• [2605] [JScript] function IConvertible.ToType(type: Type, provider: IFormatProvider) Object;

[2606] IConvertible.ToUInt16

• [2607] [C#] ushort IConvertible.ToUInt16(IFormatProvider provider);
• [2608] [C++] unsigned short IConvertible::ToUInt16(IFormatProvider* provider);
• [2609] [VB] Function ToUInt16(ByVal provider As IFormatProvider) As UInt16 Implements IConvertible.ToUInt16
• [2610] [JScript] function IConvertible.ToUInt16(provider: IFormatProvider): UInt16;

[2611] IConvertible.ToUInt32

• [2612] [C#] uint IConvertible.ToUInt32(IFormatProvider provider);
• [2613] [VB] Function ToUInt32(ByVal provider As IFormatProvider) As UInt32 Implements IConvertible.ToUInt32
• [2614] [JScript] function IConvertible.ToUInt32(provider: IFormatProvider): UInt32;

[2615] IConvertible.ToUInt64

• [2616] [C#] ulong IConvertible.ToUInt64(IFormatProvider provider);
• [2617] [C++] unsigned _int IConvertible::ToUInt64(IFormatProvider* provider);
• [2618] [VB] Function ToUInt64(ByVal provider As IFormatProvider) As UInt64 Implements IConvertible.ToUInt64
• [2619] [JScript] function IConvertible.ToUInt64(provider: IFormatProvider): UInt64;

[2620] ToString

• [2621] [C#] public override string ToString( );
• [2622] [C++] public: String* ToString( );
• [2623] [VB] Overrides Public Function ToString( ) As String
• [2624] [JScript] public override function ToString( ): String; Converts the value of this instance to its equivalent System.String representation.
  Description

[2625] Converts the value of this instance to its equivalent System.String representation.

Return Value: System.Boolean.TrueString if the value of this instance is true, or System.Boolean.FalseString if the value of this instance is false.

[2626] ToString

• [2627] [C#] public string ToString(IFormatProvider provider);
• [2628] [C++] public: _sealed String ToString(IFormatProvider* provider);
• [2629] [VB] NotOverridable Public Function ToString(ByVal provider As IFormatProvider) As String
• [2630] [JScript] public function ToString(provider: IFormatProvider): String;
  Description

[2631] Converts the value of this instance to its equivalent String representation.

Return Value: System.Boolean.TrueString if the value of this instance is true, or System.Boolean.FalseString if the value of this instance is false.

[2632] The provider parameter is reserved. It does not participate in the execution of this method. (Reserved) An System.IFormatProvider object.

[2633] Buffer class (System)

[2634] ToString

Description

[2635] Manipulates unmanaged memory represented as arrays of bytes.

[2636] This class provides methods to copy bytes from one primitive array to another primitive array without respecting types, get a byte from an array, set a byte in an array, and obtain the length of an array.

[2637] BlockCopy

• [2638] [C#] public static void BlockCopy(Array src, int srcOffset, Array dst, int dstOffset, int count);
• [2639] [C++] public: static void BlockCopy(Array* src, int srcOffset, Array* dst, int dstOffset, int count);
• [2640] [VB] Public Shared Sub BlockCopy(ByVal src As Array, ByVal srcOffset As Integer, ByVal dst As Array, ByVal dstOffset As Integer, ByVal count As Integer)
• [2641] [JScript] public static function BlockCopy(src: Array, srcOffset: int, dst: Array, dstOffset: int, count: int);
  Description

[2642] Copies a specified number of bytes from a source array starting at a particular offset to a destination array starting at a particular offset.

[2643] Copies count bytes from src, beginning at srcOffset, to dst, beginning at dstOffset. The source buffer. The byte offset into src. The destination buffer. The byte offset into dst. The number of bytes to copy.

[2644] ByteLength

• [2645] [C#] public static int ByteLength(Array array);
• [2646] [C++] public: static int ByteLength(Array* array);
• [2647] [VB] Public Shared Function ByteLength(ByVal array As Array) As Integer
• [2648] [JScript] public static function ByteLength(array: Array): int;
  Description

[2649] Returns the number of bytes in the specified array.

Return Value: The number of bytes in the array. An array.

[2650] GetByte

• [2651] [C#] public static byte GetByte(Array array, int index);
• [2652] [C++] public: static unsigned char GetByte(Array* array, int index);
• [2653] [VB] Public Shared Function GetByte(ByVal array As Array, ByVal index As Integer) As Byte
• [2654] [JScript] public static function GetByte(array: Array, index: int): Byte;
  Description

[2655] Retrieves the byte at a specified location in a specified array.

Return Value: Returns the index byte in the array.

[2656] The GetByte method gets a particular byte out of the array. The array must be an array of primitives. An array. A location in the array.

[2657] SetByte

• [2658] [C#] public static void SetByte(Array array, int index, byte value);
• [2659] [C++] public: static void SetByte(Array* array, int index, unsigned char value);
• [2660] [VB] Public Shared Sub SetByte(ByVal array As Array, ByVal index As Integer, ByVal value As Byte)
• [2661] [JScript] public static function SetByte(array: Array, index: int, value: Byte);
  Description

[2662] Assigns a specified value to a byte at a particular location in a specified array.

[2663] array must be an array of primitives. An array. A location in the array. A value to assign.

[2664] Byte structure (System)

[2665] ToString

Description

[2666] Represents an 8-bit unsigned integer.

[2667] The Byte value type represents unsigned integers with values ranging from 0 to 255.

[2668] ToString

• [2669] [C#] public const byte MaxValue;
• [2670] [C++] public: const unsigned char MaxValue;
• [2671] [VB] Public Const MaxValue As Byte
• [2672] [JScript] public var MaxValue: Byte;
  Description

[2673] A constant representing the largest possible value of Byte.

[2674] The value of this constant is 255; that is, hexadecimal 0xFF.

[2675] ToString

• [2676] [C#] public const byte MinValue;
• [2677] [C++] public: const unsigned char MinValue;
• [2678] [VB] Public Const MinValue As Byte
• [2679] [JScript] public var MinValue: Byte;
  Description

[2680] A constant representing the smallest possible value of Byte.

[2681] The value of this constant is.

[2682] CompareTo

• [2683] [C#] public int CompareTo(object value);
• [2684] [C++] public: _sealed int CompareTo(Object* value);
• [2685] [VB] NotOverridable Public Function CompareTo(ByVal value As Object) As Integer
• [2686] [JScript] public function CompareTo(value: Object): int;
  Description

[2687] Compares this instance to a specified object and returns an indication of their relative values.

Return Value: A signed number indicating the relative values of this instance and value.

[2688] Any instance of Byte, regardless of its value, is considered greater than null. An object to compare, or null.

[2689] Equals

• [2690] [C#] public override bool Equals(object obj);
• [2691] [C++] public: bool Equals(Object* obj);
• [2692] [VB] Overrides Public Function Equals(ByVal obj As Object) As Boolean
• [2693] [JScript] public override function Equals(obj: Object): Boolean;
  Description

[2694] Returns a value indicating whether this instance is equal to a specified object.

Return Value: true if obj is an instance of Byte and equals the value of this instance; otherwise, false. An object to compare with this instance or null.

[2695] GetHashCode

• [2696] [C#] public override int GetHashCode( );
• [2697] [C++] public: int GetHashCode( );
• [2698] [VB] Overrides Public Function GetHashCode( ) As Integer
• [2699] [JScript] public override function GetHashCode( ): int;
  Description

[2700] Returns the hash code for this instance.

Return Value: A 32-bit signed integer hash code.

[2701] GetTypeCode

• [2702] [C#] public TypeCode GetTypeCode( );
• [2703] [C++] public: _sealed TypeCode GetTypeCode( );
• [2704] [VB] NotOverridable Public Function GetTypeCode( ) As TypeCode
• [2705] [JScript] public function GetTypeCode( ): TypeCode;
  Description

[2706] Returns the TypeCode for value type Byte.

Return Value: The enumerated constant, System.TypeCode.Byte.

[2707] Parse

• [2708] [C#] public static byte Parse(string s);
• [2709] [C++] public: static unsigned char Parse(String* s);
• [2710] [VB] Public Shared Function Parse(ByVal s As String) As Byte
• [2711] [JScript] public static function Parse(s: String): Byte; Converts the String representation of a number to its 8-bit unsigned integer equivalent.
  Description

[2712] Converts the String representation of a number to its 8-bit unsigned integer equivalent.

Return Value: An 8-bit unsigned integer equivalent to the number contained in s.

[2713] s contains a number of the form: [ws][sign]digits[ws] Items in square brackets (‘[’ and ‘]’) are optional, and other items are as follows. A System.String containing a number to convert.

[2714] Parse

• [2715] [C#] public static byte Parse(string s, IFormatProvider provider);
• [2716] [C++] public: static unsigned char Parse(String* s, IFormatProvider* provider);
• [2717] [VB] Public Shared Function Parse(ByVal s As String, ByVal provider As IFormatProvider) As Byte
• [2718] [JScript] public static function Parse(s: String, provider: IFormatProvider): Byte;
  Description

[2719] Converts the String representation of a number in a specified culture-specific format to its 8-bit unsigned integer equivalent.

Return Value: An 8-bit unsigned integer equivalent to the number specified in s.

[2720] s contains a number of the form: [ws][sign]digits[ws] Items in square brackets (‘[’ and‘]’) are optional, and other items are as follows. A System.String containing a number to convert. An System.IFormatProvider interface implementation which supplies culture-specific formatting information about s.

[2721] Parse

• [2722] [C#] public static byte Parse(string s, NumberStyles style);
• [2723] [C++] public: static unsigned char Parse(String* s, NumberStyles style);
• [2724] [VB] Public Shared Function Parse(ByVal s As String, ByVal style As NumberStyles) As Byte
• [2725] [JScript] public static function Parse(s: String, style: NumberStyles): Byte;
  Description

[2726] Converts the String representation of a number in a specified style to its 8-bit unsigned integer equivalent.

Return Value: An 8-bit unsigned integer equivalent to the number specified in s.

[2727] s contains a number of the form: [ws][sign]digits[ws] Items in square brackets (‘[’ and ‘]’) are optional, and other items are as follows. A System.String containing a number to convert. The combination of one or more System.Globalization.NumberStyles constants that indicate the permitted format of s.

[2728] Parse

• [2729] [C#] public static byte Parse(string s, NumberStyles style, IFormatProvider provider);
• [2730] [C++] public: static unsigned char Parse(String* s, NumberStyles style, IFormatProvider* provider);
• [2731] [VB] Public Shared Function Parse(ByVal s As String, ByVal style As NumberStyles, ByVal provider As IFormatProvider) As Byte
• [2732] [JScript] public static function Parse(s: String, style: NumberStyles, provider: IFormatProvider): Byte;
  Description

[2733] Converts the String representation of a number in a specified style and culture-specific format to its 8-bit unsigned integer equivalent.

Return Value: An 8-bit unsigned integer equivalent to the number specified in s.

[2734] s contains a number of the form: [ws][sign]digits[ws] Items in square brackets (‘[’ and ‘]’) are optional, and other items are as follows. A System.String containing a number to convert. The combination of one or more System.Globalization.NumberStylesconstants that indicate the permitted format of s. An System.IFormatProvider interface implementation which supplies culture-specific formatting information about s.

[2735] IConvertible.ToBoolean

• [2736] [C#] bool IConvertible.ToBoolean(IFormatProvider provider);
• [2737] [C++] bool IConvertible::ToBoolean(IFormatProvider* provider);
• [2738] [VB] Function ToBoolean(ByVal provider As IFormatProvider) As Boolean Implements IConvertible.ToBoolean
• [2739] [JScript] function IConvertible.ToBoolean(provider: IFormatProvider): Boolean;

[2740] IConvertible.ToByte

• [2741] [C#] byte IConvertible.ToByte(IFormatProvider provider);
• [2742] [C++] unsigned char IConvertible::ToByte(IFormatProvider* provider);
• [2743] [VB] Function ToByte(ByVal provider As IFormatProvider) As Byte Implements IConvertible.ToByte
• [2744] [JScript] function IConvertible.ToByte(provider: IFormatProvider): Byte; IConvertible.ToChar
• [2745] [C#] char IConvertible.ToChar(IFormatProvider provider);
• [2746] [C++] _wchar_t IConvertible::ToChar(IFormatProvider* provider);
• [2747] [VB] Function ToChar(ByVal provider As IFormatProvider) As Char Implements IConvertible.ToChar
• [2748] [JScript] function IConvertible.ToChar(provider: IFormatProvider): Char; IConvertible.ToDateTime
• [2749] [C#] DateTime IConvertible.ToDateTime(IFormatProvider provider);
• [2750] [C++] DateTime IConvertible::ToDateTime(IFormatProvider* provider);
• [2751] [VB] Function ToDateTime(ByVal provider As IFormatProvider) As DateTime Implements IConvertible.ToDateTime
• [2752] [JScript] function IConvertible.ToDateTime(provider: IFormatProvider): DateTime;

[2753] IConvertible.ToDecimal

• [2754] [C#] decimal IConvertible.ToDecimal(IFormatProvider provider);
• [2755] [C++] Decimal IConvertible::ToDecimal(IFormatProvider* provider);
• [2756] [VB] Function ToDecimal(ByVal provider As IFormatProvider) As Decimal Implements IConvertible.ToDecimal
• [2757] [JScript] function IConvertible.ToDecimal(provider: IFormatProvider): Decimal;

[2758] IConvertible.ToDouble

• [2759] [C#] double IConvertible.ToDouble(IFormatProvider provider);
• [2760] [C++] double IConvertible::ToDouble(IFormatProvider* provider);
• [2761] [VB] Function ToDouble(ByVal provider As IFormatProvider) As Double Implements IConvertible.ToDouble
• [2762] [JScript] function IConvertible.ToDouble(provider: IFormatProvider): double;

[2763] IConvertible.ToInt16

• [2764] [C#] short IConvertible.ToInt16(IFormatProvider provider);
• [2765] [C++] short IConvertible::ToInt16(IFormatProvider* provider);
• [2766] [VB] Function ToInt16(ByVal provider As IFormatProvider) As Short Implements IConvertible.ToInt16
• [2767] [JScript] function IConvertible.ToInt16(provider: IFormatProvider): Int16;

[2768] IConvertible.ToInt32

• [2769] [C#] it IConvertible.ToInt32(IFormatProvider provider);
• [2770] [C++] int IConvertible::ToInt32(IFormatProvider* provider);
• [2771] [VB] Function ToInt32(ByVal provider As IFormatProvider) As Integer Implements IConvertible.ToInt32
• [2772] [JScript] function IConvertible.ToInt32(provider: IFormatProvider): int;

[2773] IConvertible.ToInt64

• [2774] [C#] long IConvertible.ToInt64(IFormatProvider provider);
• [2775] [C++] _int64 IConvertible::ToInt64(IFormatProvider* provider);
• [2776] [VB] Function ToInt64(ByVal provider As IFormatProvider) As Long Implements IConvertible.ToInt64
• [2777] [JScript] function IConvertible.ToInt64(provider: IFormatProvider): long;

[2778] IConvertible.ToSByte

• [2779] [C#] sbyte IConvertible.ToSByte(IFormatProvider provider);
• [2780] [C++] char IConvertible::ToSByte(IFormatProvider* provider);
• [2781] [VB] Function ToSByte(ByVal provider As IFormatProvider) As SByte Implements IConvertible.ToSByte
• [2782] [JScript] function IConvertible.ToSByte(provider: IFormatProvider): SByte;

[2783] IConvertible.ToSingle

• [2784] [C#] float IConvertible.ToSingle(IFormatProvider provider);
• [2785] [C++] float IConvertible::ToSingle(IFormatProvider* provider);
• [2786] [VB] Function ToSingle(ByVal provider As IFormatProvider) As Single Implements IConvertible.ToSingle
• [2787] [JScript] function IConvertible.ToSingle(provider: IFormatProvider): float;

[2788] IConvertible.ToType

• [2789] [C#] object IConvertible.ToType(Type type, IFormatProvider provider);
• [2790] [C++] Object* IConvertible::ToType(Type* type, IFormatProvider* provider);
• [2791] [VB] Function ToType(ByVal type As Type, ByVal provider As IFormatProvider) As Object Implements IConvertible.ToType
• [2792] [JScript] function IConvertible.ToType(type: Type, provider: IFormatProvider): Object;

[2793] IConvertible.ToUInt16

• [2794] [C#] ushort IConvertible.ToUInt16(IFormatProvider provider);
• [2795] [C++] unsigned short IConvertible::ToUInt16(IFormatProvider* provider);
• [2796] [VB] Function ToUInt16(ByVal provider As IFormatProvider) As UInt16 Implements IConvertible.ToUInt16
• [2797] [JScript] function IConvertible.ToUInt16(provider: IFormatProvider): UInt16;

[2798] IConvertible.ToUInt32

• [2799] [C#] uint IConvertible.ToUInt32(IFormatProvider provider);
• [2800] [C++] unsigned int IConvertible::ToUInt32(IFormatProvider* provider);
• [2801] [VB] Function ToUInt32(ByVal provider As IFormatProvider) As UInt32 Implements IConvertible.ToUInt32
• [2802] [JScript] function IConvertible.ToUInt32(provider: IFormatProvider): UInt32;

[2803] IConvertible.ToUInt64

• [2804] [C#] ulong IConvertible.ToUInt64(IFormatProvider provider);
• [2805] [C++] unsigned _int64 IConvertible::ToUInt64(IFormatProvider* provider);
• [2806] [VB] Function ToUInt64(ByVal provider As IFormatProvider) As UInt64 Implements IConvertible.ToUInt64
• [2807] [JScript] function IConvertible.ToUInt64(provider: IFormatProvider): UInt64;

[2808] ToString

• [2809] [C#] public override string ToString( );
• [2810] [C++] public: String* ToString( );
• [2811] [VB] Overrides Public Function ToString( ) As String
• [2812] [JScript] public override function ToString( ): String; Converts the numeric value of this instance to its equivalent String representation.
  Description

[2813] Converts the numeric value of this instance to its equivalent String representation.

Return Value: The System.String representation of the value of this instance, consisting of a sequence of digits ranging from 0 to 9, without a sign or leading zeroes.

[2814] The return value is formatted with the general format specifier (“G”) and the System.Globalization.NumberFormatInfo for the current culture.

[2815] ToString

• [2816] [C#] public string ToString(IFormatProvider provider); [C++] public: _sealed String* ToString(IFormatProvider* provider);
• [2817] [VB] NotOverridable Public Function ToString(ByVal provider As IFormatProvider) As String
• [2818] [JScript] public function ToString(provider: IFormatProvider): String;
  Description

[2819] Converts the numeric value of this instance to its equivalent String representation using the specified culture-specific format information.

Return Value: The System.String representation of the value of this instance as specified by provider.

[2820] This instance is formatted with the general format specifier (“G”). An System.IFormatProvider interface implementation which supplies culture-specific formatting information.

[2821] ToString

• [2822] [C#] public string ToString(string format);
• [2823] [C++] public: String* ToString(String* format);
• [2824] [VB] Public Function ToString(ByVal format As String) As String
• [2825] [JScript] public function ToString(format: String): String;
  Description

[2826] Converts the numeric value of this instance to its equivalent String representation using the specified format.

Return Value: The System.String representation of the value of this instance as specified by format.

[2827] If format is null or an empty string, the return value of this instance is formatted with the general format specifier (“G”). A format string.

[2828] ToString

• [2829] [C#] public string ToString(string format, IFormatProvider provider);
• [2830] [C++] public: _sealed String* ToString(String* format, IFormatProvider* provider);
• [2831] [VB] NotOverridable Public Function ToString(ByVal format As String, ByVal provider As IFormatProvider) As String
• [2832] [JScript] public function ToString(format: String, provider: IFormatProvider): String;
  Description

[2833] Converts the numeric value of this instance to its equivalent String representation using the specified format and culture-specific format information.

Return Value: The System.String representation of the value of this instance as specified by format and provider.

[2834] If format is null or an empty string, the return value for this instance is formatted with the general format specifier (“G”). A format specification. An System.IFormatProvider interface implementation which supplies culture-specific formatting information.

[2835] CannotUnloadAppDomainException class (System)

[2836] ToString

Description

[2837] The exception that is thrown when an attempt to unload an application domain fails.

[2838] System.CannotUnloadAppDomainException is thrown when there is an attempt to unload: The default application domain, which must remains loaded during the lifetime of the application.

[2839] CannotUnloadAppDomainException

[2840] Example Syntax:

[2841] ToString

• [2842] [C#] public CannotUnloadAppDomainException( );
• [2843] [C++] public: CannotUnloadAppDomainException( );
• [2844] [VB] Public Sub New( )
• [2845] [JScript] public function CannotUnloadAppDomainException( ); Initializes a new instance of the System.CannotUnloadAppDomainException class.
  Description

[2846] Initializes a new instance of the System.CannotUnloadAppDomainException class with default properties.

[2847] The following table shows the initial property values for an instance of System.CannotUnloadAppDomainException.

[2848] CannotUnloadAppDomainException

[2849] Example Syntax:

[2850] ToString

• [2851] [C#] public CannotUnloadAppDomainException(string message);
• [2852] [C++] public: CannotUnloadAppDomainException(String* message);
• [2853] [VB] Public Sub New(ByVal message As String)
• [2854] [JScript] public function CannotUnloadAppDomainException(message: String);
  Description

[2855] Initializes a new instance of the System.CannotUnloadAppDomainException class with a specified error message.

[2856] The following table shows the initial property values for an instance of System.CannotUnloadAppDomainException. The error message that explains the reason for the exception.

[2857] CannotUnloadAppDomainException

[2858] Example Syntax:

[2859] ToString

• [2860] [C#] protected CannotUnloadAppDomainException(SerializationInfo info, StreamingContext context);
• [2861] [C++] protected: CannotUnloadAppDomainException(SerializationInfo* info, StreamingContext context);
• [2862] [VB] Protected Sub New(ByVal info As SerializationInfo, ByVal context As StreamingContext)
• [2863] [JScript] protected function CannotUnloadAppDomainException(info: SerializationInfo, context: StreamingContext);
  Description

[2864] Initializes a new instance of the System.CannotUnloadAppDomainException class from serialized data.

[2865] This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. For more information, see. The object that holds the serialized object data. The contextual information about the source or destination.

[2866] CannotUnloadAppDomainException

[2867] Example Syntax:

[2868] ToString

• [2869] [C#] public CannotUnloadAppDomainException(string message, Exception innerException);
• [2870] [C++] public: CannotUnloadAppDomainException(String* message, Exception* innerException);
• [2871] [VB] Public Sub New(ByVal message As String, ByVal innerException As Exception)
• [2872] [JScript] public function CannotUnloadAppDomainException(message: String, innerException: Exception);
  Description

[2873] Initializes a new instance of the System.CannotUnloadAppDomainException class with a specified error message and a reference to the inner exception that is the root cause of this exception.

[2874] When an ExceptionX is thrown as a direct result of a previous exception Y, the System.Exception.InnerException property of X should contain a reference to Y. The InnerException property returns the same value as was passed into the constructor, or null if the inner exception value was not supplied to the constructor. The error message that explains the reason for the exception. An instance of System.Exception that is the cause of the current Exception. If innerException is non-null, then the current Exception is raised in a catch block handling innerException.

[2875] HelpLink

[2876] HResult

[2877] InnerException

[2878] Message

[2879] Source

[2880] StackTrace

[2881] TargetSite

[2882] Char structure (System)

[2883] ToString

Description

[2884] Represents a Unicode character.

[2885] The Char value type represents Unicode characters with values ranging from hexadecimal 0x0000 to 0xFFFF.

[2886] ToString

• [2887] [C#] public const char MaxValue;
• [2888] [C++] public: const _wchar_t MaxValue;
• [2889] [VB] Public Const MaxValue As Char
• [2890] [JScript] public var MaxValue: Char;
  Description

[2891] A constant representing the largest possible value of Char.

[2892] The value of this constant is hexadecimal 0xFFFF.

[2893] ToString

• [2894] [C#] public const char MinValue;
• [2895] [C++] public: const _wchar_t MinValue;
• [2896] [VB] Public Const MinValue As Char
• [2897] [JScript] public var MinValue: Char;
  Description

[2898] A constant representing the smallest possible value of Char.

[2899] The value of this constant is hexadecimal 0x00.

[2900] CompareTo

• [2901] [C#] public int CompareTo(object value);
• [2902] [C++] public: _sealed int CompareTo(Object* value);
• [2903] [VB] NotOverridable Public Function CompareTo(ByVal value As Object) As Integer
• [2904] [JScript] public function CompareTo(value: Object): int;
  Description

[2905] Compares this instance to a specified object and returns an indication of their relative values.

Return Value: A signed number indicating the relative values of this instance and value.

[2906] Any instance of Char, regardless of its value, is considered greater than null. An object to compare, or null.

[2907] Equals

• [2908] [C#] public override bool Equals(object obj);
• [2909] [C++] public: bool Equals(Object* obj);
• [2910] [VB] Overrides Public Function Equals(ByVal obj As Object) As Boolean
• [2911] [JScript] public override function Equals(obj: Object): Boolean;
  Description

[2912] Returns a value indicating whether this instance is equal to a specified object.

Return Value: true if obj is an instance of Char and equals the value of this instance; otherwise, false. An object to compare with this instance or null.

[2913] GetHashCode

• [2914] [C#] public override int GetHashCode( );
• [2915] [C++] public: int GetHashCode( );
• [2916] [VB] Overrides Public Function GetHashCode( ) As Integer
• [2917] [JScript] public override function GetHashCode( ): int;
  Description

[2918] Returns the hash code for this instance.

Return Value: A 32-bit signed integer hash code.

[2919] GetNumericValue

• [2920] [C#] public static double GetNumericValue(char c);
• [2921] [C++] public: static double GetNumericValue(_wchar_t c);
• [2922] [VB] Public Shared Function GetNumericValue(ByVal c As Char) As Double
• [2923] [JScript] public static function GetNumericValue(c: Char): double; Converts a specified numeric Unicode character to a double-precision floating point number.
  Description

[2924] Converts the specified numeric Unicode character to a double-precision floating point number.

Return Value: The numeric value of c if that character represents a number; otherwise, −1.

[2925] For example, if c is ‘5’, the return value is 5. However, if c is ‘z’, the return value is −1. A Unicode character.

[2926] GetNumericValue

• [2927] [C#] public static double GetNumericValue(string s, int index);
• [2928] [C++] public: static double GetNumericValue(String* s, int index);
• [2929] [VB] Public Shared Function GetNumericValue(ByVal s As String, ByVal index As Integer) As Double
• [2930] [JScript] public static function GetNumericValue(s: String, index: int): double;
  Description

[2931] Converts the numeric Unicode character at the specified position in a specified System.String to a double-precision floating point number.

Return Value: The numeric value of the character at position index in s if that character represents a number; otherwise, −1.

[2932] For example, if the character at position index in s is ‘5’, the return value is 5. However, if the character at position index in s is ‘z’, the return value is −1. A System.String. A 32-bit signed integer that specifies a character position in s.

[2933] GetTypeCode

• [2934] [C#] public TypeCode GetTypeCode( );
• [2935] [C++] public: _sealed TypeCode GetTypeCode( );
• [2936] [VB] NotOverridable Public Function GetTypeCode( ) As TypeCode
• [2937] [JScript] public function GetTypeCode( ): TypeCode;
  Description

[2938] Returns the TypeCode for value type Char.

Return Value: The enumerated constant, System.TypeCode.Char.

[2939] GetUnicodeCategory

• [2940] [C#] public static UnicodeCategory GetUnicodeCategory(char c);
• [2941] [C++] public: static UnicodeCategory GetUnicodeCategory(_wchar_t c);
• [2942] [VB] Public Shared Function GetUnicodeCategory(ByVal c As Char) As UnicodeCategory
• [2943] [JScript] public static function GetUnicodeCategory(c: Char): UnicodeCategory; Categorizes a Unicode character into a group identified by a UnicodeCategory enumerated constant.
  Description

[2944] Categorizes a specified Unicode character into a group identified by a UnicodeCategory enumerated constant.

Return Value: A System.Globalization.UnicodeCategory enumerated constant that identifies the group that contains c. A Unicode character.

[2945] GetUnicodeCategory

• [2946] [C#] public static UnicodeCategory GetUnicodeCategory(string s, int index);
• [2947] [C++] public: static UnicodeCategory GetUnicodeCategory(String* s, int index);
• [2948] [VB] Public Shared Function GetUnicodeCategory(ByVal s As String, ByVal index As Integer) As UnicodeCategory
• [2949] [JScript] public static function GetUnicodeCategory(s: String, index: int) UnicodeCategory;
  Description

[2950] Categorizes the character at the specified position in a specified String into a group identified by a UnicodeCategory enumerated constant.

Return Value: A System.Globalization.UnicodeCategory enumerated constant that identifies the group that contains the character at position index in s.

[2951] Character positions in a String are indexed starting from zero. A System.String. A 32-bit signed integer that specifies a character position in s.

[2952] IsControl

• [2953] [C#] public static bool IsControl(char c);
• [2954] [C++] public: static bool IsControl(_wchar_t c);
• [2955] [VB] Public Shared Function IsControl(ByVal c As Char) As Boolean
• [2956] [JScript] public static function IsControl(c: Char): Boolean; Indicates whether a specified Unicode character is categorized as a control character.
  Description

[2957] Indicates whether the specified Unicode character is categorized as a control character.

Return Value: true if c is a control character; otherwise, false. A Unicode character.

[2958] IsControl

• [2959] [C#] public static bool IsControl(string s, int index);
• [2960] [C++] public: static bool IsControl(String* s, int index);
• [2961] [VB] Public Shared Function IsControl(ByVal s As String, ByVal index As Integer) As Boolean
• [2962] [JScript] public static function IsControl(s: String, index: int): Boolean;
  Description

[2963] Indicates whether the character at the specified position in a specified String is categorized as a control character.

Return Value: true if the character at position index in s is a control character; otherwise, false.

[2964] Character positions in a String are indexed starting from zero. A System.String. A 32-bit signed integer that specifies a character position in s.

IsDigit

• [2965] [C#] public static bool IsDigit(char c);
• [2966] [C++] public: static bool IsDigit(_wchar_t c);
• [2967] [VB] Public Shared Function IsDigit(ByVal c As Char) As Boolean
• [2968] [JScript] public static function IsDigit(c: Char): Boolean; Indicates whether a Unicode character is categorized as a decimal digit.
  Description

[2969] Indicates whether the specified Unicode character is categorized as a decimal digit.

Return Value: true if c is a decimal digit; otherwise, false. A Unicode character.

[2970] IsDigit

• [2971] [C#] public static bool IsDigit(string s, int index);
• [2972] [C++] public: static bool IsDigit(String* s, int index);
• [2973] [VB] Public Shared Function IsDigit(ByVal s As String, ByVal index As Integer) As Boolean
• [2974] [JScript] public static function IsDigit(s: String, index: int): Boolean;
  Description

[2975] Indicates whether the character at the specified position in a specified String is categorized as a decimal digit.

Return Value: true if the character at position index in s is a decimal digit; otherwise, false.

[2976] Character positions in a String are indexed starting from zero. A System.String. A 32-bit signed integer that specifies a character position in s.

[2977] IsLetter

• [2978] [C#] public static bool IsLetter(char c);
• [2979] C++] public: static bool IsLetter(_wchar_t c);
• [2980] [VB] Public Shared Function IsLetter(ByVal c As Char) As Boolean
• [2981] [JScript] public static function IsLetter(c: Char): Boolean; Indicates whether a Unicode character is categorized as an alphabetic letter.
  Description

[2982] Indicates whether the specified Unicode character is categorized as an alphabetic letter.

Return Value: true if c is an alphabetic letter; otherwise, false.

[2983] Valid letters are members of the following categories in System.Globalization.UnicodeCategory: UppercaseLetter, LowercaseLetter, TitlecaseLetter, ModifierLetter, and OtherLetter. A Unicode character.

[2984] IsLetter

• [2985] [C#] public static bool IsLetter(string s, int index);
• [2986] [C++] public: static bool IsLetter(String* s, int index);
• [2987] [VB] Public Shared Function IsLetter(ByVal s As String, ByVal index As Integer) As Boolean
• [2988] [JScript] public static function IsLetter(s: String, index: int): Boolean;
  Description

[2989] Indicates whether the character at the specified position in a specified String is categorized as an alphabetic character.

Return Value: true if the character at position index in s is an alphabetic character; otherwise, false. Character positions in a String are indexed starting from zero. A System.String. A 32-bit signed integer that specifies a character position in s.

[2990] IsLetterOrDigit

• [2991] [C#] public static bool IsLetterOrDigit(char c);
• [2992] [C++] public: static bool IsLetterOrDigit(_wchar_t c);
• [2993] [VB] Public Shared Function IsLetterOrDigit(ByVal c As Char) As Boolean
• [2994] [JScript] public static function IsLetterOrDigit(c: Char): Boolean; Indicates whether a Unicode character is categorized as a letter or decimal digit.
  Description

[2995] Indicates whether the specified Unicode character is categorized as a letter or decimal digit.

Return Value: true if c is a letter or decimal digit; otherwise, false. A Unicode character.

[2996] IsLetterOrDigit

• [2997] [C#] public static bool IsLetterOrDigit(string s, int index);
• [2998] [C++] public: static bool IsLetterOrDigit(String* s, int index);
• [2999] [VB] Public Shared Function IsLetterOrDigit(ByVal s As String, ByVal index As Integer) As Boolean
• [3000] [JScript] public static function IsLetterOrDigit(s: String, index: int): Boolean;
  Description

[3001] Indicates whether the character at the specified position in a specified String is categorized as an alphabetic character or a decimal digit.

Return Value: true if the character at position index in s is an alphabetic character or a decimal digit; otherwise, false.

[3002] Character positions in a String are indexed starting from zero. A System.String. A 32-bit signed integer that specifies a character position in s.

[3003] IsLower

• [3004] [C#] public static bool IsLower(char c);
• [3005] [C++] public: static bool IsLower(_wchar_t c);
• [3006] [VB] Public Shared Function IsLower(ByVal c As Char) As Boolean
• [3007] [JScript] public static function IsLower(c: Char): Boolean; Indicates whether a Unicode character is categorized as a lowercase letter.
  Description

[3008] Indicates whether the specified Unicode character is categorized as a lowercase letter.

Return Value: true if c is a lowercase letter; otherwise, false. A Unicode character.

[3009] IsLower

• [3010] [C#] public static bool IsLower(string s, int index);
• [3011] [C++] public: static bool IsLower(String* s, int index);
• [3012] [VB] Public Shared Function IsLower(ByVal s As String, ByVal index As Integer) As Boolean
• [3013] [JScript] public static function IsLower(s: String, index: int): Boolean;
  Description

[3014] Indicates whether the character at the specified position in a specified String is categorized as a lowercase letter.

Return Value: true if the character at position index in s is a lowercase letter; otherwise, false.

[3015] Character positions in a String are indexed starting from zero. A System.String. A 32-bit signed integer that specifies a character position in s.

[3016] IsNumber

• [3017] [C#] public static bool IsNumber(char c);
• [3018] [C++] public: static bool IsNumber(_wchar_t c);
• [3019] [VB] Public Shared Function IsNumber(ByVal c As Char) As Boolean
• [3020] [JScript] public static function IsNumber(c: Char): Boolean; Indicates whether a Unicode character is categorized as a decimal digit or hexadecimal number.
  Description

[3021] Indicates whether the specified Unicode character is categorized as a decimal digit or hexadecimal number.

Return Value: true if c is a decimal digit or hexadecimal number; otherwise, false A Unicode character.

[3022] IsNumber

• [3023] [C#] public static bool IsNumber(string s, int index);
• [3024] [C++] public: static bool IsNumber(String* s, int index);
• [3025] [VB] Public Shared Function IsNumber(ByVal s As String, ByVal index As Integer) As Boolean
• [3026] [JScript] public static function IsNumber(s: String, index: int): Boolean;
  Description

[3027] Indicates whether the character at the specified position in a specified String is categorized as a decimal digit or hexadecimal number.

Return Value: true if the character at position index in s is a decimal digit or hexadecimal number; otherwise, false.

[3028] Character positions in a String are indexed starting from zero. A System.String. A 32-bit signed integer that specifies a character position in s.

[3029] IsPunctuation

• [3030] [C#] public static bool IsPunctuation(char c);
• [3031] [C++] public: static bool IsPunctuation(_wchar_t c);
• [3032] [VB] Public Shared Function IsPunctuation(ByVal c As Char) As Boolean
• [3033] [JScript] public static function IsPunctuation(c: Char): Boolean; Indicates whether a Unicode character is categorized as a punctuation mark.
  Description

[3034] Indicates whether the specified Unicode character is categorized as a punctuation mark.

Return Value: true if c is a punctuation mark; otherwise, false. A Unicode character.

[3035] IsPunctuation

• [3036] [C#] public static bool IsPunctuation(string s, int index);
• [3037] [C++] public: static bool IsPunctuation(String* s, int index);
• [3038] [VB] Public Shared Function IsPunctuation(ByVal s As String, ByVal index As Integer) As Boolean
• [3039] [JScript] public static function IsPunctuation(s: String, index: int): Boolean;
  Description

[3040] Indicates whether the character at the specified position in a specified String is categorized as a punctuation mark.

Return Value: true if the character at position index in s is a punctuation mark; otherwise, false.

[3041] Character positions in a String are indexed starting from zero. A System.String. A 32-bit signed integer that specifies a character position in s.

[3042] IsSeparator

• [3043] [C#] public static bool IsSeparator(char c);
• [3044] [C++] public: static bool IsSeparator(_wchar_t c);
• [3045] [VB] Public Shared Function IsSeparator(ByVal c As Char) As Boolean
• [3046] [JScript] public static function IsSeparator(c: Char): Boolean; Indicates whether a Unicode character is categorized as a separator character.
  Description

[3047] Indicates whether the specified Unicode character is categorized as a separator character.

Return Value: true if c is a separator character; otherwise, false. A Unicode character.

[3048] IsSeparator

• [3049] [C#] public static bool IsSeparator(string s, int index);
• [3050] [C++] public: static bool IsSeparator(String* s, int index);
• [3051] [VB] Public Shared Function IsSeparator(ByVal s As String, ByVal index As Integer) As Boolean
• [3052] [JScript] public static function IsSeparator(s: String, index: int): Boolean;
  Description

[3053] Indicates whether the character at the specified position in a specified String is categorized as a separator character.

Return Value: true if the character at position index in s is a separator character; otherwise, false.

[3054] Character positions in a String are indexed starting from zero. A System.String. A 32-bit signed integer that specifies a character position in s.

[3055] IsSurrogate

• [3056] [C#] public static bool IsSurrogate(char c);
• [3057] [C++] public: static bool IsSurrogate(_wchar_t c);
• [3058] [VB] Public Shared Function IsSurrogate(ByVal c As Char) As Boolean
• [3059] [JScript] public static function IsSurrogate(c: Char): Boolean; Indicates whether a Unicode character is categorized as a surrogate character.
  Description

[3060] Indicates whether the specified Unicode character is categorized as a surrogate character.

Return Value: true if c is a surrogate character; otherwise, false.

[3061] For more information about surrogate pairs, see the Unicode Standard at http://www.unicode.org. A Unicode character.

[3062] IsSurrogate

• [3063] [C#] public static bool IsSurrogate(string S, int index);
• [3064] [C++] public: static bool IsSurrogate(String* s, int index);
• [3065] [VB] Public Shared Function IsSurrogate(ByVal s As String, ByVal index As Integer) As Boolean
• [3066] [JScript] public static function IsSurrogate(s: String, index: int): Boolean;
  Description

[3067] Indicates whether the character at the specified position in a specified String is categorized as a surrogate character.

Return Value: true if the character at position index in s is a surrogate character; otherwise, false.

[3068] Character positions in a String are indexed starting from zero. A System.String. A 32-bit signed integer that specifies a character position in s.

[3069] IsSymbol

• [3070] [C#] public static bool IsSymbol(char c);
• [3071] [C++] public: static bool IsSymbol(_wchar_t c);
• [3072] [VB] Public Shared Function IsSymbol(ByVal c As Char) As Boolean
• [3073] [JScript] public static function IsSymbol(c: Char): Boolean; Indicates whether a Unicode character is categorized as a symbol character.
  Description

[3074] Indicates whether the specified Unicode character is categorized as a symbol character.

Return Value: true if c is a symbol character; otherwise, false.

[3075] Valid symbols are members of the following categories in System.Globalization.UnicodeCategory: MathSymbol, CurrencySymbol, ModifierSymbol, and OtherSymbol. A Unicode character.

[3076] IsSymbol

• [3077] [C#] public static bool IsSymbol(string s, int index);
• [3078] [C++] public: static bool IsSymbol(String* s, int index);
• [3079] [VB] Public Shared Function IsSymbol(ByVal s As String, ByVal index As Integer) As Boolean
• [3080] [JScript] public static function IsSymbol(s: String, index: int): Boolean;
  Description