System.Reflection.Metadata
9.0.0
Prefix Reserved
dotnet add package System.Reflection.Metadata --version 9.0.0
NuGet\Install-Package System.Reflection.Metadata -Version 9.0.0
<PackageReference Include="System.Reflection.Metadata" Version="9.0.0" />
paket add System.Reflection.Metadata --version 9.0.0
#r "nuget: System.Reflection.Metadata, 9.0.0"
// Install System.Reflection.Metadata as a Cake Addin #addin nuget:?package=System.Reflection.Metadata&version=9.0.0 // Install System.Reflection.Metadata as a Cake Tool #tool nuget:?package=System.Reflection.Metadata&version=9.0.0
About
This package provides a low-level .NET (ECMA-335) metadata reader and writer. It's geared for performance and is the ideal choice for building higher-level libraries that intend to provide their own object model, such as compilers. The metadata format is defined by the ECMA-335 - Common Language Infrastructure (CLI) specification and its amendments.
The System.Reflection.Metadata
library is included in the .NET Runtime shared framework. The package can be installed when you need to use it in other target frameworks.
How to Use
The following example shows how to read assembly information using PEReader and MetadataReader.
using System;
using System.IO;
using System.Reflection.Metadata;
using System.Reflection.PortableExecutable;
class Program
{
static void Main()
{
// Open the Portable Executable (PE) file
using var fs = new FileStream("Example.dll", FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
using var peReader = new PEReader(fs);
// Display PE header information
PEHeader header = peReader.PEHeaders.PEHeader;
Console.WriteLine($"Image base: 0x{header.ImageBase:X}");
Console.WriteLine($"File alignment: 0x{header.FileAlignment:X}");
Console.WriteLine($"Subsystem: {header.Subsystem}");
// Display .NET metadata information
if (!peReader.HasMetadata)
{
Console.WriteLine("Image does not contain .NET metadata");
return;
}
MetadataReader mr = peReader.GetMetadataReader();
AssemblyDefinition ad = mr.GetAssemblyDefinition();
Console.WriteLine($"Assembly name: {ad.GetAssemblyName().ToString()}");
Console.WriteLine();
Console.WriteLine("Assembly attributes:");
foreach (CustomAttributeHandle attrHandle in ad.GetCustomAttributes())
{
CustomAttribute attr = mr.GetCustomAttribute(attrHandle);
// Display the attribute type full name
if (attr.Constructor.Kind == HandleKind.MethodDefinition)
{
MethodDefinition mdef = mr.GetMethodDefinition((MethodDefinitionHandle)attr.Constructor);
TypeDefinition tdef = mr.GetTypeDefinition(mdef.GetDeclaringType());
Console.WriteLine($"{mr.GetString(tdef.Namespace)}.{mr.GetString(tdef.Name)}");
}
else if (attr.Constructor.Kind == HandleKind.MemberReference)
{
MemberReference mref = mr.GetMemberReference((MemberReferenceHandle)attr.Constructor);
if (mref.Parent.Kind == HandleKind.TypeReference)
{
TypeReference tref = mr.GetTypeReference((TypeReferenceHandle)mref.Parent);
Console.WriteLine($"{mr.GetString(tref.Namespace)}.{mr.GetString(tref.Name)}");
}
else if (mref.Parent.Kind == HandleKind.TypeDefinition)
{
TypeDefinition tdef = mr.GetTypeDefinition((TypeDefinitionHandle)mref.Parent);
Console.WriteLine($"{mr.GetString(tdef.Namespace)}.{mr.GetString(tdef.Name)}");
}
}
}
}
}
Main Types
The main types provided by this library are:
System.Reflection.Metadata.MetadataReader
System.Reflection.PortableExecutable.PEReader
System.Reflection.Metadata.Ecma335.MetadataBuilder
System.Reflection.PortableExecutable.PEBuilder
System.Reflection.PortableExecutable.ManagedPEBuilder
Additional Documentation
- System.Reflection.Metadata.MetadataReader
- System.Reflection.PortableExecutable.PEReader
- System.Reflection.Metadata.Ecma335.MetadataBuilder
- System.Reflection.PortableExecutable.PEBuilder
- System.Reflection.PortableExecutable.ManagedPEBuilder
Feedback & Contributing
System.Reflection.Metadata is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 is compatible. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETFramework 4.6.2
- System.Collections.Immutable (>= 9.0.0)
- System.Memory (>= 4.5.5)
-
.NETStandard 2.0
- System.Collections.Immutable (>= 9.0.0)
- System.Memory (>= 4.5.5)
-
net8.0
- System.Collections.Immutable (>= 9.0.0)
-
net9.0
- No dependencies.
NuGet packages (305)
Showing the top 5 NuGet packages that depend on System.Reflection.Metadata:
Package | Downloads |
---|---|
Microsoft.TestPlatform.ObjectModel
The Microsoft Test Platform Object Model. |
|
Microsoft.CodeAnalysis.Common
A shared package used by the Microsoft .NET Compiler Platform ("Roslyn"). Do not install this package manually, it will be added as a prerequisite by other packages that require it. More details at https://aka.ms/roslyn-packages This package was built from the source at https://github.com/dotnet/roslyn/commit/dfa7fc6bdea31a858a402168384192b633c811fa. |
|
Microsoft.CodeAnalysis.CSharp
.NET Compiler Platform ("Roslyn") support for C#, Microsoft.CodeAnalysis.CSharp.dll. More details at https://aka.ms/roslyn-packages This package was built from the source at https://github.com/dotnet/roslyn/commit/dfa7fc6bdea31a858a402168384192b633c811fa. |
|
System.Diagnostics.StackTrace
Provides the System.Diagnostics.StackTrace class, which allows interaction with local and remote processes. Commonly Used Types: System.Diagnostics.StackFrame System.Diagnostics.StackTrace When using NuGet 3.x this package requires at least version 3.4. |
|
Microsoft.AspNetCore.Hosting
ASP.NET Core hosting infrastructure and startup logic for web applications. This package was built from the source code at https://github.com/aspnet/AspNetCore/tree/be0a4a7f4cf06cbd6ec714bd1d9afee6bdb040a8 |
GitHub repositories (245)
Showing the top 5 popular GitHub repositories that depend on System.Reflection.Metadata:
Repository | Stars |
---|---|
icsharpcode/ILSpy
.NET Decompiler with support for PDB generation, ReadyToRun, Metadata (&more) - cross-platform!
|
|
dotnet/roslyn
The Roslyn .NET compiler provides C# and Visual Basic languages with rich code analysis APIs.
|
|
DapperLib/Dapper
Dapper - a simple object mapper for .Net
|
|
dotnet/runtime
.NET is a cross-platform runtime for cloud, mobile, desktop, and IoT apps.
|
|
winsw/winsw
A wrapper executable that can run any executable as a Windows service, in a permissive license.
|
Version | Downloads | Last updated | |
---|---|---|---|
9.0.0 | 160,597 | 11/12/2024 | |
9.0.0-rc.2.24473.5 | 5,584 | 10/8/2024 | |
9.0.0-rc.1.24431.7 | 4,101 | 9/10/2024 | |
9.0.0-preview.7.24405.7 | 2,328 | 8/13/2024 | |
9.0.0-preview.6.24327.7 | 3,624 | 7/9/2024 | |
9.0.0-preview.5.24306.7 | 1,877 | 6/11/2024 | |
9.0.0-preview.4.24266.19 | 752 | 5/21/2024 | |
9.0.0-preview.3.24172.9 | 1,673 | 4/11/2024 | |
9.0.0-preview.2.24128.5 | 1,467 | 3/12/2024 | |
9.0.0-preview.1.24080.9 | 4,044 | 2/13/2024 | |
8.0.1 | 287,275 | 10/8/2024 | |
8.0.0 | 16,376,704 | 11/14/2023 | |
8.0.0-rc.2.23479.6 | 3,951 | 10/10/2023 | |
8.0.0-rc.1.23419.4 | 4,071 | 9/12/2023 | |
8.0.0-preview.7.23375.6 | 2,498 | 8/8/2023 | |
8.0.0-preview.6.23329.7 | 2,892 | 7/11/2023 | |
8.0.0-preview.5.23280.8 | 2,768 | 6/13/2023 | |
8.0.0-preview.4.23259.5 | 1,351 | 5/16/2023 | |
8.0.0-preview.3.23174.8 | 1,563 | 4/11/2023 | |
8.0.0-preview.2.23128.3 | 6,856 | 3/14/2023 | |
8.0.0-preview.1.23110.8 | 2,148 | 2/21/2023 | |
7.0.2 | 1,039,573 | 6/13/2023 | |
7.0.1 | 613,466 | 3/14/2023 | |
7.0.0 | 39,680,852 | 11/7/2022 | |
7.0.0-rc.2.22472.3 | 32,771 | 10/11/2022 | |
7.0.0-rc.1.22426.10 | 1,621 | 9/14/2022 | |
7.0.0-preview.7.22375.6 | 4,842 | 8/9/2022 | |
7.0.0-preview.6.22324.4 | 1,593 | 7/12/2022 | |
7.0.0-preview.5.22301.12 | 1,041 | 6/14/2022 | |
7.0.0-preview.4.22229.4 | 11,806 | 5/10/2022 | |
7.0.0-preview.3.22175.4 | 1,017 | 4/13/2022 | |
7.0.0-preview.2.22152.2 | 2,777 | 3/14/2022 | |
7.0.0-preview.1.22076.8 | 1,106 | 2/17/2022 | |
6.0.2 | 891 | 11/12/2024 | |
6.0.1 | 72,279,921 | 3/8/2022 | |
6.0.0 | 32,011,671 | 11/8/2021 | |
6.0.0-rc.2.21480.5 | 1,380 | 10/12/2021 | |
6.0.0-rc.1.21451.13 | 2,322 | 9/14/2021 | |
6.0.0-preview.7.21377.19 | 1,704 | 8/10/2021 | |
6.0.0-preview.6.21352.12 | 1,250 | 7/14/2021 | |
6.0.0-preview.5.21301.5 | 1,191 | 6/15/2021 | |
6.0.0-preview.4.21253.7 | 910 | 5/24/2021 | |
6.0.0-preview.3.21201.4 | 5,736 | 4/8/2021 | |
6.0.0-preview.2.21154.6 | 1,759 | 3/11/2021 | |
6.0.0-preview.1.21102.12 | 1,227 | 2/12/2021 | |
5.0.0 | 252,059,573 | 11/9/2020 | |
5.0.0-rc.2.20475.5 | 15,914 | 10/13/2020 | |
5.0.0-rc.1.20451.14 | 9,195 | 9/14/2020 | |
5.0.0-preview.8.20407.11 | 276,031 | 8/25/2020 | |
5.0.0-preview.7.20364.11 | 4,867 | 7/21/2020 | |
5.0.0-preview.6.20305.6 | 1,921 | 6/25/2020 | |
5.0.0-preview.5.20278.1 | 1,458 | 6/10/2020 | |
5.0.0-preview.4.20251.6 | 2,927 | 5/18/2020 | |
5.0.0-preview.3.20214.6 | 2,019 | 4/23/2020 | |
5.0.0-preview.2.20160.6 | 11,762 | 4/2/2020 | |
5.0.0-preview.1.20120.5 | 10,733 | 3/16/2020 | |
1.8.1 | 12,945,492 | 5/12/2020 | |
1.8.0 | 10,190,185 | 12/3/2019 | |
1.8.0-preview3.19551.4 | 2,230 | 11/13/2019 | |
1.8.0-preview2.19523.17 | 1,326 | 11/1/2019 | |
1.8.0-preview1.19504.10 | 2,394 | 10/15/2019 | |
1.7.0 | 6,889,224 | 9/23/2019 | |
1.7.0-rc1.19456.4 | 3,546 | 9/16/2019 | |
1.7.0-preview9.19421.4 | 2,531 | 9/4/2019 | |
1.7.0-preview9.19416.11 | 961 | 9/4/2019 | |
1.7.0-preview8.19405.3 | 4,082 | 8/13/2019 | |
1.7.0-preview7.19362.9 | 3,434 | 7/23/2019 | |
1.7.0-preview6.19303.8 | 4,885 | 6/12/2019 | |
1.7.0-preview6.19264.9 | 982 | 9/4/2019 | |
1.7.0-preview5.19224.8 | 7,203 | 5/6/2019 | |
1.7.0-preview4.19212.13 | 8,440 | 4/18/2019 | |
1.7.0-preview3.19128.7 | 9,384 | 3/6/2019 | |
1.7.0-preview.19073.11 | 3,195 | 1/29/2019 | |
1.7.0-preview.18571.3 | 11,259 | 12/3/2018 | |
1.6.0 | 733,153,897 | 5/29/2018 | |
1.6.0-rc1 | 334,267 | 5/6/2018 | |
1.6.0-preview2-26406-04 | 380,974 | 4/10/2018 | |
1.6.0-preview1-26216-02 | 290,700 | 2/26/2018 | |
1.5.0 | 52,283,204 | 8/11/2017 | |
1.5.0-preview2-25405-01 | 7,221 | 6/27/2017 | |
1.5.0-preview1-25305-02 | 9,199 | 5/9/2017 | |
1.4.2 | 185,712,069 | 1/3/2017 | |
1.4.1 | 218,776,313 | 11/15/2016 | |
1.4.1-preview1-24530-04 | 108,031 | 10/24/2016 | |
1.4.1-beta-24430-01 | 562,581 | 10/13/2016 | |
1.4.1-beta-24227-04 | 274,582 | 6/30/2016 | |
1.3.0 | 319,392,374 | 6/27/2016 | |
1.3.0-rc2-24027 | 11,345,362 | 5/16/2016 | |
1.2.1-beta-23918 | 5,723 | 3/18/2016 | |
1.2.0 | 2,297,879 | 3/8/2016 | |
1.2.0-rc3-23811 | 46,409 | 3/5/2016 | |
1.2.0-rc2-23826 | 19,161 | 3/1/2016 | |
1.1.1-beta-23516 | 31,446 | 11/18/2015 | |
1.1.0 | 3,636,633 | 10/27/2015 | |
1.1.0-alpha-00015 | 5,463 | 10/9/2015 | |
1.1.0-alpha-00014 | 138,736 | 9/29/2015 | |
1.1.0-alpha-00012 | 5,527 | 9/24/2015 | |
1.1.0-alpha-00009 | 63,267 | 9/3/2015 | |
1.0.23-beta-23409 | 4,643 | 10/15/2015 | |
1.0.23-beta-23225 | 139,406 | 9/2/2015 | |
1.0.22 | 1,544,474 | 7/29/2015 | |
1.0.22-beta-23109 | 4,437 | 7/27/2015 | |
1.0.22-beta-23019 | 4,888 | 6/30/2015 | |
1.0.21 | 6,984,641 | 5/11/2015 | |
1.0.19-rc | 13,493 | 3/6/2015 | |
1.0.18-beta | 671,608 | 12/10/2014 | |
1.0.17-beta | 153,385 | 10/10/2014 |