1 <?xml version="1.0" encoding="utf-8"?>
4 <name>System.Runtime.Loader</name>
7 <member name="T:System.Reflection.Metadata.AssemblyExtensions" />
8 <member name="M:System.Reflection.Metadata.AssemblyExtensions.TryGetRawMetadata(System.Reflection.Assembly,System.Byte*@,System.Int32@)">
9 <param name="assembly" />
11 <param name="length" />
13 <member name="T:System.Reflection.Metadata.MetadataUpdateHandlerAttribute">
14 <summary>Indicates that a type that should receive notifications of metadata updates.</summary>
16 <member name="M:System.Reflection.Metadata.MetadataUpdateHandlerAttribute.#ctor(System.Type)">
17 <summary>Initializes the attribute.</summary>
18 <param name="handlerType">A type that handles metadata updates and that should be notified when any occur.</param>
20 <member name="P:System.Reflection.Metadata.MetadataUpdateHandlerAttribute.HandlerType">
21 <summary>Gets the type that handles metadata updates and that should be notified when any occur.</summary>
23 <member name="T:System.Reflection.Metadata.MetadataUpdater" />
24 <member name="M:System.Reflection.Metadata.MetadataUpdater.ApplyUpdate(System.Reflection.Assembly,System.ReadOnlySpan{System.Byte},System.ReadOnlySpan{System.Byte},System.ReadOnlySpan{System.Byte})">
25 <summary>Updates the specified assembly using the provided metadata, IL, and PDB deltas.</summary>
26 <param name="assembly">The assembly to update.</param>
27 <param name="metadataDelta">The metadata changes to be applied.</param>
28 <param name="ilDelta">The IL changes to be applied.</param>
29 <param name="pdbDelta">The PDB changes to be applied.</param>
30 <exception cref="T:System.ArgumentException">The assembly argument is not a runtime assembly.</exception>
31 <exception cref="T:System.ArgumentNullException">The assembly argument is <see langword="null" />.</exception>
32 <exception cref="T:System.InvalidOperationException">The assembly is not editable.</exception>
33 <exception cref="T:System.NotSupportedException">The update could not be applied.</exception>
35 <member name="P:System.Reflection.Metadata.MetadataUpdater.IsSupported">
36 <summary>Gets a value that indicates whether the assembly update is enabled and available.</summary>
38 <see langword="true" /> if the assembly update is enabled and available; otherwise, <see langword="false" />.</returns>
40 <member name="T:System.Runtime.CompilerServices.CreateNewOnMetadataUpdateAttribute">
41 <summary>Indicates a type should be replaced rather than updated when applying metadata updates.</summary>
43 <member name="M:System.Runtime.CompilerServices.CreateNewOnMetadataUpdateAttribute.#ctor">
44 <summary>Creates a new <see cref="T:System.Runtime.CompilerServices.CreateNewOnMetadataUpdateAttribute" /> instance.</summary>
46 <member name="T:System.Runtime.Loader.AssemblyDependencyResolver">
47 <summary>Allows a program to resolve assemblies and native libraries to paths based on the dependencies of a given assembly.</summary>
49 <member name="M:System.Runtime.Loader.AssemblyDependencyResolver.#ctor(System.String)">
50 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Loader.AssemblyDependencyResolver" /> class with a path to a component's assembly.</summary>
51 <param name="componentAssemblyPath">The path to the component or plugin's managed entry point.</param>
53 <member name="M:System.Runtime.Loader.AssemblyDependencyResolver.ResolveAssemblyToPath(System.Reflection.AssemblyName)">
54 <summary>Resolves a path to an assembly with the given assembly name based on the component's dependencies.</summary>
55 <param name="assemblyName">The assembly name to resolve.</param>
56 <returns>The path to an assembly with the given name from the component's deps.json file, or <see langword="null" /> if the assembly does not exist in the deps.json file or is not on disk in the location specified by the deps.json file.</returns>
58 <member name="M:System.Runtime.Loader.AssemblyDependencyResolver.ResolveUnmanagedDllToPath(System.String)">
59 <summary>Resolves a path to a native library with the given name based on the component's dependencies.</summary>
60 <param name="unmanagedDllName">The name of the native library to resolve.</param>
61 <returns>The path to a native library with the given name from the component's deps.json file and the current runtime identifier, or <see langword="null" /> if the assembly does not exist in the deps.json file or is not on disk in the location specified by the deps.json file.</returns>
63 <member name="T:System.Runtime.Loader.AssemblyLoadContext">
64 <summary>Represents the runtime's concept of a scope for assembly loading.</summary>
66 <member name="E:System.Runtime.Loader.AssemblyLoadContext.Resolving">
67 <summary>Occurs when the resolution of an assembly fails when attempting to load into this assembly load context.</summary>
69 <member name="E:System.Runtime.Loader.AssemblyLoadContext.ResolvingUnmanagedDll">
70 <summary>Occurs when the resolution of a native library fails.</summary>
72 <member name="E:System.Runtime.Loader.AssemblyLoadContext.Unloading">
73 <summary>Occurs when the <see cref="T:System.Runtime.Loader.AssemblyLoadContext" /> is unloaded.</summary>
75 <member name="M:System.Runtime.Loader.AssemblyLoadContext.#ctor">
76 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Loader.AssemblyLoadContext" /> class.</summary>
78 <member name="M:System.Runtime.Loader.AssemblyLoadContext.#ctor(System.Boolean)">
79 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Loader.AssemblyLoadContext" /> class with a value that indicates whether unloading is enabled.</summary>
80 <param name="isCollectible">
81 <see langword="true" /> to enable <see cref="M:System.Runtime.Loader.AssemblyLoadContext.Unload" />; otherwise, <see langword="false" />. The default value is <see langword="false" /> because there is a performance cost associated with enabling unloading.</param>
83 <member name="M:System.Runtime.Loader.AssemblyLoadContext.#ctor(System.String,System.Boolean)">
84 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Loader.AssemblyLoadContext" /> class with a name and a value that indicates whether unloading is enabled.</summary>
85 <param name="name">The value for <see cref="P:System.Runtime.Loader.AssemblyLoadContext.Name" /> in the new instance. Its value can be <see langword="null" />.</param>
86 <param name="isCollectible">
87 <see langword="true" /> to enable <see cref="M:System.Runtime.Loader.AssemblyLoadContext.Unload" />; otherwise, <see langword="false" />. The default value is <see langword="false" /> because there is a performance cost associated with enabling unloading.</param>
89 <member name="M:System.Runtime.Loader.AssemblyLoadContext.EnterContextualReflection">
90 <summary>Sets <see cref="P:System.Runtime.Loader.AssemblyLoadContext.CurrentContextualReflectionContext" /> to <see langword="this" /><see cref="T:System.Runtime.Loader.AssemblyLoadContext" />.</summary>
91 <returns>An object to restore the previous value of <see cref="P:System.Runtime.Loader.AssemblyLoadContext.CurrentContextualReflectionContext" />. It is intended to be used as an <see cref="T:System.IDisposable" /> in a <see langword="using" /> block.</returns>
93 <member name="M:System.Runtime.Loader.AssemblyLoadContext.EnterContextualReflection(System.Reflection.Assembly)">
94 <summary>Sets <see cref="P:System.Runtime.Loader.AssemblyLoadContext.CurrentContextualReflectionContext" /> to the <see cref="T:System.Runtime.Loader.AssemblyLoadContext" /> which loaded the assembly.</summary>
95 <param name="activating">The assembly that is used to determine the requested <see cref="T:System.Runtime.Loader.AssemblyLoadContext" /> instance.</param>
96 <returns>An object to restore the previous value of <see cref="P:System.Runtime.Loader.AssemblyLoadContext.CurrentContextualReflectionContext" />. It is intended to be used as an <see cref="T:System.IDisposable" /> in a <see langword="using" /> block.</returns>
98 <member name="M:System.Runtime.Loader.AssemblyLoadContext.Finalize">
99 <summary>Allows the object to try to free resources and perform other cleanup operations before it's reclaimed by garbage collection.</summary>
101 <member name="M:System.Runtime.Loader.AssemblyLoadContext.GetAssemblyName(System.String)">
102 <summary>Gets an <see cref="T:System.Reflection.AssemblyName" /> for an assembly path.</summary>
103 <param name="assemblyPath">The path to the assembly.</param>
104 <exception cref="T:System.ArgumentNullException">
105 <paramref name="assemblyPath" /> is <see langword="null" />.</exception>
106 <exception cref="T:System.IO.FileNotFoundException">The assembly cannot be found.</exception>
107 <exception cref="T:System.BadImageFormatException">The assembly is not a valid assembly.</exception>
108 <returns>An object that contains the fully parsed assembly name for the assembly at <paramref name="assemblyPath" />.</returns>
110 <member name="M:System.Runtime.Loader.AssemblyLoadContext.GetLoadContext(System.Reflection.Assembly)">
111 <summary>Gets the <see cref="T:System.Runtime.Loader.AssemblyLoadContext" /> containing the specified <see cref="T:System.Reflection.Assembly" />.</summary>
112 <param name="assembly">An assembly.</param>
113 <exception cref="T:System.ArgumentNullException">
114 <paramref name="assembly" /> is <see langword="null" />.</exception>
115 <returns>The assembly load context containing the <paramref name="assembly" />. If the <paramref name="assembly" /> is not provided by the runtime, this method returns null.</returns>
117 <member name="M:System.Runtime.Loader.AssemblyLoadContext.Load(System.Reflection.AssemblyName)">
118 <summary>When overridden in a derived class, allows an assembly to be resolved based on its <see cref="T:System.Reflection.AssemblyName" />.</summary>
119 <param name="assemblyName">The object that describes the assembly to be resolved.</param>
120 <returns>The resolved assembly, or <see langword="null" />.</returns>
122 <member name="M:System.Runtime.Loader.AssemblyLoadContext.LoadFromAssemblyName(System.Reflection.AssemblyName)">
123 <summary>Resolves and loads an assembly given its <see cref="T:System.Reflection.AssemblyName" />.</summary>
124 <param name="assemblyName">The object that describes the assembly to load.</param>
125 <exception cref="T:System.ArgumentNullException">
126 <paramref name="assemblyName" /> is <see langword="null" />.</exception>
127 <exception cref="T:System.IO.FileNotFoundException">
128 <paramref name="assemblyName" /> is not found.</exception>
129 <exception cref="T:System.BadImageFormatException">
130 <paramref name="assemblyName" /> is not a valid assembly.</exception>
131 <exception cref="T:System.IO.FileLoadException">An assembly or module was loaded which did not match the <paramref name="assemblyName" />.</exception>
132 <returns>The loaded assembly, or throws.</returns>
134 <member name="M:System.Runtime.Loader.AssemblyLoadContext.LoadFromAssemblyPath(System.String)">
135 <summary>Loads the contents of an assembly file on the specified path.</summary>
136 <param name="assemblyPath">The fully qualified path of the file to load.</param>
137 <exception cref="T:System.ArgumentException">The <paramref name="assemblyPath" /> argument is not an absolute path.</exception>
138 <exception cref="T:System.ArgumentNullException">The <paramref name="assemblyPath" /> parameter is <see langword="null" />.</exception>
139 <exception cref="T:System.IO.FileLoadException">A file that was found could not be loaded.</exception>
140 <exception cref="T:System.IO.FileNotFoundException">The <paramref name="assemblyPath" /> parameter is an empty string ("") or does not exist.</exception>
141 <exception cref="T:System.BadImageFormatException">
142 <paramref name="assemblyPath" /> is not a valid assembly.</exception>
143 <returns>The loaded assembly.</returns>
145 <member name="M:System.Runtime.Loader.AssemblyLoadContext.LoadFromNativeImagePath(System.String,System.String)">
146 <summary>Loads the contents of the native image of a managed assembly file on the specified path.</summary>
147 <param name="nativeImagePath">The fully qualified path of the file to load.</param>
148 <param name="assemblyPath">The fully qualified path of the IL version of the file to load, or <see langword="null" />.</param>
149 <exception cref="T:System.ArgumentException">The <paramref name="nativeImagePath" /> argument is not an absolute path.</exception>
150 <exception cref="T:System.ArgumentException">The <paramref name="assemblyPath" /> argument is not an absolute path.</exception>
151 <exception cref="T:System.ArgumentNullException">The <paramref name="nativeImagePath" /> parameter is <see langword="null" />.</exception>
152 <exception cref="T:System.IO.FileLoadException">A file that was found could not be loaded.</exception>
153 <exception cref="T:System.IO.FileNotFoundException">The <paramref name="nativeImagePath" /> parameter is an empty string ("") or does not exist.</exception>
154 <exception cref="T:System.BadImageFormatException">
155 <paramref name="assemblyPath" /> is not a valid assembly.</exception>
156 <returns>The loaded assembly.</returns>
158 <member name="M:System.Runtime.Loader.AssemblyLoadContext.LoadFromStream(System.IO.Stream)">
159 <summary>Loads the assembly with a common object file format (COFF)-based image containing a managed assembly.</summary>
160 <param name="assembly">A byte array that is a COFF-based image containing a managed assembly.</param>
161 <exception cref="T:System.ArgumentNullException">
162 <paramref name="assembly" /> is <see langword="null" />.</exception>
163 <exception cref="T:System.BadImageFormatException">
164 <paramref name="assembly" /> is not a valid assembly.</exception>
165 <returns>The loaded assembly.</returns>
167 <member name="M:System.Runtime.Loader.AssemblyLoadContext.LoadFromStream(System.IO.Stream,System.IO.Stream)">
168 <summary>Loads the assembly with a common object file format (COFF)-based image containing a managed assembly, optionally including symbols for the assembly.</summary>
169 <param name="assembly">A byte array that is a COFF-based image containing a managed assembly.</param>
170 <param name="assemblySymbols">A byte array that contains the raw bytes representing the symbols for the assembly.</param>
171 <exception cref="T:System.ArgumentNullException">
172 <paramref name="assembly" /> is <see langword="null" />.</exception>
173 <exception cref="T:System.BadImageFormatException">
174 <paramref name="assembly" /> is not a valid assembly.</exception>
175 <returns>The loaded assembly.</returns>
177 <member name="M:System.Runtime.Loader.AssemblyLoadContext.LoadUnmanagedDll(System.String)">
178 <summary>Allows derived class to load an unmanaged library by name.</summary>
179 <param name="unmanagedDllName">Name of the unmanaged library. Typically this is the filename without its path or extensions.</param>
180 <returns>A handle to the loaded library, or <see cref="F:System.IntPtr.Zero" />.</returns>
182 <member name="M:System.Runtime.Loader.AssemblyLoadContext.LoadUnmanagedDllFromPath(System.String)">
183 <summary>Loads an unmanaged library from the specified path.</summary>
184 <param name="unmanagedDllPath">The path to the unmanaged library.</param>
185 <exception cref="T:System.ArgumentNullException">
186 <paramref name="unmanagedDllPath" /> is <see langword="null" />.</exception>
187 <exception cref="T:System.ArgumentException">The <paramref name="unmanagedDllPath" /> argument is empty or not an absolute path.</exception>
188 <exception cref="T:System.DllNotFoundException">The library can't be found.</exception>
189 <exception cref="T:System.BadImageFormatException">The library is not valid.</exception>
190 <returns>The OS handle for the loaded native library.</returns>
192 <member name="M:System.Runtime.Loader.AssemblyLoadContext.SetProfileOptimizationRoot(System.String)">
193 <summary>Sets the root path where the optimization profiles for this load context are stored.</summary>
194 <param name="directoryPath">The full path to the directory where the optimization profiles are stored.</param>
196 <member name="M:System.Runtime.Loader.AssemblyLoadContext.StartProfileOptimization(System.String)">
197 <summary>Starts the profile optimization for the specified profile.</summary>
198 <param name="profile">The name of the optimization profile.</param>
200 <member name="M:System.Runtime.Loader.AssemblyLoadContext.ToString">
201 <summary>Returns the string representation of this load context.</summary>
202 <returns>The string representation of this load context.</returns>
204 <member name="M:System.Runtime.Loader.AssemblyLoadContext.Unload">
205 <summary>Initiates an unload of this <see cref="T:System.Runtime.Loader.AssemblyLoadContext" />.</summary>
206 <exception cref="T:System.InvalidOperationException">Unloading is not allowed.</exception>
208 <member name="P:System.Runtime.Loader.AssemblyLoadContext.All">
209 <summary>Returns a collection of all <see cref="T:System.Runtime.Loader.AssemblyLoadContext" /> instances.</summary>
210 <returns>A collection of all <see cref="T:System.Runtime.Loader.AssemblyLoadContext" /> instances.</returns>
212 <member name="P:System.Runtime.Loader.AssemblyLoadContext.Assemblies">
213 <summary>Returns a collection of the <see cref="T:System.Reflection.Assembly" /> instances loaded in the <see cref="T:System.Runtime.Loader.AssemblyLoadContext" />.</summary>
214 <returns>A collection of the <see cref="T:System.Reflection.Assembly" /> instances loaded in the <see cref="T:System.Runtime.Loader.AssemblyLoadContext" />.</returns>
216 <member name="P:System.Runtime.Loader.AssemblyLoadContext.CurrentContextualReflectionContext">
217 <summary>Gets the <see cref="T:System.Runtime.Loader.AssemblyLoadContext" /> set by the most recent call to <see cref="M:System.Runtime.Loader.AssemblyLoadContext.EnterContextualReflection" />.</summary>
218 <returns>The <see cref="T:System.Runtime.Loader.AssemblyLoadContext" /> set by the most recent call to <see cref="M:System.Runtime.Loader.AssemblyLoadContext.EnterContextualReflection" />. This value can be <see langword="null" />. The value is stored in an <see cref="T:System.Threading.AsyncLocal`1" />, so the value is unique per asynchronous context.</returns>
220 <member name="P:System.Runtime.Loader.AssemblyLoadContext.Default">
221 <summary>Gets the default <see cref="T:System.Runtime.Loader.AssemblyLoadContext" />. The default context contains the main application assembly and its static dependencies.</summary>
222 <returns>The default assembly load context.</returns>
224 <member name="P:System.Runtime.Loader.AssemblyLoadContext.IsCollectible">
225 <summary>Gets a value that indicates whether this <see cref="T:System.Runtime.Loader.AssemblyLoadContext" /> is collectible.</summary>
227 <see langword="true" /> if this <see cref="T:System.Runtime.Loader.AssemblyLoadContext" /> is collectible; otherwise, <see langword="false" />. If a value is not specified in the constructor, the value is <see langword="false" />.</returns>
229 <member name="P:System.Runtime.Loader.AssemblyLoadContext.Name">
230 <summary>Get the name of the <see cref="T:System.Runtime.Loader.AssemblyLoadContext" />.</summary>
231 <returns>The name of the <see cref="T:System.Runtime.Loader.AssemblyLoadContext" />. Its value can be <see langword="null" />.</returns>
233 <member name="T:System.Runtime.Loader.AssemblyLoadContext.ContextualReflectionScope">
234 <summary>Provides a return type used exclusively for <see cref="M:System.Runtime.Loader.AssemblyLoadContext.EnterContextualReflection" />. It is intended to be used as an <see cref="T:System.IDisposable" /> in a <see langword="using" /> block.</summary>
236 <member name="M:System.Runtime.Loader.AssemblyLoadContext.ContextualReflectionScope.Dispose">
237 <summary>Sets <see cref="P:System.Runtime.Loader.AssemblyLoadContext.CurrentContextualReflectionContext" /> to the value preceding the call to <see cref="M:System.Runtime.Loader.AssemblyLoadContext.EnterContextualReflection" /> which returned this instance.</summary>