mono/linux-packaging-mono
0
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Imported Upstream version 3.6.0

Browse Source 
Former-commit-id: da6be194a6b1221998fc28233f2503bd61dd9d14
This commit is contained in:
Jo Shields
2014-08-13 10:39:27 +01:00
commit a575963da9
50588 changed files with 8155799 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

211
mcs/class/corlib/Documentation/en/System.Runtime.Hosting/ActivationArguments.xml Normal file
View File

@@ -0,0 +1,211 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="ActivationArguments" FullName="System.Runtime.Hosting.ActivationArguments">
<TypeSignature Language="C#" Value="public sealed class ActivationArguments : System.Security.Policy.EvidenceBase" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi serializable sealed beforefieldinit ActivationArguments extends System.Security.Policy.EvidenceBase" />
<AssemblyInfo>
<AssemblyName>mscorlib</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Security.Policy.EvidenceBase</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.Runtime.InteropServices.ComVisible(true)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Runtime.Hosting.ActivationArguments" /> class is used by the <see cref="T:System.AppDomainSetup" /> class. </para>
<para>The manifest-based activation model uses an application manifest rather than an assembly for activation. A manifest fully describes the application, its dependencies, security requirements, and so forth. The manifest model has several advantages over the assembly-based activation model, especially for Web applications. For example, the manifest contains the security requirements of the application, which enables the user to decide whether to allow the application to execute before downloading the code. The manifest also contains information about the application dependencies. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides data for manifest-based activation of an application. This class cannot be inherited. </para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ActivationArguments (ActivationContext activationData);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.ActivationContext activationData) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="activationData" Type="System.ActivationContext" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.ActivationContext" /> object represented by the <paramref name="activationData" /> parameter contains the <see cref="T:System.ApplicationIdentity" /> and context information for manifest-based activation. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Runtime.Hosting.ActivationArguments" /> class with the specified activation context. </para>
</summary>
<param name="activationData">
<attribution license="cc4" from="Microsoft" modified="false" />An object that identifies the manifest-based activation application.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ActivationArguments (ApplicationIdentity applicationIdentity);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.ApplicationIdentity applicationIdentity) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="applicationIdentity" Type="System.ApplicationIdentity" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The application identity uniquely identifies a manifest-based application to be activated in a new domain.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Runtime.Hosting.ActivationArguments" /> class with the specified application identity.</para>
</summary>
<param name="applicationIdentity">
<attribution license="cc4" from="Microsoft" modified="false" />An object that identifies the manifest-based activation application.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ActivationArguments (ActivationContext activationContext, string[] activationData);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.ActivationContext activationContext, string[] activationData) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="activationContext" Type="System.ActivationContext" />
<Parameter Name="activationData" Type="System.String[]" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.ActivationContext" /> object represented by the <paramref name="activationContext" /> parameter contains the <see cref="T:System.ApplicationIdentity" /> and context information for manifest-based activation. The activation data consists of information such as the query string portion of a URL.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Runtime.Hosting.ActivationArguments" /> class with the specified activation context and activation data.</para>
</summary>
<param name="activationContext">
<attribution license="cc4" from="Microsoft" modified="false" />An object that identifies the manifest-based activation application.</param>
<param name="activationData">
<attribution license="cc4" from="Microsoft" modified="false" />An array of strings containing host-provided activation data.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ActivationArguments (ApplicationIdentity applicationIdentity, string[] activationData);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.ApplicationIdentity applicationIdentity, string[] activationData) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="applicationIdentity" Type="System.ApplicationIdentity" />
<Parameter Name="activationData" Type="System.String[]" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The application identity uniquely identifies a manifest-based application to be activated in a new domain. The activation data consists of information such as the query string portion of a URL.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Runtime.Hosting.ActivationArguments" /> class with the specified application identity and activation data.</para>
</summary>
<param name="applicationIdentity">
<attribution license="cc4" from="Microsoft" modified="false" />An object that identifies the manifest-based activation application.</param>
<param name="activationData">
<attribution license="cc4" from="Microsoft" modified="false" />An array of strings containing host-provided activation data.</param>
</Docs>
</Member>
<Member MemberName="ActivationContext">
<MemberSignature Language="C#" Value="public ActivationContext ActivationContext { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.ActivationContext ActivationContext" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.ActivationContext</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.ActivationContext" /> object contains an <see cref="T:System.ApplicationIdentity" /> and provides internal-only access to the application manifest. The activation context is used during manifest-based activation to set up the domain policy and provide an application-based security model.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the activation context for manifest-based activation of an application.</para>
</summary>
</Docs>
</Member>
<Member MemberName="ActivationData">
<MemberSignature Language="C#" Value="public string[] ActivationData { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance string[] ActivationData" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String[]</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The activation data consists of information such as the query string portion of a URL.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets activation data from the host.</para>
</summary>
</Docs>
</Member>
<Member MemberName="ApplicationIdentity">
<MemberSignature Language="C#" Value="public ApplicationIdentity ApplicationIdentity { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.ApplicationIdentity ApplicationIdentity" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.ApplicationIdentity</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The application identity uniquely identifies a manifest-based application to be activated in a new domain.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the application identity for a manifest-activated application.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

188
mcs/class/corlib/Documentation/en/System.Runtime.Hosting/ApplicationActivator.xml Normal file
View File

@@ -0,0 +1,188 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="ApplicationActivator" FullName="System.Runtime.Hosting.ApplicationActivator">
<TypeSignature Language="C#" Value="public class ApplicationActivator" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit ApplicationActivator extends System.Object" />
<AssemblyInfo>
<AssemblyName>mscorlib</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.Runtime.InteropServices.ComVisible(true)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>There is a single designated instance of the <see cref="T:System.Runtime.Hosting.ApplicationActivator" /> class in each <see cref="T:System.AppDomain" /> to which all activation calls are routed. The <see cref="T:System.AppDomainManager" /> for the current <see cref="T:System.AppDomain" /> can provide its own custom <see cref="T:System.Runtime.Hosting.ApplicationActivator" /> for this purpose. If a custom <see cref="T:System.Runtime.Hosting.ApplicationActivator" /> is not provided, an instance of the default <see cref="T:System.Runtime.Hosting.ApplicationActivator" /> is created. </para>
<para>The following steps describe the behavior of the default <see cref="Overload:System.Runtime.Hosting.ApplicationActivator.CreateInstance" /> method implementation:</para>
<list type="ordered">
<item>
<para>Checks if the <see cref="T:System.ActivationContext" /> of the add-in to be activated matches the <see cref="T:System.ActivationContext" /> of the current domain; if not, proceeds to step 2. Otherwise, executes the assembly and returns the result wrapped in an object handle.</para>
</item>
<item>
<para>Activates the add-in in a new <see cref="T:System.AppDomain" />. The following steps are taken to initialize a new <see cref="T:System.AppDomain" /> using the <see cref="T:System.Runtime.Hosting.ActivationArguments" /> for the add-in.</para>
<list type="ordered">
<item>
<para>Creates a new <see cref="T:System.AppDomainSetup" /> object using an <see cref="T:System.Runtime.Hosting.ActivationArguments" /> object containing the activation context for the add-in.</para>
</item>
<item>
<para>Calls the <see cref="M:System.Runtime.Hosting.ApplicationActivator.CreateInstanceHelper(System.AppDomainSetup)" /> method to create a new domain using the <see cref="T:System.AppDomainSetup" /> object.</para>
</item>
<item>
<para>The <see cref="M:System.Runtime.Hosting.ApplicationActivator.CreateInstanceHelper(System.AppDomainSetup)" /> method calls the <see cref="M:System.Security.HostSecurityManager.DetermineApplicationTrust(System.Security.Policy.Evidence,System.Security.Policy.Evidence,System.Security.Policy.TrustManagerContext)" /> method to acquire an <see cref="T:System.Security.Policy.ApplicationTrust" /> object for the add-in. If the <see cref="P:System.Security.Policy.ApplicationTrust.IsApplicationTrustedToRun" /> property returns true, the add-in is executed. If not, <see cref="M:System.Runtime.Hosting.ApplicationActivator.CreateInstanceHelper(System.AppDomainSetup)" /> throws a <see cref="T:System.Security.Policy.PolicyException" /> indicating that execution permission could not be acquired.</para>
</item>
<item>
<para>If the add-in is trusted to run, then a new <see cref="T:System.AppDomain" /> is created and configured for the <see cref="T:System.ActivationContext" /> of the add-in, and the add-in is loaded and executed.</para>
</item>
<item>
<para>The result of the activation of the add-in is returned, wrapped in an object handle.</para>
</item>
</list>
</item>
</list>
<para>A custom activator can tailor the activation of an add-in to a particular set of circumstances. For example, a custom activator could find an existing <see cref="T:System.AppDomain" /> to activate this add-in instead of creating a new domain every time. </para>
<para>The following steps describe the behavior of a custom <see cref="T:System.Runtime.Hosting.ApplicationActivator" /> that activates an add-in in an existing <see cref="T:System.AppDomain" />:</para>
<list type="ordered">
<item>
<para>The custom activator finds a domain that has the same <see cref="T:System.ActivationContext" /> as the add-in that is being activated.</para>
</item>
<item>
<para>If the <see cref="T:System.ActivationContext" /> has never been seen before in the process, the custom activator creates a new <see cref="T:System.AppDomain" /> for this <see cref="T:System.ActivationContext" /> by calling the <see cref="Overload:System.AppDomain.CreateDomain" /> method directly, or delegating this activity to the <see cref="M:System.Runtime.Hosting.ApplicationActivator.CreateInstanceHelper(System.AppDomainSetup)" /> in the base class.</para>
</item>
<item>
<para>If there is an existing domain with the same <see cref="T:System.ActivationContext" />, then the activator can delegate the <see cref="Overload:System.Runtime.Hosting.ApplicationActivator.CreateInstance" /> method call to the <see cref="T:System.Runtime.Hosting.ApplicationActivator" /> in the target domain. Note that this would be a cross-domain call to an <see cref="T:System.Runtime.Hosting.ApplicationActivator" /> that resides in the target <see cref="T:System.AppDomain" />.</para>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides the base class for the activation of manifest-based assemblies. </para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ApplicationActivator ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters />
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Runtime.Hosting.ApplicationActivator" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName="CreateInstance">
<MemberSignature Language="C#" Value="public virtual System.Runtime.Remoting.ObjectHandle CreateInstance (ActivationContext activationContext);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Runtime.Remoting.ObjectHandle CreateInstance(class System.ActivationContext activationContext) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Runtime.Remoting.ObjectHandle</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="activationContext" Type="System.ActivationContext" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is intended for the manifest-based activation of applications.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates an instance of the application to be activated, using the specified activation context. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An <see cref="T:System.Runtime.Remoting.ObjectHandle" /> that is a wrapper for the return value of the application execution. The return value must be unwrapped to access the real object. </para>
</returns>
<param name="activationContext">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ActivationContext" /> that identifies the application to activate.</param>
</Docs>
</Member>
<Member MemberName="CreateInstance">
<MemberSignature Language="C#" Value="public virtual System.Runtime.Remoting.ObjectHandle CreateInstance (ActivationContext activationContext, string[] activationCustomData);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Runtime.Remoting.ObjectHandle CreateInstance(class System.ActivationContext activationContext, string[] activationCustomData) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Runtime.Remoting.ObjectHandle</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="activationContext" Type="System.ActivationContext" />
<Parameter Name="activationCustomData" Type="System.String[]" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is intended for the manifest-based activation of applications. The activation data consists of information such as the query string portion of a URL.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates an instance of the application to be activated, using the specified activation context and custom activation data. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An <see cref="T:System.Runtime.Remoting.ObjectHandle" /> that is a wrapper for the return value of the application execution. The return value must be unwrapped to access the real object.</para>
</returns>
<param name="activationContext">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ActivationContext" /> that identifies the application to activate.</param>
<param name="activationCustomData">
<attribution license="cc4" from="Microsoft" modified="false" />Custom activation data.</param>
</Docs>
</Member>
<Member MemberName="CreateInstanceHelper">
<MemberSignature Language="C#" Value="protected static System.Runtime.Remoting.ObjectHandle CreateInstanceHelper (AppDomainSetup adSetup);" />
<MemberSignature Language="ILAsm" Value=".method familystatic hidebysig class System.Runtime.Remoting.ObjectHandle CreateInstanceHelper(class System.AppDomainSetup adSetup) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Runtime.Remoting.ObjectHandle</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="adSetup" Type="System.AppDomainSetup" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is intended for the manifest-based activation of applications.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates an instance of an application using the specified <see cref="T:System.AppDomainSetup" /> object.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An <see cref="T:System.Runtime.Remoting.ObjectHandle" /> that is a wrapper for the return value of the application execution. The return value must be unwrapped to access the real object. </para>
</returns>
<param name="adSetup">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.AppDomainSetup" /> object whose <see cref="P:System.AppDomainSetup.ActivationArguments" /> property identifies the application to activate.</param>
</Docs>
</Member>
</Members>
</Type>