mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.WindowsRuntime/WindowsRuntimeMetadata.xml

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <Type Name="WindowsRuntimeMetadata" FullName="System.Runtime.InteropServices.WindowsRuntime.WindowsRuntimeMetadata">
   3   <TypeSignature Language="C#" Value="public static class WindowsRuntimeMetadata" />
   4   <TypeSignature Language="ILAsm" Value=".class public auto ansi abstract sealed beforefieldinit WindowsRuntimeMetadata extends System.Object" />
   5   <AssemblyInfo>
   6     <AssemblyName>mscorlib</AssemblyName>
   7     <AssemblyVersion>4.0.0.0</AssemblyVersion>
   8   </AssemblyInfo>
   9   <Base>
  10     <BaseTypeName>System.Object</BaseTypeName>
  11   </Base>
  12   <Interfaces />
  13   <Docs>
  14     <remarks>
  15       <attribution license="cc4" from="Microsoft" modified="false" />
  16       <para>Unlike the .NET Framework, assembly identity isn’t important for wrt types. In the wrt, Windows Metadata files (.WinMD files) contain only metadata, not code. Types can move from one Windows Metadata file to another in a service pack release, so it’s important to be able to locate the Windows Metadata files that are associated with a namespace. </para>
  17       <block subset="none" type="note">
  18         <para>Sub-namespaces don’t imply containment. That is, namespace A.B isn't contained in namespace A. </para>
  19       </block>
  20     </remarks>
  21     <summary>
  22       <attribution license="cc4" from="Microsoft" modified="false" />
  23       <para>Provides an event for resolving reflection-only type requests for types that are provided by Windows Metadata files, and methods for performing the resolution. </para>
  24     </summary>
  25   </Docs>
  26   <Members>
  27     <Member MemberName="DesignerNamespaceResolve">
  28       <MemberSignature Language="C#" Value="public static event EventHandler&lt;System.Runtime.InteropServices.WindowsRuntime.DesignerNamespaceResolveEventArgs&gt; DesignerNamespaceResolve;" />
  29       <MemberSignature Language="ILAsm" Value=".event class System.EventHandler`1&lt;class System.Runtime.InteropServices.WindowsRuntime.DesignerNamespaceResolveEventArgs&gt; DesignerNamespaceResolve" />
  30       <MemberType>Event</MemberType>
  31       <AssemblyInfo>
  32         <AssemblyVersion>4.0.0.0</AssemblyVersion>
  33       </AssemblyInfo>
  34       <ReturnValue>
  35         <ReturnType>System.EventHandler&lt;System.Runtime.InteropServices.WindowsRuntime.DesignerNamespaceResolveEventArgs&gt;</ReturnType>
  36       </ReturnValue>
  37       <Docs>
  38         <remarks>To be added.</remarks>
  39         <summary>
  40           <attribution license="cc4" from="Microsoft" modified="false" />
  41           <para>Occurs when the resolution of a Windows Metadata file fails in the design environment. </para>
  42         </summary>
  43       </Docs>
  44     </Member>
  45     <Member MemberName="ReflectionOnlyNamespaceResolve">
  46       <MemberSignature Language="C#" Value="public static event EventHandler&lt;System.Runtime.InteropServices.WindowsRuntime.NamespaceResolveEventArgs&gt; ReflectionOnlyNamespaceResolve;" />
  47       <MemberSignature Language="ILAsm" Value=".event class System.EventHandler`1&lt;class System.Runtime.InteropServices.WindowsRuntime.NamespaceResolveEventArgs&gt; ReflectionOnlyNamespaceResolve" />
  48       <MemberType>Event</MemberType>
  49       <AssemblyInfo>
  50         <AssemblyVersion>4.0.0.0</AssemblyVersion>
  51       </AssemblyInfo>
  52       <ReturnValue>
  53         <ReturnType>System.EventHandler&lt;System.Runtime.InteropServices.WindowsRuntime.NamespaceResolveEventArgs&gt;</ReturnType>
  54       </ReturnValue>
  55       <Docs>
  56         <remarks>
  57           <attribution license="cc4" from="Microsoft" modified="false" />
  58           <para>After this event is raised and handled, it is not raised again for the lifetime of the application domain. The list of files that defines the namespace cannot be changed. This event is analogous to the <see cref="E:System.AppDomain.ReflectionOnlyAssemblyResolve" /> event for managed assemblies. </para>
  59           <para>See the <see cref="T:System.Runtime.InteropServices.WindowsRuntime.NamespaceResolveEventArgs" /> class.</para>
  60           <block subset="none" type="note">
  61             <para>The event handler for this event should not throw exceptions. </para>
  62           </block>
  63         </remarks>
  64         <summary>
  65           <attribution license="cc4" from="Microsoft" modified="false" />
  66           <para>Occurs when the resolution of a Windows Metadata file fails in the reflection-only context. </para>
  67         </summary>
  68       </Docs>
  69     </Member>
  70     <Member MemberName="ResolveNamespace">
  71       <MemberSignature Language="C#" Value="public static System.Collections.Generic.IEnumerable&lt;string&gt; ResolveNamespace (string namespaceName, System.Collections.Generic.IEnumerable&lt;string&gt; packageGraphFilePaths);" />
  72       <MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Collections.Generic.IEnumerable`1&lt;string&gt; ResolveNamespace(string namespaceName, class System.Collections.Generic.IEnumerable`1&lt;string&gt; packageGraphFilePaths) cil managed" />
  73       <MemberType>Method</MemberType>
  74       <AssemblyInfo>
  75         <AssemblyVersion>4.0.0.0</AssemblyVersion>
  76       </AssemblyInfo>
  77       <ReturnValue>
  78         <ReturnType>System.Collections.Generic.IEnumerable&lt;System.String&gt;</ReturnType>
  79       </ReturnValue>
  80       <Parameters>
  81         <Parameter Name="namespaceName" Type="System.String" />
  82         <Parameter Name="packageGraphFilePaths" Type="System.Collections.Generic.IEnumerable&lt;System.String&gt;" />
  83       </Parameters>
  84       <Docs>
  85         <remarks>
  86           <attribution license="cc4" from="Microsoft" modified="false" />
  87           <para>Calling this method overload is equivalent to calling the <see cref="M:System.Runtime.InteropServices.WindowsRuntime.WindowsRuntimeMetadata.ResolveNamespace(System.String,System.String,System.Collections.Generic.IEnumerable{System.String})" /> method overload and specifying null for the <paramref name="windowsSdkFilePath" /> parameter. </para>
  88         </remarks>
  89         <summary>
  90           <attribution license="cc4" from="Microsoft" modified="false" />
  91           <para>Locates the Windows Metadata files for the specified namespace, given the specified locations to search. </para>
  92         </summary>
  93         <returns>
  94           <attribution license="cc4" from="Microsoft" modified="false" />
  95           <para>An enumerable list of strings that represent the Windows Metadata files that define <paramref name="namespaceName" />. </para>
  96         </returns>
  97         <param name="namespaceName">
  98           <attribution license="cc4" from="Microsoft" modified="false" />The namespace to resolve. </param>
  99         <param name="packageGraphFilePaths">
 100           <attribution license="cc4" from="Microsoft" modified="false" />The application paths to search for Windows Metadata files, or null to search only for Windows Metadata files from the operating system installation. </param>
 101       </Docs>
 102     </Member>
 103     <Member MemberName="ResolveNamespace">
 104       <MemberSignature Language="C#" Value="public static System.Collections.Generic.IEnumerable&lt;string&gt; ResolveNamespace (string namespaceName, string windowsSdkFilePath, System.Collections.Generic.IEnumerable&lt;string&gt; packageGraphFilePaths);" />
 105       <MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Collections.Generic.IEnumerable`1&lt;string&gt; ResolveNamespace(string namespaceName, string windowsSdkFilePath, class System.Collections.Generic.IEnumerable`1&lt;string&gt; packageGraphFilePaths) cil managed" />
 106       <MemberType>Method</MemberType>
 107       <AssemblyInfo>
 108         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 109       </AssemblyInfo>
 110       <ReturnValue>
 111         <ReturnType>System.Collections.Generic.IEnumerable&lt;System.String&gt;</ReturnType>
 112       </ReturnValue>
 113       <Parameters>
 114         <Parameter Name="namespaceName" Type="System.String" />
 115         <Parameter Name="windowsSdkFilePath" Type="System.String" />
 116         <Parameter Name="packageGraphFilePaths" Type="System.Collections.Generic.IEnumerable&lt;System.String&gt;" />
 117       </Parameters>
 118       <Docs>
 119         <remarks>
 120           <attribution license="cc4" from="Microsoft" modified="false" />
 121           <para>The path you specify for <paramref name="windowsSdkFilePath" /> is searched only for namespaces that begin with Windows. </para>
 122         </remarks>
 123         <summary>
 124           <attribution license="cc4" from="Microsoft" modified="false" />
 125           <para>Locates the Windows Metadata files for the specified namespace, given the specified locations to search. </para>
 126         </summary>
 127         <returns>
 128           <attribution license="cc4" from="Microsoft" modified="false" />
 129           <para>An enumerable list of strings that represent the Windows Metadata files that define <paramref name="namespaceName" />. </para>
 130         </returns>
 131         <param name="namespaceName">
 132           <attribution license="cc4" from="Microsoft" modified="false" />The namespace to resolve. </param>
 133         <param name="windowsSdkFilePath">
 134           <attribution license="cc4" from="Microsoft" modified="false" />The path to search for Windows Metadata files provided by the SDK, or null to search for Windows Metadata files from the operating system installation. </param>
 135         <param name="packageGraphFilePaths">
 136           <attribution license="cc4" from="Microsoft" modified="false" />The application paths to search for Windows Metadata files. </param>
 137       </Docs>
 138     </Member>
 139   </Members>
 140 </Type>