System.Reflection.Metadata A strongly-typed resource class, for looking up localized strings, etc. Returns the cached ResourceManager instance used by this class. Overrides the current thread's CurrentUICulture property for all resource lookups using this strongly typed resource class. Looks up a localized string similar to Invalid number of rows of Assembly table: {0}.. Looks up a localized string similar to Can't get a heap offset for a virtual heap handle. Looks up a localized string similar to EnCMap table not sorted or has missing records.. Looks up a localized string similar to Handle belongs to a future generation. Looks up a localized string similar to Illegal tables in compressed metadata stream.. Looks up a localized string similar to Image is too small.. Looks up a localized string similar to Image is either too small or contains an invalid byte offset or count.. Looks up a localized string similar to Invalid coded index.. Looks up a localized string similar to Invalid compressed integer.. Looks up a localized string similar to Invalid COR header size.. Looks up a localized string similar to Invalid handle.. Looks up a localized string similar to Invalid local signature token: 0x{0:X8}. Looks up a localized string similar to Invalid metadata section span.. Looks up a localized string similar to Invalid Metadata stream format.. Looks up a localized string similar to Invalid method header: 0x{0:X2}. Looks up a localized string similar to Invalid method header: 0x{0:X2} 0x{1:X2}. Looks up a localized string similar to Invalid relative virtual address (RVA): 0x{0:X8}. Looks up a localized string similar to Invalid number of sections in declared in PE header.. Looks up a localized string similar to Invalid PE signature.. Looks up a localized string similar to Invalid row count: {0}. Looks up a localized string similar to Invalid section name. Looks up a localized string similar to Invalid SEH header: 0x{0:X2}. Looks up a localized string similar to Invalid serialized string.. Looks up a localized string similar to Invalid signature.. Looks up a localized string similar to Invalid token.. Looks up a localized string similar to Invalid type size.. Looks up a localized string similar to Little-endian architecture required.. Looks up a localized string similar to Metadata header too small.. Looks up a localized string similar to Metadata image doesn't represent an assembly.. Looks up a localized string similar to Invalid COR20 header signature.. Looks up a localized string similar to The MetadataStringDecoder instance used to instantiate the Metadata reader must have a UTF8 encoding.. Looks up a localized string similar to Metadata table header too small.. Looks up a localized string similar to Metadata table 0x{0:x2} not sorted.. Looks up a localized string similar to Metadata tables too small.. Looks up a localized string similar to Missing data directory.. Looks up a localized string similar to Invalid number of rows of Module table: {0}.. Looks up a localized string similar to Negative byte count or offset.. Looks up a localized string similar to Not enough space for Blob stream.. Looks up a localized string similar to Not enough space for GUID stream.. Looks up a localized string similar to Not enough space for Metadata stream.. Looks up a localized string similar to Not enough space for stream header name.. Looks up a localized string similar to Not enough space for String stream.. Looks up a localized string similar to Not enough space for version string.. Looks up a localized string similar to Specified handle is not a valid metadata heap handle.. Looks up a localized string similar to Specified handle is not a valid metadata table handle.. Looks up a localized string similar to Specified handle is not a valid metadata table or UserString heap handle.. Looks up a localized string similar to Read out of bounds.. Looks up a localized string similar to PE image does not have metadata.. Looks up a localized string similar to PE image not available.. Looks up a localized string similar to Row ID or heap offset is too large.. Looks up a localized string similar to Section too small.. Looks up a localized string similar to Stream header too small.. Looks up a localized string similar to Stream must support read and seek operations.. Looks up a localized string similar to Stream length minus starting position is too large to hold a PEImage.. Looks up a localized string similar to Table row count space to small.. Looks up a localized string similar to Unable to read metadata file.. Looks up a localized string similar to Unexpected stream end.. Looks up a localized string similar to Unknown file format.. Looks up a localized string similar to Unknown PE Magic value.. Looks up a localized string similar to Unknown tables: 0x{0:x16}.. Looks up a localized string similar to Missing mscorlib reference in AssemblyRef table.. Represents a disposable blob of memory accessed via unsafe pointer. Returns the content of the memory block. Only creates a copy of the data if they are not represented by a managed byte array, or the offset is non-zero. Disposes the block. The operation is idempotent, but must not be called concurrently with any other operations on the block or with another call to Dispose. Using the block after dispose is an error in our code and therefore no effort is made to throw a tidy ObjectDisposedException and null ref or AV is possible. Pointer to the underlying data (not valid after disposal). Represents a memory block backed by an array of bytes. Creates and hydrates a memory block representing all data. Error while reading from the memory source. Creates and hydrates a memory block representing data in the specified range. Starting offset relative to the beginning of the data represented by this provider. Size of the resulting block. Error while reading from the memory source. Gets a seekable and readable that can be used to read all data. The operations on the stream has to be done under a lock of if non-null. The image starts at and has size . It is the caller's responsibility not to read outside those bounds. The size of the data. Class representing raw memory but not owning the memory. Represents raw memory owned by an external object. Represents memory block allocated on native heap. Owns the native memory resource. Represents data read from a stream. Uses memory map to load data from streams backed by files that are bigger than . Error while reading from the stream. Provides helpers to decode strings from unmanaged memory to System.String while avoiding intermediate allocation. This has three components: (1) Light-up Encoding.GetString(byte*, int) via reflection and resurface it as extension method. This is a new API that will provide API convergence across all platforms for this scenario. It is already on .NET 4.6+ and ASP.NET vNext, but not yet available on every platform we support. See below for how we fall back. (2) Deal with WinRT prefixes. When reading managed winmds with projections enabled, the metadata reader needs to prepend a WinRT prefix in some case . Doing this without allocation poses a problem as we don't have the prefix and input in contiguous data that we can pass to the Encoding.GetString. We handle this case using pooled managed scratch buffers where we copy the prefix and input and decode using Encoding.GetString(byte[], int, int). (3) Deal with platforms that don't yet have Encoding.GetString(byte*, int). If we're running on a full framework earlier than 4.6, we will bind to the internal String.CreateStringFromEncoding which is equivalent and Encoding.GetString is just a trivial wrapper around it in .NET 4.6. This means that we always have the fast path on every full framework version we support. If we can't bind to it via reflection, then we emulate it using what is effectively (2) and with an empty prefix. For both (2) and (3), the pooled buffers have a fixed size deemed large enough for the vast majority of metadata strings. In the rare worst case (byteCount > threshold and (lightUpAttemptFailed || prefix != null), we give up and allocate a temporary array, copy to it, decode, and throw it away. Provides tools for using in interop scenarios. *** WARNING *** If you decide to copy this code elsewhere, please retain the documentation here and the Dangerous prefixes in the API names. This will help track down and audit other places where this technique (with dangerous consequences when misused) may be applied. A generic version of this API was once public in a pre-release of immutable collections, but it was deemed to be too subject to abuse when available publicly. This implementation is scoped to byte arrays as that is all that the metadata reader needs. Also, since we don't have access to immutable collection internals, we use a trick involving overlapping a with a refer. While unverifiable, it is valid. See Ecma 335, section II.10.7 Controlling instance layout: "It is possible to overlap fields in this way, though offsets occupied by an object reference shall not overlap with offsets occupied by a built-in value type or a part of another object reference. While one object reference can completely overlap another, this is unverifiable." Furthermore, the fact that backed by a single field is something inherent to the design of ImmutableArray in order to get its performance characteristics and therefore something we (Microsoft) are comfortable defining as a contract that can be depended upon as below. Creates a new instance of using a given mutable array as the backing field, without creating a defensive copy. It is the responsibility of the caller to ensure no other mutable references exist to the array. Do not mutate the array after calling this method. The mutable array to use as the backing field. The incoming reference is set to null since it should not be retained by the caller. Users of this method should take extra care to ensure that the mutable array given as a parameter is never modified. The returned will use the given array as its backing field without creating a defensive copy, so changes made to the given mutable array will be observable on the returned . Instance and static methods of and may malfunction if they operate on an instance whose underlying backing field is modified. An immutable array. Access the backing mutable array instance for the given , without creating a defensive copy. It is the responsibility of the caller to ensure the array is not modified through the returned mutable reference. Do not mutate the returned array. The from which to retrieve the backing field. Users of this method should take extra care to ensure that the returned mutable array is never modified. The returned mutable array continues to be used as the backing field of the given without creating a defensive copy, so changes made to the returned mutable array will be observable on the given . Instance and static methods of and may malfunction if they operate on an instance whose underlying backing field is modified. The underlying array, or null if is true. Decodes a compressed integer value starting at offset. See Metadata Specification section II.23.2: Blobs and signatures. Offset to the start of the compressed data. Bytes actually read. Value between 0 and 0x1fffffff, or if the value encoding is invalid. Read UTF8 at the given offset up to the given terminator, null terminator, or end-of-block. Offset in to the block where the UTF8 bytes start. UTF8 encoded prefix to prepend to the bytes at the offset before decoding. The UTF8 decoder to use that allows user to adjust fallback and/or reuse existing strings without allocating a new one. The number of bytes read, which includes the terminator if we did not hit the end of the block. A character in the ASCII range that marks the end of the string. If a value other than '\0' is passed we still stop at the null terminator if encountered first. The decoded string. Get number of bytes from offset to given terminator, null terminator, or end-of-block (whichever comes first). Returned length does not include the terminator, but numberOfBytesRead out parameter does. Offset in to the block where the UTF8 bytes start. A character in the ASCII range that marks the end of the string. If a value other than '\0' is passed we still stop at the null terminator if encountered first. The number of bytes read, which includes the terminator if we did not hit the end of the block. Length (byte count) not including terminator. Calculates a range of rows that have specified value in the specified column in a table that is sorted by that column. Calculates a range of rows that have specified value in the specified column in a table that is sorted by that column. Generic implementation of object pooling pattern with predefined pool size limit. The main purpose is that limited number of frequently used objects can be kept in the pool for further recycling. Notes: 1) it is not the goal to keep all returned objects. Pool is not meant for storage. If there is no space in the pool, extra returned objects will be dropped. 2) it is implied that if object was obtained from a pool, the caller will return it back in a relatively short time. Keeping checked out objects for long durations is ok, but reduces usefulness of pooling. Just new up your own. Not returning objects to the pool in not detrimental to the pool's work, but is a bad practice. Rationale: If there is no intent for reusing the object, do not use pool - just use "new". Produces an instance. Search strategy is a simple linear probing which is chosen for it cache-friendliness. Note that Free will try to store recycled objects close to the start thus statistically reducing how far we will typically search. Returns objects to the pool. Search strategy is a simple linear probing which is chosen for it cache-friendliness. Note that Free will try to store recycled objects close to the start thus statistically reducing how far we will typically search in Allocate. Copies specified amount of data from given stream to a target memory pointer. unexpected stream end. True if the file contains metadata. Corresponds to Flags field of File table in ECMA-335 Standard. File name with extension. Corresponds to Name field of File table in ECMA-335 Standard. Hash value of the file content calculated using . Corresponds to HashValue field of File table in ECMA-335 Standard. An array containing the '\0' character. Reads UTF8 encoded string starting at the current position. The number of bytes to read. The string. bytes not available. Reads UTF16 (little-endian) encoded string starting at the current position. The number of bytes to read. The string. bytes not available. Reads bytes starting at the current position. The number of bytes to read. The byte array. bytes not available. Reads an unsigned compressed integer value. See Metadata Specification section II.23.2: Blobs and signatures. The value of the compressed integer that was read. true if the value was read successfully. false if the data at the current position was not a valid compressed integer. Reads an unsigned compressed integer value. See Metadata Specification section II.23.2: Blobs and signatures. The value of the compressed integer that was read. The data at the current position was not a valid compressed integer. Reads a signed compressed integer value. See Metadata Specification section II.23.2: Blobs and signatures. The value of the compressed integer that was read. true if the value was read successfully. false if the data at the current position was not a valid compressed integer. Reads a signed compressed integer value. See Metadata Specification section II.23.2: Blobs and signatures. The value of the compressed integer that was read. The data at the current position was not a valid compressed integer. Reads type code encoded in a serialized custom attribute value. if the encoding is invalid. Reads type code encoded in a signature. if the encoding is invalid. Reads a string encoded as a compressed integer containing its length followed by its contents in UTF8. Null strings are encoded as a single 0xFF byte. Defined as a 'SerString' in the Ecma CLI specification. String value or null. If the encoding is invalid. Reads a type handle encoded in a signature as TypeDefOrRefOrSpecEncoded (see ECMA-335 II.23.2.8). The handle or nil if the encoding is invalid. The type of the constant value. Corresponds to Type field of Constant table in ECMA-335 Standard. The constant value. Corresponds to Value field of Constant table in ECMA-335 Standard. The parent handle (, , or ). Corresponds to Parent field of Constant table in ECMA-335 Standard. The constructor ( or ) of the custom attribute type. Corresponds to Type field of CustomAttribute table in ECMA-335 Standard. The handle of the metadata entity the attribute is applied to. Corresponds to Parent field of CustomAttribute table in ECMA-335 Standard. The value of the attribute. Corresponds to Value field of CustomAttribute table in ECMA-335 Standard. Provides an extension method to access the TypeDefinitionId column of the ExportedType table. Gets a hint at the likely row number of the target type in the TypeDef table of its module. If the namespaces and names do not match, resolution falls back to a full search of the target TypeDef table. Ignored and should be zero if is true. Provides extension methods for working with certain raw elements of the Ecma 335 metadata tables and heaps. Returns the number of rows in the specified table. is null. is not a valid table index. Returns the size of a row in the specified table. is null. is not a valid table index. Returns the offset from the start of metadata to the specified table. is null. is not a valid table index. Returns the size of the specified heap. is null. is not a valid heap index. Returns the offset from the start of metadata to the specified heap. is null. is not a valid heap index. Returns the size of the specified heap. is null. is not a valid heap index. Returns the a handle to the UserString that follows the given one in the UserString heap or a nil handle if it is the last one. is null. Returns the a handle to the Blob that follows the given one in the Blob heap or a nil handle if it is the last one. is null. Returns the a handle to the String that follows the given one in the String heap or a nil handle if it is the last one. is null. Enumerates entries of EnC log. is null. Enumerates entries of EnC map. is null. Enumerate types that define one or more properties. The resulting sequence corresponds exactly to entries in PropertyMap table, i.e. n-th returned is stored in n-th row of PropertyMap. Enumerate types that define one or more events. The resulting sequence corresponds exactly to entries in EventMap table, i.e. n-th returned is stored in n-th row of EventMap. Maximum number of tables that can be present in Ecma335 metadata. Maximum number of tables that can be present in Ecma335 metadata. Returns the row number of a metadata table entry that corresponds to the specified in the context of . One based row number. The is not a valid metadata table handle. Returns the offset of metadata heap data that corresponds to the specified in the context of . Zero based offset, or -1 if isn't a metadata heap handle. The operation is not supported for the specified . The is invalid. Returns the metadata token of the specified in the context of . Metadata token. Handle represents a metadata entity that doesn't have a token. A token can only be retrieved for a metadata table handle or a heap handle of type . The operation is not supported for the specified . Returns the row number of a metadata table entry that corresponds to the specified . One based row number, or -1 if can only be interpreted in a context of a specific . See . Returns the offset of metadata heap data that corresponds to the specified . Zero based offset, or -1 if can only be interpreted in a context of a specific . See . Returns the metadata token of the specified . Metadata token, or 0 if can only be interpreted in a context of a specific . See . Handle represents a metadata entity that doesn't have a token. A token can only be retrieved for a metadata table handle or a heap handle of type . Gets the of the table corresponding to the specified . Handle type. Table index. True if the handle type corresponds to an Ecma335 table, false otherwise. Gets the of the heap corresponding to the specified . Handle type. Heap index. True if the handle type corresponds to an Ecma335 heap, false otherwise. Creates a handle from a token value. is not a valid metadata token. It must encode a metadata table entity or an offset in heap. Creates an entity handle from a token value. is not a valid metadata entity token. Creates a handle from a token value. is not a valid table index. Start IL offset of the try block. Length in bytes of try block. Start IL offset of the exception handler. Length in bytes of the exception handler. IL offset of the start of the filter block, or -1 if the region is not a filter. Returns a TypeRef, TypeDef, or TypeSpec handle if the region represents a catch, nil token otherwise. Name of the target type, or nil if the type is nested or defined in a root namespace. Full name of the namespace where the target type, or nil if the type is nested or defined in a root namespace. The definition handle of the namespace where the target type is defined, or nil if the type is nested or defined in a root namespace. Handle to resolve the implementation of the target type. representing another module in the assembly. representing another assembly if is true. representing the declaring exported type in which this was is nested. Returns field layout offset, or -1 if not available. or . Corresponds to Owner field of GenericParam table in ECMA-335 Standard. Attributes specifying variance and constraints. Corresponds to Flags field of GenericParam table in ECMA-335 Standard. Zero-based index of the parameter within the declaring generic type or method declaration. Corresponds to Number field of GenericParam table in ECMA-335 Standard. The name of the generic parameter. Corresponds to Name field of GenericParam table in ECMA-335 Standard. The constrained . Corresponds to Owner field of GenericParamConstraint table in ECMA-335 Standard. Handle (, , or ) specifying from which type this generic parameter is constrained to derive, or which interface this generic parameter is constrained to implement. Corresponds to Constraint field of GenericParamConstraint table in ECMA-335 Standard. Represents generic type parameters of a method or type. Represents constraints of a generic type parameter. Collection of parameters of a specified method. Represents a collection of . Represents a collection of . Represents a collection of . Represents a collection of . Collection of assembly references. Represents a collection of . Represents a collection of . Compares two handles. The order of handles that differ in kind is undefined. Returns 0 if and only if returns true. Compares two entity handles. The order of handles that differ in kind is undefined. Returns 0 if and only if returns true. Represents any metadata entity (type reference/definition/specification, method definition, custom attribute, etc.) or value (string, blob, guid, user string). Use to store multiple kinds of handles. Creates from a token or a token combined with a virtual flag. Token type (0x##000000), does not include virtual flag. Small token type (0x##), does not include virtual flag. Value stored in an . Value stored in a concrete entity handle (see , , etc.). Represents a metadata entity (type reference/definition/specification, method definition, custom attribute, etc.). Use to store multiple kinds of entity handles. It has smaller memory footprint than . Value stored in a specific entity handle (see , , etc.). A handle that represents a namespace definition. The interface that is implemented , , or Returns true if the given raw (non-virtual) handle represents the same string as given ASCII string. Returns the heap index of the given ASCII character or -1 if not found prior null terminator or end of heap. Returns true if the given raw (non-virtual) handle represents a string that starts with given ASCII prefix. Equivalent to Array.BinarySearch, searches for given raw (non-virtual) handle in given array of ASCII strings. Use the highest bit to mark tokens that are virtual (synthesized). We create virtual tokens to represent projected WinMD entities. Use the highest bit to mark tokens that are virtual (synthesized). We create virtual tokens to represent projected WinMD entities. Returns true if the token value can escape the metadata reader. We don't allow virtual tokens and heap tokens other than UserString to escape since the token type ids are internal to the reader and not specified by ECMA spec. Spec (Partition III, 1.9 Metadata tokens): Many CIL instructions are followed by a "metadata token". This is a 4-byte value, that specifies a row in a metadata table, or a starting byte offset in the User String heap. For example, a value of 0x02 specifies the TypeDef table; a value of 0x70 specifies the User String heap.The value corresponds to the number assigned to that metadata table (see Partition II for the full list of tables) or to 0x70 for the User String heap.The least-significant 3 bytes specify the target row within that metadata table, or starting byte offset within the User String heap. This will return a StringHandle for the simple name of a namespace name at the given segment index. If no segment index is passed explicitly or the "segment" index is greater than or equal to the number of segments, then the last segment is used. "Segment" in this context refers to part of a namespace name between dots. Example: Given a NamespaceDefinitionHandle to "System.Collections.Generic.Test" called 'handle': reader.GetString(GetSimpleName(handle)) == "Test" reader.GetString(GetSimpleName(handle, 0)) == "System" reader.GetString(GetSimpleName(handle, 1)) == "Collections" reader.GetString(GetSimpleName(handle, 2)) == "Generic" reader.GetString(GetSimpleName(handle, 3)) == "Test" reader.GetString(GetSimpleName(handle, 1000)) == "Test" Two distinct namespace handles represent the same namespace if their full names are the same. This method merges builders corresponding to such namespace handles. This will take 'table' and merge all of the NamespaceData instances that point to the same namespace. It has to create 'stringTable' as an intermediate dictionary, so it will hand it back to the caller should the caller want to use it. Creates a NamespaceDataBuilder instance that contains a synthesized NamespaceDefinitionHandle, as well as the name provided. Quick convenience method that handles linking together child + parent Links a child to its parent namespace. If the parent namespace doesn't exist, this will create a synthetic one. This will automatically link any synthetic namespaces it creates up to its parents. This will link all parents/children in the given namespaces dictionary up to each other. In some cases, we need to synthesize namespaces that do not have any type definitions or forwarders of their own, but do have child namespaces. These are returned via the syntheticNamespaces out parameter. Loops through all type definitions in metadata, adding them to the given table Loops through all type forwarders in metadata, adding them to the given table Populates namespaceList with distinct namespaces. No ordering is guaranteed. If the namespace table doesn't exist, populates it! If the namespace list doesn't exist, populates it! Returns whether the namespaceTable has been created. If it hasn't, calling a GetXXX method on this will probably have a very high amount of overhead. An intermediate class used to build NamespaceData instances. This was created because we wanted to use ImmutableArrays in NamespaceData, but having ArrayBuilders and ImmutableArrays that served the same purpose in NamespaceData got ugly. With the current design of how we create our Namespace dictionary, this needs to be a class because we have a many-to-one mapping between NamespaceHandles and NamespaceData. So, the pointer semantics must be preserved. This class assumes that the builders will not be modified in any way after the first call to Freeze(). Returns a NamespaceData that represents this NamespaceDataBuilder instance. After calling this method, it is an error to use any methods or fields except Freeze() on the target NamespaceDataBuilder. Returns field offset for given field RowId, or -1 if not available. In CLI metadata equal to the actual number of entries in AssemblyRef table. In WinMD metadata it includes synthesized AssemblyRefs in addition. Specifies the byte offset within the referenced file at which this resource record begins. Corresponds to Offset field of ManifestResource table in ECMA-335 Standard. Resource attributes. Corresponds to Flags field of ManifestResource table in ECMA-335 Standard. Name of the resource. Corresponds to Name field of ManifestResource table in ECMA-335 Standard. , , or nil handle. Corresponds to Implementation field of ManifestResource table in ECMA-335 Standard. If nil then is an offset in the PE image that contains the metadata, starting from the Resource entry in the CLI header. Determines if the member reference is to a method or field. MethodDef, ModuleRef,TypeDef, TypeRef, or TypeSpec handle. Indicates whether a MemberReference references a method or field. The MemberReference references a method. The MemberReference references a field. CLI metadata. Windows Metadata. Windows Metadata generated by managed compilers. Reads metadata as defined byte the ECMA 335 CLI specification. Creates a metadata reader from the metadata stored at the given memory location. The memory is owned by the caller and it must be kept memory alive and unmodified throughout the lifetime of the . Creates a metadata reader from the metadata stored at the given memory location. The memory is owned by the caller and it must be kept memory alive and unmodified throughout the lifetime of the . Use to obtain metadata from a PE image. Creates a metadata reader from the metadata stored at the given memory location. The memory is owned by the caller and it must be kept memory alive and unmodified throughout the lifetime of the . Use to obtain metadata from a PE image. True if the metadata stream has minimal delta format. Used for EnC. The metadata stream has minimal delta format if "#JTD" stream is present. Minimal delta format uses large size (4B) when encoding table/heap references. The heaps in minimal delta only contain data of the delta, there is no padding at the beginning of the heaps that would align them with the original full metadata heaps. Looks like this function reads beginning of the header described in Ecma-335 24.2.1 Metadata root Reads stream headers described in Ecma-335 24.2.2 Stream header A row count for each possible table. May be indexed by . Returns an array of types nested in the specified type. The backing field of a WinRT enumeration type is not public although the backing fields of managed enumerations are. To allow managed languages to directly access this field, it is made public by the metadata adapter. We want to know if a given method implements a redirected interface. For example, if we are given the method RemoveAt on a class "A" which implements the IVector interface (which is redirected to IList in .NET) then this method would return true. The most likely reason why we would want to know this is that we wish to hide (mark private) all methods which implement methods on a redirected interface. The declaration token for the method Returns true if the redirected interface is . True if the method implements a method on a redirected interface. False otherwise. Returns the type definition or reference handle of the attribute type. or or nil token if the metadata is invalid and the type can't be determined. All options are disabled. The options that are used when a is obtained via an overload that does not take a argument. Windows Runtime projections are enabled (on by default). Provides string comparison helpers to query strings in metadata while avoiding allocation where possible. No allocation is performed unless both the handle argument and the value argument contain non-ascii text. Obtain instances using . A default-initialized instance is useless and behaves as a null reference. The code is optimized such that there is no additional overhead in re-obtaining a a comparer over hoisting it in to a local. That is to say that a construct like: if (reader.StringComparer.Equals(typeDef.Namespace, "System") && reader.StringComparer.Equals(typeDef.Name, "Object") { // found System.Object } is no less efficient than: var comparer = reader.StringComparer; if (comparer.Equals(typeDef.Namespace, "System") && comparer.Equals(typeDef.Name, "Object") { // found System.Object } The choice between them is therefore one of style and not performance. Provides the with a custom mechanism for decoding byte sequences in metadata that represent text. This can be used for the following purposes: 1) To customize the treatment of invalid input. When no decoder is provided, the uses the default fallback replacement with \uFFFD) 2) To reuse existing strings instead of allocating a new one for each decoding operation. Creates a for the given encoding. The encoding to use. To cache and reuse existing strings. Create a derived class and override The mechanism through which the obtains strings for byte sequences in metadata. Override this to cache strings if required. Otherwise, it is implemented by forwarding straight to and every call will allocate a new string. Pointer to bytes to decode. Number of bytes to decode. The decoded string. The default decoder used by to decode UTF-8 when no decoder is provided to the constructor. Gets the encoding used by this instance. Size of the method body - includes the header, IL and exception regions. MethodDef or MemberRef handle specifying to which generic method this refers, that is which generic method is it an instantiation of. Blob handle holding the signature of this instantiation. Gets the unqualified name of the NamespaceDefinition. Gets the parent namespace. Gets the namespace definitions that are direct children of the current namespace definition. System.Collections and System.Linq are direct children of System. System.Collections.Generic is a direct child of System.Collections. System.Collections.Generic is *not* a direct child of System. Gets all type definitions that reside directly in a namespace. Gets all exported types that reside directly in a namespace. Returns a body block of a method with specified Relative Virtual Address (RVA); is null. The body is not found in the metadata or is invalid. Section where the method is stored is not available. Gets a from a . The caller must keep the alive and undisposed throughout the lifetime of the metadata reader. Gets a from a . The caller must keep the alive and undisposed throughout the lifetime of the metadata reader. Gets a from a . The caller must keep the alive and undisposed throughout the lifetime of the metadata reader. Equivalent to . Equivalent to . Equivalent to . Equivalent to . Equivalent to . Equivalent to . Equivalent to . Equivalent to . Equivalent to . Equivalent to . Equivalent to . Equivalent to . Equivalent to . Equivalent to . Equivalent to . The attribute argument is a System.Type instance. The attribute argument is "boxed" (passed to a parameter, field, or property of type object) and carries type information in the attribute blob. The attribute argument is an Enum instance. Specified additional flags that can be applied to method signatures. Underlying values correspond to the representation in the leading signature byte represented by . No flags. Generic method. Instance method. Ecma 335 CLI Specification refers to this flag as HAS_THIS. The first explicitly declared parameter represents the instance pointer. Specifies how arguments in a given signature are passed from the caller to the callee. Underlying values correspond to the representation in the leading signature byte represented by . Managed calling convention with fixed-length argument list. Unmanaged C/C++-style calling convention where the call stack is cleaned by the caller. Unmanaged calling convention where call stack is cleaned up by the callee. Unmanaged C++-style calling convention for calling instance member functions with a fixed argument list. Unmanaged calling convention where arguments are passed in registers when possible. Managed calling convention for passing extra arguments. Represents the signature characteristics specified by the leading byte of signature blobs. This header byte is present in all method definition, method reference, standalone method, field, property, and local variable signatures, but not in type specification signatures. Specifies the signature kind. Underlying values correspond to the representation in the leading signature byte represented by . Method reference, method definition, or standalone method signature. Field signature. Local variables signature. Property signature. Method specification signature. Represents the type codes that are used in signature encoding. Represents an invalid or uninitialized type code. It will not appear in valid signatures. Represents in signatures. Represents in signatures. Represents in signatures. Represents in signatures. Represents in signatures. Represents in signatures. Represents in signatures. Represents in signatures. Represents in signatures. Represents in signatures. Represents in signatures. Represents in signatures. Represents in signatures. Represents in signatures. Represents a unmanaged pointers in signatures. It is followed in the blob by the signature encoding of the underlying type. Represents managed pointers (byref return values and parameters) in signatures. It is followed in the blob by the signature encoding of the underlying type. Represents a generic type parameter used within a signature. Represents a generalized in signatures. Represents the instantiation of a generic type in signatures. Represents a System.TypedReference in signatures. Represents a in signatures. Represents a in signatures. Represents function pointer types in signatures. Represents Represents a single dimensional with 0 lower bound. Represents a generic method parameter used within a signature. Represents a custom modifier applied to a type within a signature that the caller must understand. Represents a custom modifier applied to a type within a signature that the caller can ignore. Precedes a type in signatures. In raw metadata, this will be encoded as either ELEMENT_TYPE_CLASS (0x12) for reference types and ELEMENT_TYPE_VALUETYPE (0x11) for value types. This is collapsed to a single code because Windows Runtime projections can project from class to value type or vice-versa and the raw code is misleading in those cases. Represents a marker to indicate the end of fixed arguments and the beginning of variable arguments. Represents a local variable that is pinned by garbage collector Returns the enclosing type of a specified nested type or nil handle if the type is not nested. Returns an array of types nested in the specified type. Name of the type. Full name of the namespace where the type is defined, or nil if the type is nested or defined in a root namespace. The definition handle of the namespace where the type is defined, or nil if the type is nested or defined in a root namespace. The base type of the type definition: either , or . Resolution scope in which the target type is defined and is uniquely identified by the specified and . Resolution scope can be one of the following handles: of the enclosing type, if the target type is a nested type. , if the target type is defined in another module within the same assembly as this one. , if the target type is defined in the current module. This should not occur in a CLI compressed metadata module. , if the target type is defined in a different assembly from the current module. Nil handle if the target type must be resolved by searching the for a matching and . Name of the target type. Full name of the namespace where the target type is defined, or nil if the type is nested or defined in a root namespace. The type of target machine. The number of sections. This indicates the size of the section table, which immediately follows the headers. The low 32 bits of the number of seconds since 00:00 January 1, 1970, that indicates when the file was created. The file pointer to the COFF symbol table, or zero if no COFF symbol table is present. This value should be zero for a PE image. The number of entries in the symbol table. This data can be used to locate the string table, which immediately follows the symbol table. This value should be zero for a PE image. The size of the optional header, which is required for executable files but not for object files. This value should be zero for an object file. The flags that indicate the attributes of the file. COR20Flags The target CPU is unknown or not specified. Intel 386. MIPS little-endian WCE v2 Alpha Hitachi SH3 little endian Hitachi SH3 DSP. Hitachi SH3 little endian. Hitachi SH4 little endian. Hitachi SH5. ARM little endian Thumb. ARM Thumb-2 little endian. Matsushita AM33. IBM PowerPC little endian. PowerPCFP Intel 64 MIPS ALPHA64 MIPS with FPU. MIPS16 with FPU. Infineon EFI Byte Code AMD64 (K8) M32R little-endian Simple BinaryReader wrapper to: 1) throw BadImageFormat instead of EndOfStream or ArgumentOutOfRange. 2) limit reads to a subset of the base stream. Only methods that are needed to read PE headers are implemented. Resolve image size as either the given user-specified size or distance from current position to end-of-stream. Also performs the relevant argument validation and publicly visible caller has same argument names. size is null and distance from current position to end-of-stream can't fit in Int32. Size is negative or extends past the end-of-stream from current position. Identifies the format of the image file. The linker major version number. The linker minor version number. The size of the code (text) section, or the sum of all code sections if there are multiple sections. The size of the initialized data section, or the sum of all such sections if there are multiple data sections. The size of the uninitialized data section (BSS), or the sum of all such sections if there are multiple BSS sections. The address of the entry point relative to the image base when the PE file is loaded into memory. For program images, this is the starting address. For device drivers, this is the address of the initialization function. An entry point is optional for DLLs. When no entry point is present, this field must be zero. The address that is relative to the image base of the beginning-of-code section when it is loaded into memory. The address that is relative to the image base of the beginning-of-data section when it is loaded into memory. The preferred address of the first byte of image when loaded into memory; must be a multiple of 64K. The alignment (in bytes) of sections when they are loaded into memory. It must be greater than or equal to . The default is the page size for the architecture. The alignment factor (in bytes) that is used to align the raw data of sections in the image file. The value should be a power of 2 between 512 and 64K, inclusive. The default is 512. If the is less than the architecture's page size, then must match . The major version number of the required operating system. The minor version number of the required operating system. The major version number of the image. The minor version number of the image. The major version number of the subsystem. The minor version number of the subsystem. The size (in bytes) of the image, including all headers, as the image is loaded in memory. It must be a multiple of . The combined size of an MS DOS stub, PE header, and section headers rounded up to a multiple of FileAlignment. The image file checksum. The subsystem that is required to run this image. The size of the stack to reserve. Only is committed; the rest is made available one page at a time until the reserve size is reached. The size of the stack to commit. The size of the local heap space to reserve. Only is committed; the rest is made available one page at a time until the reserve size is reached. The size of the local heap space to commit. The number of data-directory entries in the remainder of the . Each describes a location and size. The Certificate Table entry points to a table of attribute certificates. These certificates are not loaded into memory as part of the image. As such, the first field of this entry, which is normally an RVA, is a file pointer instead. An object used to read PE (Portable Executable) and COFF (Common Object File Format) headers from a stream. Reads PE headers from the current location in the stream. Stream containing PE image starting at the stream's current position and ending at the end of the stream. The data read from stream have invalid format. Error reading from the stream. The stream doesn't support seek operations. is null. Reads PE headers from the current location in the stream. Stream containing PE image of the given size starting at its current position. Size of the PE image. The data read from stream have invalid format. Error reading from the stream. The stream doesn't support seek operations. is null. Size is negative or extends past the end of the stream. Gets the offset (in bytes) from the start of the image to the given directory entry. The section containing the directory could not be found. The section containing the Searches sections of the PE image for the one that contains specified Relative Virtual Address. Address. Index of the section that contains , or -1 if there is none. Gets the offset (in bytes) from the start of the PE image to the start of the CLI metadata. or -1 if the image does not contain metadata. Gets the size of the CLI metadata 0 if the image does not contain metadata.) Gets the COFF header of the image. Gets the byte offset from the start of the PE image to the start of the COFF header. Determines if the image is Coff only. Gets the PE header of the image or null if the image is COFF only. Gets the byte offset from the start of the image to Gets the PE section headers. Gets the CLI header or null if the image does not have one. Gets the byte offset from the start of the image to the COR header or -1 if the image does not have one. Determines if the image represents a Windows console application. Determines if the image represents a dynamically linked library. Determines if the image represents an executable. Portable Executable format reader. The implementation is thread-safe, that is multiple threads can read data from the reader in parallel. Disposal of the reader is not thread-safe (see ). Creates a Portable Executable reader over a PE image stored in memory. Pointer to the start of the PE image. The size of the PE image. is . is negative. The memory is owned by the caller and not released on disposal of the . The caller is responsible for keeping the memory alive and unmodified throughout the lifetime of the . The content of the image is not read during the construction of the Creates a Portable Executable reader over a PE image stored in a stream. PE image stream. is null. is specified and the PE headers of the image are invalid. Ownership of the stream is transferred to the upon successful validation of constructor arguments. It will be disposed by the and the caller must not manipulate it. Creates a Portable Executable reader over a PE image stored in a stream beginning at its current position and ending at the end of the stream. PE image stream. Options specifying how sections of the PE image are read from the stream. Unless is specified, ownership of the stream is transferred to the upon successful argument validation. It will be disposed by the and the caller must not manipulate it. Unless or is specified no data is read from the stream during the construction of the . Furthermore, the stream must not be manipulated by caller while the is alive and undisposed. If or , the will have read all of the data requested during construction. As such, if is also specified, the caller retains full ownership of the stream and is assured that it will not be manipulated by the after construction. is null. has an invalid value. is specified and the PE headers of the image are invalid. Creates a Portable Executable reader over a PE image of the given size beginning at the stream's current position. PE image stream. PE image size. Options specifying how sections of the PE image are read from the stream. Unless is specified, ownership of the stream is transferred to the upon successful argument validation. It will be disposed by the and the caller must not manipulate it. Unless or is specified no data is read from the stream during the construction of the . Furthermore, the stream must not be manipulated by caller while the is alive and undisposed. If or , the will have read all of the data requested during construction. As such, if is also specified, the caller retains full ownership of the stream and is assured that it will not be manipulated by the after construction. Size is negative or extends past the end of the stream. Creates a Portable Executable reader over a PE image stored in a byte array. PE image. The content of the image is not read during the construction of the is null. Disposes all memory allocated by the reader. can be called multiple times (but not in parallel). It is not safe to call in parallel with any other operation on the or reading from s retrieved from the reader. Returns a view of the entire image as a pointer and length. PE image not available. Gets a pointer to and size of the PE image if available (). The entire PE image is not available. Loads PE section that contains CLI metadata. The PE image doesn't contain metadata ( returns false). The PE headers contain invalid data. Loads PE section that contains the specified into memory and returns a memory block that starts at and ends at the end of the containing section. Relative Virtual Address of the data to read. An empty block if doesn't represent a location in any of the PE sections of this PE image. The PE headers contain invalid data. Gets the PE headers. The headers contain invalid data. Return true if the reader can access the entire PE image. Returns false if the is constructed from a stream and only part of it is prefetched into memory. Returns true if the PE image contains CLI metadata. The PE headers contain invalid data. By default the stream is disposed when is disposed and sections of the PE image are read lazily. Keep the stream open when the is disposed. Reads metadata section into memory right away. Reading from other sections of the file is not allowed ( is thrown by the ). The underlying file may be closed and even deleted after is constructed. closes the stream automatically by the time the constructor returns unless is specified. Reads the entire image into memory right away. closes the stream automatically by the time the constructor returns unless is specified. An 8-byte, null-padded UTF-8 encoded string. If the string is exactly 8 characters long, there is no terminating null. The total size of the section when loaded into memory. If this value is greater than , the section is zero-padded. This field is valid only for PE images and should be set to zero for object files. For PE images, the address of the first byte of the section relative to the image base when the section is loaded into memory. For object files, this field is the address of the first byte before relocation is applied; for simplicity, compilers should set this to zero. Otherwise, it is an arbitrary value that is subtracted from offsets during relocation. The size of the section (for object files) or the size of the initialized data on disk (for image files). For PE images, this must be a multiple of . If this is less than , the remainder of the section is zero-filled. Because the field is rounded but the field is not, it is possible for to be greater than as well. When a section contains only uninitialized data, this field should be zero. The file pointer to the first page of the section within the COFF file. For PE images, this must be a multiple of . For object files, the value should be aligned on a 4 byte boundary for best performance. When a section contains only uninitialized data, this field should be zero. The file pointer to the beginning of relocation entries for the section. This is set to zero for PE images or if there are no relocations. The file pointer to the beginning of line-number entries for the section. This is set to zero if there are no COFF line numbers. This value should be zero for an image because COFF debugging information is deprecated. The number of relocation entries for the section. This is set to zero for PE images. The number of line-number entries for the section. This value should be zero for an image because COFF debugging information is deprecated. The flags that describe the characteristics of the section. Used to modify the value of the property. CLS-compliant setters are named with set_ prefix. Used to read the value of the property. CLS-compliant getters are named with get_ prefix. Other method for property (not getter or setter) or event (not adder, remover, or raiser). Used to add a handler for an event. Corresponds to the AddOn flag in the Ecma 335 CLI specification. CLS-compliant adders are named with add_ prefix. Used to remove a handler for an event. Corresponds to the RemoveOn flag in the Ecma 335 CLI specification. CLS-compliant removers are named with remove_ prefix. Used to indicate that an event has occurred. Corresponds to the Fire flag in the Ecma 335 CLI specification. CLS-compliant raisers are named with raise_ prefix. Specifies the security actions that can be performed using declarative security. No declarative security action. Check that all callers in the call chain have been granted specified permission, The calling code can access the resource identified by the current permission object, even if callers higher in the stack have not been granted permission to access the resource. Without further checks refuse Demand for the specified permission. Without further checks, refuse Demand for all permissions other than those specified. Check that the immediate caller has been granted the specified permission; The derived class inheriting the class or overriding a method is required to have been granted the specified permission. The request for the minimum permissions required for code to run. This action can only be used within the scope of the assembly. The request for additional permissions that are optional (not required to run). This request implicitly refuses all other permissions not specifically requested. This action can only be used within the scope of the assembly. The request that permissions that might be misused will not be granted to the calling code. This action can only be used within the scope of the assembly. The Resource is exported from the Assembly The Resource is not exported from the Assembly Masks just the visibility-related attributes. Specifies all the hash algorithms used for hashing assembly files and for generating the strong name. A mask indicating that there is no hash algorithm. If you specify None for a multi-module assembly, the common language runtime defaults to the SHA1 algorithm, since multi-module assemblies need to generate a hash. Retrieves the MD5 message-digest algorithm. MD5 was developed by Rivest in 1991. It is basically MD4 with safety-belts and while it is slightly slower than MD4, it helps provide more security. The algorithm consists of four distinct rounds, which has a slightly different design from that of MD4. Message-digest size, as well as padding requirements, remain the same. Retrieves a revision of the Secure Hash Algorithm that corrects an unpublished flaw in SHA. Retrieves a version of the Secure Hash Algorithm with a hash size of 256 bits. Retrieves a version of the Secure Hash Algorithm with a hash size of 384 bits. Retrieves a version of the Secure Hash Algorithm with a hash size of 512 bits. The assembly reference holds the full (unhashed) public key. Not applicable on assembly definition. The implementation of the referenced assembly used at runtime is not expected to match the version seen at compile time. The assembly contains Windows Runtime code. Content type mask. Masked bits correspond to values of . Specifies that just-in-time (JIT) compiler optimization is disabled for the assembly. Specifies that just-in-time (JIT) compiler tracking is enabled for the assembly.