Overview of Metadata

Metadata is used to describe runtime types (classes, interfaces, and value types), fields, and methods, as well as internal implementation and layout information that is used by the common language runtime (CLR) to JIT-compile Microsoft intermediate language (MSIL), load classes, execute code, and interoperate with the COM classic or native world. The metadata is included with every CLR component, and is available to the runtime, tools, and services.

All manipulation of metadata is performed through the metadata API, which insulates a client (tools and services) from the underlying data structures and enables a pluggable persistence format architecture that allows runtime binary representations, COM classic type libraries, and other formats to be transferred to or from memory transparently.

The metadata API includes interfaces that emit (that is, generate) and import metadata. A client can emit or import metadata in the following ways:

• Compilers and tools emit metadata by calling the "emit" APIs. Metadata is emitted during the compilation and linking process. RAD tools emit metadata as a part of building components or applications. The API members write to and read from in-memory data structures. At save time, these in-memory structures are compressed and persisted in binary format into the target compilation unit (.obj file), executable (.exe) file, or standalone metadata binary file. When multiple compilation units are linked to form an EXE or DLL, the "emit" API members provide a method to merge the metadata sections from each compilation unit into a single integrated metadata binary file.

• The loader and other runtime tools and services import metadata by calling the "import" API members to obtain information about components so that tasks such as loading and activation can be completed.

In This Section

• Metadata API Overview
  Provides general information about the metadata API.

• Metadata Tokens Overview
  Provides information about metadata tokens, which are used to identify abstractions.

• Coding Conventions for Metadata API
  Describes the coding conventions that are used by the metadata API.

• Using the Metadata API and Tokens
  Provides information about the clients that will use the metadata API and explains how each client can use it.

See Also

Concepts

Overview of Metadata

Metadata Interfaces

Metadata Global Static Functions

Metadata Enumerations

Metadata Structures

Metadata Unions

Other Resources

Standard EMCA-335: Common Language Infrastructure (CLI)

ECMA C# and Common Language Infrastructure Standards