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

69
mcs/class/corlib/Documentation/en/System.Security/AllowPartiallyTrustedCallersAttribute.xml Normal file
View File

@@ -0,0 +1,69 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="AllowPartiallyTrustedCallersAttribute" FullName="System.Security.AllowPartiallyTrustedCallersAttribute">
<TypeSignature Maintainer="auto" Language="C#" Value="public sealed class AllowPartiallyTrustedCallersAttribute : Attribute" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit AllowPartiallyTrustedCallersAttribute extends System.Attribute" />
<AssemblyInfo>
<AssemblyName>mscorlib</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Attribute</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false, Inherited=false)</AttributeName>
</Attribute>
<Attribute>
<AttributeName>System.Runtime.InteropServices.ComVisible(true)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<block subset="none" type="note">
<para> The net_v40_long introduces new security rules that affect the behavior of the <see cref="T:System.Security.AllowPartiallyTrustedCallersAttribute" /> attribute (see <format type="text/html"><a href="4d05610a-0da6-4f08-acea-d54c9d6143c0">Security-Transparent Code, Level 2</a></format>). In the net_v40_short, all code defaults to security-transparent, that is, partially trusted. However, you can annotate individual types and members to assign them other transparency attributes. For this and other security changes, see <format type="text/html"><a href="5e87881c-9c13-4b52-8ad1-e34bb46e8aaa">Security Changes in the .NET Framework Version 4</a></format>.</para>
</block>
<para>.NET Framework version 2.0 (<format type="text/html"><a href="5fd8f46d-3961-46a7-84af-2eb1f48e75cf">level 1 transparent</a></format>) assemblies must be strong-named to effectively use the <see cref="T:System.Security.AllowPartiallyTrustedCallersAttribute" /> (APTCA) attribute. net_v40_short (<format type="text/html"><a href="4d05610a-0da6-4f08-acea-d54c9d6143c0">level 2</a></format>) assemblies do not have to be strong-named for the APTCA attribute to be effective, and they can contain transparent, security-critical and security-safe-critical code. For more information about applying attributes at the assembly level, see <format type="text/html"><a href="dd7604eb-9fa3-4b60-b2dd-b47739fa3148">Applying Attributes</a></format>.</para>
<para>By default, if a strong-named, <format type="text/html"><a href="5fd8f46d-3961-46a7-84af-2eb1f48e75cf">level 1 transparent</a></format> assembly does not explicitly apply this attribute at the assembly level, it can be called only by other assemblies that are granted full trust. This restriction is enforced by placing a <see cref="F:System.Security.Permissions.SecurityAction.LinkDemand" /> for FullTrust on every public or protected method on every publicly accessible class in the assembly. Assemblies that are intended to be called by partially trusted code can declare their intent through the use of <see cref="T:System.Security.AllowPartiallyTrustedCallersAttribute" />. An example of the declaration in C# is [assembly:AllowPartiallyTrustedCallers]; an example in Visual Basic is &lt;assembly:AllowPartiallyTrustedCallers&gt;.</para>
<block subset="none" type="note">
<para>The presence of this assembly-level attribute prevents the default behavior of placing FullTrust <see cref="F:System.Security.Permissions.SecurityAction.LinkDemand" /> security checks, and makes the assembly callable from any other (partially or fully trusted) assembly.</para>
</block>
<para>When the APTCA attribute is present, all other security checks function as intended, including any class-level or method-level declarative security attributes that are present. This attribute blocks only the implicit, fully trusted caller demand.</para>
<para>This is not a declarative security attribute, but a regular attribute (it derives from <see cref="T:System.Attribute" />, not from <see cref="T:System.Security.Permissions.SecurityAttribute" />).</para>
<para>For more information, see <format type="text/html"><a href="dd66cd4c-b087-415f-9c3e-94e3a1835f74">Using Libraries from Partially Trusted Code</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Allows an assembly to be called by partially trusted code. Without this declaration, only fully trusted callers are able to use the assembly. This class cannot be inherited.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public AllowPartiallyTrustedCallersAttribute ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This attribute should be applied only at the assembly level.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Security.AllowPartiallyTrustedCallersAttribute" /> class. </para>
</summary>
</Docs>
</Member>
</Members>
</Type>

624
mcs/class/corlib/Documentation/en/System.Security/CodeAccessPermission.xml Normal file
View File

File diff suppressed because it is too large Load Diff

311
mcs/class/corlib/Documentation/en/System.Security/HostProtectionException.xml Normal file
View File

@@ -0,0 +1,311 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="HostProtectionException" FullName="System.Security.HostProtectionException">
<TypeSignature Language="C#" Value="public class HostProtectionException : SystemException" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi serializable beforefieldinit HostProtectionException extends System.SystemException" />
<AssemblyInfo>
<AssemblyName>mscorlib</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.SystemException</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>A <see cref="T:System.Security.Permissions.HostProtectionAttribute" /> attribute is used to determine if a type or member can be loaded, based on the host’s protection preferences established when the common language runtime is started. If a type or member with an active <see cref="T:System.Security.Permissions.HostProtectionAttribute" /> is called, a link demand occurs for that protection attribute. If the caller does not meet the demand for host protection, a <see cref="T:System.Security.HostProtectionException" /> is thrown. </para>
<block subset="none" type="note">
<para>A <see cref="T:System.Security.Permissions.HostProtectionAttribute" /> is not a permission, even though it is the target of a link demand. Because a <see cref="T:System.Security.HostProtectionException" /> is thrown for a link demand, it cannot be handled, and therefore it cannot be trapped and processed in code.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The exception that is thrown when a denied host resource is detected.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public HostProtectionException ();" />
<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>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The following table shows the initial property values for an instance of the <see cref="T:System.Security.HostProtectionException" /> class.</para>
<list type="table">
<listheader>
<item>
<term>
<para>Property </para>
</term>
<description>
<para>Value </para>
</description>
</item>
</listheader>
<item>
<term>
<para>
<see cref="P:System.Security.HostProtectionException.ProtectedResources" />
</para>
</term>
<description>
<para>
<see cref="F:System.Security.Permissions.HostProtectionResource.None" />
</para>
</description>
</item>
<item>
<term>
<para>
<see cref="P:System.Security.HostProtectionException.DemandedResources" />
</para>
</term>
<description>
<para>
<see cref="F:System.Security.Permissions.HostProtectionResource.None" />
</para>
</description>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Security.HostProtectionException" /> class with default values. </para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public HostProtectionException (string message);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string message) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="message" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The content of the <paramref name="message" /> parameter should be understandable to the user. The caller of this constructor is required to ensure that this string has been localized for the current system culture.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Security.HostProtectionException" /> class with a specified error message. </para>
</summary>
<param name="message">
<attribution license="cc4" from="Microsoft" modified="false" />The message that describes the error.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="protected HostProtectionException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);" />
<MemberSignature Language="ILAsm" Value=".method familyhidebysig specialname rtspecialname instance void .ctor(class System.Runtime.Serialization.SerializationInfo info, valuetype System.Runtime.Serialization.StreamingContext context) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="info" Type="System.Runtime.Serialization.SerializationInfo" />
<Parameter Name="context" Type="System.Runtime.Serialization.StreamingContext" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This constructor is called during deserialization to reconstruct the exception object transmitted over a stream. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Security.HostProtectionException" /> class using the provided serialization information and streaming context.</para>
</summary>
<param name="info">
<attribution license="cc4" from="Microsoft" modified="false" />The object that holds the serialized object data.</param>
<param name="context">
<attribution license="cc4" from="Microsoft" modified="false" />Contextual information about the source or destination.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public HostProtectionException (string message, Exception e);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string message, class System.Exception e) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="message" Type="System.String" />
<Parameter Name="e" Type="System.Exception" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An exception that is thrown as a direct result of a previous exception can include a reference to the previous exception in the <see cref="P:System.Exception.InnerException" /> property. The <see cref="P:System.Exception.InnerException" /> property returns the same value that is passed into the constructor, or null if the <see cref="P:System.Exception.InnerException" /> property does not supply the inner exception value to the constructor.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Security.HostProtectionException" /> class with a specified error message and a reference to the inner exception that is the cause of this exception. </para>
</summary>
<param name="message">
<attribution license="cc4" from="Microsoft" modified="false" />The error message that explains the reason for the exception. </param>
<param name="e">
<attribution license="cc4" from="Microsoft" modified="false" />The exception that is the cause of the current exception. If the <paramref name="innerException" /> parameter is not null, the current exception is raised in a catch block that handles the inner exception. </param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public HostProtectionException (string message, System.Security.Permissions.HostProtectionResource protectedResources, System.Security.Permissions.HostProtectionResource demandedResources);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string message, valuetype System.Security.Permissions.HostProtectionResource protectedResources, valuetype System.Security.Permissions.HostProtectionResource demandedResources) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="message" Type="System.String" />
<Parameter Name="protectedResources" Type="System.Security.Permissions.HostProtectionResource" />
<Parameter Name="demandedResources" Type="System.Security.Permissions.HostProtectionResource" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <paramref name="demandedResources" /> parameter specifies the demanded host protection categories that caused the exception to be thrown. For example, suppose that a method has a <see cref="T:System.Security.Permissions.HostProtectionAttribute" /> attribute that indicates that the method exposes shared state. When the method is called, the <see cref="T:System.Security.Permissions.HostProtectionAttribute" /> performs a link demand for shared state. If the host has set shared state as a prohibited category, then a <see cref="T:System.Security.HostProtectionException" /> is raised with a <paramref name="demandedResources" /> property value of <see cref="F:System.Security.Permissions.HostProtectionResource.SharedState" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Security.HostProtectionException" /> class with a specified error message, the protected host resources, and the host resources that caused the exception to be thrown.</para>
</summary>
<param name="message">
<attribution license="cc4" from="Microsoft" modified="false" />The error message that explains the reason for the exception.</param>
<param name="protectedResources">
<attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of the enumeration values that specify the host resources that are inaccessible to partially trusted code.</param>
<param name="demandedResources">
<attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of the enumeration values that specify the demanded host resources.</param>
</Docs>
</Member>
<Member MemberName="DemandedResources">
<MemberSignature Language="C#" Value="public System.Security.Permissions.HostProtectionResource DemandedResources { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype System.Security.Permissions.HostProtectionResource DemandedResources" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.Permissions.HostProtectionResource</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This property returns the demanded host protection categories that caused the exception to be thrown. For example, suppose that a method has a <see cref="T:System.Security.Permissions.HostProtectionAttribute" /> attribute that indicates that the method exposes shared state. When the method is called, the <see cref="T:System.Security.Permissions.HostProtectionAttribute" /> performs a link demand for shared state. If the host has set shared state as a prohibited category, then a <see cref="T:System.Security.HostProtectionException" /> is raised, and the value of the <see cref="P:System.Security.HostProtectionException.DemandedResources" /> property is <see cref="F:System.Security.Permissions.HostProtectionResource.SharedState" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the demanded host protection resources that caused the exception to be thrown.</para>
</summary>
</Docs>
</Member>
<Member MemberName="GetObjectData">
<MemberSignature Language="C#" Value="public override void GetObjectData (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance void GetObjectData(class System.Runtime.Serialization.SerializationInfo info, valuetype System.Runtime.Serialization.StreamingContext context) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="info" Type="System.Runtime.Serialization.SerializationInfo" />
<Parameter Name="context" Type="System.Runtime.Serialization.StreamingContext" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Security.HostProtectionException.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)" /> method sets a <see cref="T:System.Runtime.Serialization.SerializationInfo" /> object with all the exception object data targeted for serialization. During deserialization, the exception is reconstructed from the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> transmitted over the stream.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Sets the specified <see cref="T:System.Runtime.Serialization.SerializationInfo" /> object with information about the host protection exception.</para>
</summary>
<param name="info">
<attribution license="cc4" from="Microsoft" modified="false" />The serialized object data about the exception being thrown.</param>
<param name="context">
<attribution license="cc4" from="Microsoft" modified="false" />The contextual information about the source or destination.</param>
</Docs>
</Member>
<Member MemberName="ProtectedResources">
<MemberSignature Language="C#" Value="public System.Security.Permissions.HostProtectionResource ProtectedResources { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype System.Security.Permissions.HostProtectionResource ProtectedResources" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.Permissions.HostProtectionResource</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This property identifies the host protection categories that the host has specified as being inaccessible to code that is not fully trusted.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the host protection resources that are inaccessible to partially trusted code.</para>
</summary>
</Docs>
</Member>
<Member MemberName="ToString">
<MemberSignature Language="C#" Value="public override string ToString ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance string ToString() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The returned string is a textual representation of the exception.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns a string representation of the current host protection exception.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A string representation of the current <see cref="T:System.Security.HostProtectionException" />.</para>
</returns>
</Docs>
</Member>
</Members>
</Type>

260
mcs/class/corlib/Documentation/en/System.Security/HostSecurityManager.xml Normal file
View File

@@ -0,0 +1,260 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="HostSecurityManager" FullName="System.Security.HostSecurityManager">
<TypeSignature Language="C#" Value="public class HostSecurityManager" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi serializable beforefieldinit HostSecurityManager 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>When you create a new <see cref="T:System.AppDomain" />, the common language runtime queries the <see cref="T:System.AppDomainManager" /> for the presence of a <see cref="T:System.Security.HostSecurityManager" />, which participates in making security decisions for the <see cref="T:System.AppDomain" />. Host providers should implement a host security manager that inherits from the <see cref="T:System.Security.HostSecurityManager" /> class.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Allows the control and customization of security behavior for application domains.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public HostSecurityManager ();" />
<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.Security.HostSecurityManager" /> class.</para>
</summary>
</Docs>
</Member>
<Member MemberName="DetermineApplicationTrust">
<MemberSignature Language="C#" Value="public virtual System.Security.Policy.ApplicationTrust DetermineApplicationTrust (System.Security.Policy.Evidence applicationEvidence, System.Security.Policy.Evidence activatorEvidence, System.Security.Policy.TrustManagerContext context);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Security.Policy.ApplicationTrust DetermineApplicationTrust(class System.Security.Policy.Evidence applicationEvidence, class System.Security.Policy.Evidence activatorEvidence, class System.Security.Policy.TrustManagerContext context) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.Policy.ApplicationTrust</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="applicationEvidence" Type="System.Security.Policy.Evidence" />
<Parameter Name="activatorEvidence" Type="System.Security.Policy.Evidence" />
<Parameter Name="context" Type="System.Security.Policy.TrustManagerContext" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method can be overridden by a derived class. The base implementation calls the application security manager to determine if the application should be executed. </para>
<para>The base implementation does not use the activator evidence. However, an overridden implementation could use the activator evidence to determine the security evidence for the application domain attempting to activate the application.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Determines whether an application should be executed.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An object that contains trust information about the application.</para>
</returns>
<param name="applicationEvidence">
<attribution license="cc4" from="Microsoft" modified="false" />The evidence for the application to be activated.</param>
<param name="activatorEvidence">
<attribution license="cc4" from="Microsoft" modified="false" />Optionally, the evidence for the activating application domain. </param>
<param name="context">
<attribution license="cc4" from="Microsoft" modified="false" />The trust context. </param>
</Docs>
</Member>
<Member MemberName="DomainPolicy">
<MemberSignature Language="C#" Value="public virtual System.Security.Policy.PolicyLevel DomainPolicy { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Security.Policy.PolicyLevel DomainPolicy" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.Policy.PolicyLevel</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This property can be overridden in a derived class. The base implementation always returns null. </para>
<para>This property is called at <see cref="T:System.AppDomain" /> creation time. It allows a host to supply a policy for the current <see cref="T:System.AppDomain" />. A policy level consists of the following:</para>
<list type="bullet">
<item>
<para>A set of code groups organized into a single rooted tree.</para>
</item>
<item>
<para>A set of named permission sets that are referenced by the code groups to specify permissions to be granted to code belonging to the code group.</para>
</item>
<item>
<para>A list of fully trusted assemblies.</para>
</item>
</list>
<block subset="none" type="note">
<para>See the Notes to Inheritors for the <see cref="T:System.Security.HostSecurityManager" /> class for critical implementation information.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>When overridden in a derived class, gets the security policy for the current application domain.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Flags">
<MemberSignature Language="C#" Value="public virtual System.Security.HostSecurityManagerOptions Flags { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype System.Security.HostSecurityManagerOptions Flags" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.HostSecurityManagerOptions</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This property can be overridden in a derived class. The base implementation always returns <see cref="F:System.Security.HostSecurityManagerOptions.AllFlags" />. </para>
<para>The derived host can change the value of this property when only a subset of the <see cref="T:System.Security.HostSecurityManagerOptions" /> is of interest. The possible subsets include none, the refused set, the policy level, and assembly evidence. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the flag representing the security policy components of concern to the host.</para>
</summary>
</Docs>
</Member>
<Member MemberName="ProvideAppDomainEvidence">
<MemberSignature Language="C#" Value="public virtual System.Security.Policy.Evidence ProvideAppDomainEvidence (System.Security.Policy.Evidence inputEvidence);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Security.Policy.Evidence ProvideAppDomainEvidence(class System.Security.Policy.Evidence inputEvidence) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.Policy.Evidence</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="inputEvidence" Type="System.Security.Policy.Evidence" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method can be overridden in a derived class. </para>
<para>This method is called whenever an <see cref="T:System.AppDomain" /> object is created. The <paramref name="inputEvidence" /> parameter is the computed evidence from the common language runtime. The host implementation can choose to extend or reduce the evidence. The return value is the evidence to be used for the application domain. The base implementation always returns the evidence object passed in as the <paramref name="inputEvidence" /> parameter. </para>
<block subset="none" type="note">
<para>See the Notes to Inheritors for the <see cref="T:System.Security.HostSecurityManager" /> class for critical implementation information.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides the application domain evidence for an assembly being loaded.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The evidence to be used for the <see cref="T:System.AppDomain" />.</para>
</returns>
<param name="inputEvidence">
<attribution license="cc4" from="Microsoft" modified="false" />Additional evidence to add to the <see cref="T:System.AppDomain" /> evidence.</param>
</Docs>
</Member>
<Member MemberName="ProvideAssemblyEvidence">
<MemberSignature Language="C#" Value="public virtual System.Security.Policy.Evidence ProvideAssemblyEvidence (System.Reflection.Assembly loadedAssembly, System.Security.Policy.Evidence inputEvidence);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Security.Policy.Evidence ProvideAssemblyEvidence(class System.Reflection.Assembly loadedAssembly, class System.Security.Policy.Evidence inputEvidence) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.Policy.Evidence</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="loadedAssembly" Type="System.Reflection.Assembly" />
<Parameter Name="inputEvidence" Type="System.Security.Policy.Evidence" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method can be overridden in a derived class. </para>
<para>This method is called whenever an assembly is loaded, either implicitly or explicitly. The passed in parameters are the assembly being loaded, and the computed evidence from the common language runtime. The host implementation can choose to extend or reduce the evidence. The return value is the evidence to be used for the assembly. The base implementation always returns the evidence object passed in as the <paramref name="inputEvidence" /> parameter. </para>
<block subset="none" type="note">
<para>See the Notes to Inheritors for the <see cref="T:System.Security.HostSecurityManager" /> class for critical implementation information.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides the assembly evidence for an assembly being loaded.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The evidence to be used for the assembly.</para>
</returns>
<param name="loadedAssembly">
<attribution license="cc4" from="Microsoft" modified="false" />The loaded assembly. </param>
<param name="inputEvidence">
<attribution license="cc4" from="Microsoft" modified="false" />Additional evidence to add to the assembly evidence.</param>
</Docs>
</Member>
<Member MemberName="ResolvePolicy">
<MemberSignature Language="C#" Value="public virtual System.Security.PermissionSet ResolvePolicy (System.Security.Policy.Evidence evidence);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Security.PermissionSet ResolvePolicy(class System.Security.Policy.Evidence evidence) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.PermissionSet</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method invokes the security policy engine, providing it with the specified evidence. The result is determined by the security policy.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Determines what permissions to grant to code based on the specified evidence.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The permission set that can be granted by the security system.</para>
</returns>
<param name="evidence">
<attribution license="cc4" from="Microsoft" modified="false" />The evidence set used to evaluate policy.</param>
</Docs>
</Member>
</Members>
</Type>

164
mcs/class/corlib/Documentation/en/System.Security/HostSecurityManagerOptions.xml Normal file
View File

@@ -0,0 +1,164 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="HostSecurityManagerOptions" FullName="System.Security.HostSecurityManagerOptions">
<TypeSignature Language="C#" Value="public enum HostSecurityManagerOptions" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi serializable sealed HostSecurityManagerOptions extends System.Enum" />
<AssemblyInfo>
<AssemblyName>mscorlib</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Enum</BaseTypeName>
</Base>
<Attributes>
<Attribute>
<AttributeName>System.Flags</AttributeName>
</Attribute>
<Attribute>
<AttributeName>System.Runtime.InteropServices.ComVisible(true)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies the security policy components to be used by the host security manager.</para>
</summary>
</Docs>
<Members>
<Member MemberName="AllFlags">
<MemberSignature Language="C#" Value="AllFlags" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Security.HostSecurityManagerOptions AllFlags = int32(31)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.HostSecurityManagerOptions</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use all security policy components.</para>
</summary>
</Docs>
</Member>
<Member MemberName="HostAppDomainEvidence">
<MemberSignature Language="C#" Value="HostAppDomainEvidence" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Security.HostSecurityManagerOptions HostAppDomainEvidence = int32(1)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.HostSecurityManagerOptions</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use the application domain evidence.</para>
</summary>
</Docs>
</Member>
<Member MemberName="HostAssemblyEvidence">
<MemberSignature Language="C#" Value="HostAssemblyEvidence" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Security.HostSecurityManagerOptions HostAssemblyEvidence = int32(4)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.HostSecurityManagerOptions</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use the assembly evidence.</para>
</summary>
</Docs>
</Member>
<Member MemberName="HostDetermineApplicationTrust">
<MemberSignature Language="C#" Value="HostDetermineApplicationTrust" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Security.HostSecurityManagerOptions HostDetermineApplicationTrust = int32(8)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.HostSecurityManagerOptions</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Route calls to the <see cref="M:System.Security.Policy.ApplicationSecurityManager.DetermineApplicationTrust(System.ActivationContext,System.Security.Policy.TrustManagerContext)" /> method to the <see cref="M:System.Security.HostSecurityManager.DetermineApplicationTrust(System.Security.Policy.Evidence,System.Security.Policy.Evidence,System.Security.Policy.TrustManagerContext)" /> method first.</para>
</summary>
</Docs>
</Member>
<Member MemberName="HostPolicyLevel">
<MemberSignature Language="C#" Value="HostPolicyLevel" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Security.HostSecurityManagerOptions HostPolicyLevel = int32(2)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.HostSecurityManagerOptions</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use the policy level specified in the <see cref="P:System.Security.HostSecurityManager.DomainPolicy" /> property.</para>
</summary>
</Docs>
</Member>
<Member MemberName="HostResolvePolicy">
<MemberSignature Language="C#" Value="HostResolvePolicy" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Security.HostSecurityManagerOptions HostResolvePolicy = int32(16)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.HostSecurityManagerOptions</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use the <see cref="M:System.Security.HostSecurityManager.ResolvePolicy(System.Security.Policy.Evidence)" /> method to resolve the application evidence.</para>
</summary>
</Docs>
</Member>
<Member MemberName="None">
<MemberSignature Language="C#" Value="None" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Security.HostSecurityManagerOptions None = int32(0)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.HostSecurityManagerOptions</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use none of the security policy components.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

49
mcs/class/corlib/Documentation/en/System.Security/IEvidenceFactory.xml Normal file
View File

@@ -0,0 +1,49 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="IEvidenceFactory" FullName="System.Security.IEvidenceFactory">
<TypeSignature Maintainer="auto" Language="C#" Value="public interface IEvidenceFactory" />
<TypeSignature Language="ILAsm" Value=".class public interface auto ansi abstract IEvidenceFactory" />
<AssemblyInfo>
<AssemblyName>mscorlib</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.Runtime.InteropServices.ComVisible(true)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets an object's <see cref="T:System.Security.Policy.Evidence" />.</para>
</summary>
</Docs>
<Members>
<Member MemberName="Evidence">
<MemberSignature Language="C#" Value="public System.Security.Policy.Evidence Evidence { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Security.Policy.Evidence Evidence" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.Policy.Evidence</ReturnType>
</ReturnValue>
<Docs>
<value>To be added: an object of type 'Policy.Evidence'</value>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets <see cref="T:System.Security.Policy.Evidence" /> that verifies the current object's identity.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

271
mcs/class/corlib/Documentation/en/System.Security/IPermission.xml Normal file
View File

@@ -0,0 +1,271 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="IPermission" FullName="System.Security.IPermission" FullNameSP="System_Security_IPermission" Maintainer="ecma">
<TypeSignature Language="ILASM" Value=".class interface public abstract IPermission" />
<TypeSignature Language="C#" Value="public interface IPermission : System.Security.ISecurityEncodable" />
<TypeSignature Language="ILAsm" Value=".class public interface auto ansi abstract IPermission implements class System.Security.ISecurityEncodable" />
<MemberOfLibrary>BCL</MemberOfLibrary>
<AssemblyInfo>
<AssemblyName>mscorlib</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00 ]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Interfaces>
<Interface>
<InterfaceName>System.Security.ISecurityEncodable</InterfaceName>
</Interface>
</Interfaces>
<Attributes>
<Attribute>
<AttributeName>System.Runtime.InteropServices.ComVisible(true)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Permissions in the common language runtime are objects that describe sets of operations that can be secured for specified resources. A permission object describes operations or access that is subject to security control; it does not represent access or a right to perform operations. Permissions are used by both application code and the .NET Framework security system in the following ways.</para>
<list type="bullet">
<item>
<para>Code requests the permissions it needs in order to run.</para>
</item>
<item>
<para>The security system policy grants permissions to code in order for it to run.</para>
</item>
<item>
<para>Code demands that calling code has a permission.</para>
</item>
<item>
<para>Code overrides the security stack using assert/deny/permit-only.</para>
</item>
</list>
<block subset="none" type="note">
<para>If you write a new permission, you must implement this interface in your class.</para>
</block>
<block subset="none" type="note">
<para>A permission can be accessed by multiple threads. When implementing this interface, you must guarantee that the <see cref="M:System.Security.IPermission.IsSubsetOf(System.Security.IPermission)" />, <see cref="M:System.Security.IPermission.Intersect(System.Security.IPermission)" />, <see cref="M:System.Security.IPermission.Union(System.Security.IPermission)" />, and <see cref="M:System.Security.IPermission.Copy" /> method implementations are thread safe. </para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Defines methods implemented by permission types.</para>
</summary>
</Docs>
<Members>
<Member MemberName="Copy">
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual abstract class System.Security.IPermission Copy()" />
<MemberSignature Language="C#" Value="public System.Security.IPermission Copy ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Security.IPermission Copy() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.IPermission</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A copy of a permission represents the same access to resources as the original permission.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates and returns an identical copy of the current permission.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A copy of the current permission.</para>
</returns>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Demand">
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual abstract void Demand()" />
<MemberSignature Language="C#" Value="public void Demand ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void Demand() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<exception cref="T:System.Security.SecurityException">
<para> A caller does not have the permission specified by the current instance.</para>
</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is typically used by secure libraries to ensure that callers have permission to access a resource. For example, a file class in a secure class library calls <see cref="M:System.Security.CodeAccessPermission.Demand" /> for the necessary <see cref="T:System.Security.Permissions.FileIOPermission" /> before performing a file operation requested by the caller.</para>
<para>Although the majority of the classes that implement this interface method satisfy the security criteria by performing a full stack walk, a stack walk is not necessarily performed. An example of an implementation that does not perform a stack walk is <see cref="M:System.Security.Permissions.PrincipalPermission.Demand" />.</para>
<para>When a stack walk is performed, the permissions of the code that calls this method are not examined; the check begins from the immediate caller of that code and proceeds up the stack. The call stack is typically represented as growing down, so that methods higher in the call stack call methods lower in the call stack. <see cref="M:System.Security.CodeAccessPermission.Demand" /> succeeds only if no <see cref="T:System.Security.SecurityException" /> is raised.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Throws a <see cref="T:System.Security.SecurityException" /> at run time if the security requirement is not met.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Intersect">
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual abstract class System.Security.IPermission Intersect(class System.Security.IPermission target)" />
<MemberSignature Language="C#" Value="public System.Security.IPermission Intersect (System.Security.IPermission target);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Security.IPermission Intersect(class System.Security.IPermission target) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.IPermission</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="target" Type="System.Security.IPermission" />
</Parameters>
<Docs>
<exception cref="T:System.ArgumentException">
<paramref name="target" /> is not <see langword="null" /> and is not of the same type as the current instance.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The intersection of two permissions is a permission that describes the set of operations they both describe in common. Only a demand that passes both original permissions will pass the intersection.</para>
<para>The following statements are required to be true for all implementations of the <see cref="M:System.Security.IPermission.Intersect(System.Security.IPermission)" /> method. <paramref name="X" /> and <paramref name="Y" /> represent <see cref="T:System.Security.IPermission" /> object references that are not null.</para>
<list type="bullet">
<item>
<para>
<paramref name="X" />.Intersect(<paramref name="X" />) returns a value equal to <paramref name="X" />.</para>
</item>
<item>
<para>
<paramref name="X" />.Intersect(<paramref name="Y" />) returns the same value as <paramref name="Y" />.Intersect(<paramref name="X" />).</para>
</item>
<item>
<para>
<paramref name="X" />.Intersect(null) returns null.</para>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A new permission that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty.</para>
</returns>
<param name="target">
<attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be of the same type as the current permission. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="IsSubsetOf">
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual abstract bool IsSubsetOf(class System.Security.IPermission target)" />
<MemberSignature Language="C#" Value="public bool IsSubsetOf (System.Security.IPermission target);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance bool IsSubsetOf(class System.Security.IPermission target) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="target" Type="System.Security.IPermission" />
</Parameters>
<Docs>
<exception cref="T:System.ArgumentException">
<paramref name="target" /> is not <see langword="null" /> and is not of the same type as the current instance. </exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The current permission is a subset of the specified permission if the current permission specifies a set of operations that is wholly contained by the specified permission. For example, a permission that represents access to C:\example.txt is a subset of a permission that represents access to C:\. If this method returns true, the current permission represents no more access to the protected resource than does the specified permission.</para>
<para>The following statements are required to be true for all implementations of the <see cref="M:System.Security.IPermission.IsSubsetOf(System.Security.IPermission)" /> method. <paramref name="X" />, <paramref name="Y" />, and <paramref name="Z" /> represent <see cref="T:System.Security.IPermission" /> objects that are not null.</para>
<list type="bullet">
<item>
<para>
<paramref name="X" />.IsSubsetOf(<paramref name="X" />) returns true.</para>
</item>
<item>
<para>
<paramref name="X" />.IsSubsetOf(<paramref name="Y" />) returns the same value as <paramref name="Y" />.IsSubsetOf(<paramref name="X" />) if and only if <paramref name="X" /> and <paramref name="Y" /> represent the same set of permissions.</para>
</item>
<item>
<para>If <paramref name="X" />.IsSubsetOf(<paramref name="Y" />) and <paramref name="Y" />.IsSubsetOf(<paramref name="Z" />) both return true, <paramref name="X" />.IsSubsetOf(<paramref name="Z" />) returns true.</para>
</item>
</list>
<para>If <paramref name="X" /> represents an empty <see cref="T:System.Security.IPermission" /> object with a permission state of <see cref="F:System.Security.Permissions.PermissionState.None" /> and <paramref name="Y" /> represents an <see cref="T:System.Security.IPermission" /> object that is null, <paramref name="X" />.IsSubsetOf(<paramref name="Y" />) returns true. If <paramref name="Z" /> is also an empty permission, the compound set operation <paramref name="X" />.Union(Z).IsSubsetOf(Y) also returns true because the union of two empty permissions is an empty permission.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Determines whether the current permission is a subset of the specified permission.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
</returns>
<param name="target">
<attribution license="cc4" from="Microsoft" modified="false" />A permission that is to be tested for the subset relationship. This permission must be of the same type as the current permission. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Union">
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual abstract class System.Security.IPermission Union(class System.Security.IPermission target)" />
<MemberSignature Language="C#" Value="public System.Security.IPermission Union (System.Security.IPermission target);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Security.IPermission Union(class System.Security.IPermission target) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.IPermission</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="target" Type="System.Security.IPermission" />
</Parameters>
<Docs>
<exception cref="T:System.ArgumentException">
<paramref name="target" /> is not <see langword="null" /> and is not of the same type as the current instance. </exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The result of a call to <see cref="M:System.Security.IPermission.Union(System.Security.IPermission)" /> is a permission that represents all the operations represented by both the current permission and the specified permission. Any demand that passes either permission passes their union.</para>
<para>The following statements are required to be true for all implementations of the <see cref="M:System.Security.IPermission.Union(System.Security.IPermission)" /> method. <paramref name="X" /> and <paramref name="Y" /> represent <see cref="T:System.Security.IPermission" /> objects that are not null.</para>
<list type="bullet">
<item>
<para>
<paramref name="X" />.Union(<paramref name="X" />) returns an object that has the same value as <paramref name="X" />.</para>
</item>
<item>
<para>
<paramref name="X" />.Union(<paramref name="Y" />) returns an object that has the same value as the object returned by <paramref name="Y" />.Union(<paramref name="X" />).</para>
</item>
<item>
<para>
<paramref name="X" />.Union(null) returns an object that has the same value as <paramref name="X" />.</para>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates a permission that is the union of the current permission and the specified permission.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A new permission that represents the union of the current permission and the specified permission.</para>
</returns>
<param name="target">
<attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
</Members>
<TypeExcluded>0</TypeExcluded>
</Type>

90
mcs/class/corlib/Documentation/en/System.Security/ISecurityEncodable.xml Normal file
View File

@@ -0,0 +1,90 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="ISecurityEncodable" FullName="System.Security.ISecurityEncodable">
<TypeSignature Maintainer="auto" Language="C#" Value="public interface ISecurityEncodable" />
<TypeSignature Language="ILAsm" Value=".class public interface auto ansi abstract ISecurityEncodable" />
<AssemblyInfo>
<AssemblyName>mscorlib</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.Runtime.InteropServices.ComVisible(true)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The XML representation of permissions is used to describe instances of permissions for code requests, declarative security permission sets, and security policy configuration.</para>
<block subset="none" type="note">
<para>You must implement this interface for any new permission object.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Defines the methods that convert permission object state to and from XML element representation.</para>
</summary>
</Docs>
<Members>
<Member MemberName="FromXml">
<MemberSignature Language="C#" Value="public void FromXml (System.Security.SecurityElement e);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void FromXml(class System.Security.SecurityElement e) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="e" Type="System.Security.SecurityElement" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Custom code that extends security objects needs to implement the <see cref="M:System.Security.ISecurityEncodable.ToXml" /> and <see cref="M:System.Security.ISecurityEncodable.FromXml(System.Security.SecurityElement)" /> methods to make the objects security-encodable.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Reconstructs a security object with a specified state from an XML encoding.</para>
</summary>
<param name="e">
<attribution license="cc4" from="Microsoft" modified="false" />The XML encoding to use to reconstruct the security object. </param>
</Docs>
</Member>
<Member MemberName="ToXml">
<MemberSignature Language="C#" Value="public System.Security.SecurityElement ToXml ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Security.SecurityElement ToXml() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.SecurityElement</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Custom code that extends security objects needs to implement the <see cref="M:System.Security.ISecurityEncodable.ToXml" /> and <see cref="M:System.Security.ISecurityEncodable.FromXml(System.Security.SecurityElement)" /> methods to make the objects security-encodable.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates an XML encoding of the security object and its current state.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An XML encoding of the security object, including any state information.</para>
</returns>
</Docs>
</Member>
</Members>
</Type>

95
mcs/class/corlib/Documentation/en/System.Security/ISecurityPolicyEncodable.xml Normal file
View File

@@ -0,0 +1,95 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="ISecurityPolicyEncodable" FullName="System.Security.ISecurityPolicyEncodable">
<TypeSignature Maintainer="auto" Language="C#" Value="public interface ISecurityPolicyEncodable" />
<TypeSignature Language="ILAsm" Value=".class public interface auto ansi abstract ISecurityPolicyEncodable" />
<AssemblyInfo>
<AssemblyName>mscorlib</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.Runtime.InteropServices.ComVisible(true)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This interface is similar to <see cref="T:System.Security.ISecurityEncodable" />, with the exception that it includes policy-level context. Policy level is needed to resolve references to named permission sets.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Supports the methods that convert permission object state to and from an XML element representation.</para>
</summary>
</Docs>
<Members>
<Member MemberName="FromXml">
<MemberSignature Language="C#" Value="public void FromXml (System.Security.SecurityElement e, System.Security.Policy.PolicyLevel level);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void FromXml(class System.Security.SecurityElement e, class System.Security.Policy.PolicyLevel level) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="e" Type="System.Security.SecurityElement" />
<Parameter Name="level" Type="System.Security.Policy.PolicyLevel" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Custom code that extends security policy objects needs to implement the <see cref="M:System.Security.ISecurityPolicyEncodable.ToXml(System.Security.Policy.PolicyLevel)" /> and <see cref="M:System.Security.ISecurityPolicyEncodable.FromXml(System.Security.SecurityElement,System.Security.Policy.PolicyLevel)" /> methods to make the objects security-encodable.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Reconstructs a security object with a specified state from an XML encoding.</para>
</summary>
<param name="e">
<attribution license="cc4" from="Microsoft" modified="false" />The XML encoding to use to reconstruct the security object. </param>
<param name="level">
<attribution license="cc4" from="Microsoft" modified="false" />The policy-level context to resolve named permission set references. </param>
</Docs>
</Member>
<Member MemberName="ToXml">
<MemberSignature Language="C#" Value="public System.Security.SecurityElement ToXml (System.Security.Policy.PolicyLevel level);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Security.SecurityElement ToXml(class System.Security.Policy.PolicyLevel level) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.SecurityElement</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="level" Type="System.Security.Policy.PolicyLevel" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The policy-level context is provided for resolution of named permission set references. For example, code groups use policy level to find named permission sets by name.</para>
<para>Custom code that extends security policy objects needs to implement the <see cref="M:System.Security.ISecurityPolicyEncodable.ToXml(System.Security.Policy.PolicyLevel)" /> and <see cref="M:System.Security.ISecurityPolicyEncodable.FromXml(System.Security.SecurityElement,System.Security.Policy.PolicyLevel)" /> methods to make the objects security-encodable.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates an XML encoding of the security object and its current state.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The root element of the XML representation of the policy object.</para>
</returns>
<param name="level">
<attribution license="cc4" from="Microsoft" modified="false" />The policy-level context to resolve named permission set references. </param>
</Docs>
</Member>
</Members>
</Type>

142
mcs/class/corlib/Documentation/en/System.Security/IStackWalk.xml Normal file
View File

@@ -0,0 +1,142 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="IStackWalk" FullName="System.Security.IStackWalk">
<TypeSignature Maintainer="auto" Language="C#" Value="public interface IStackWalk" />
<TypeSignature Language="ILAsm" Value=".class public interface auto ansi abstract IStackWalk" />
<AssemblyInfo>
<AssemblyName>mscorlib</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.Runtime.InteropServices.ComVisible(true)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Partially trusted code always presents a security risk. It can sometimes be manipulated to perform actions on behalf of malicious code that does not have permission to access a resource. In this way, malicious code can achieve higher security access than it should be allowed.</para>
<para>The common language runtime helps protect managed code from these attacks by running a stack walk on all calls. The stack walk requires that all code in the call stack has permission to access a protected resource. Because the code attempting the attack will always be somewhere in the call stack, it will be unable to exceed its own security permissions.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Manages the stack walk that determines whether all callers in the call stack have the required permissions to access a protected resource.</para>
</summary>
</Docs>
<Members>
<Member MemberName="Assert">
<MemberSignature Language="C#" Value="public void Assert ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void Assert() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Calling <see cref="M:System.Security.IStackWalk.Assert" /> stops the permission check on callers higher in the call stack. Therefore, even if these callers do not have the requisite permissions, they can still access resources. An assertion is effective only if the code that calls <see cref="M:System.Security.IStackWalk.Assert" /> passes the security check for the permission that it is asserting.</para>
<para>A call to <see cref="M:System.Security.IStackWalk.Assert" /> is effective until the calling code returns to its caller or until a subsequent call to <see cref="M:System.Security.IStackWalk.Assert" /> renders the previous assertion ineffective. Also, <see cref="M:System.Security.CodeAccessPermission.RevertAssert" /> or <see cref="M:System.Security.CodeAccessPermission.RevertAll" /> removes a pending <see cref="M:System.Security.IStackWalk.Assert" />.</para>
<para>
<see cref="M:System.Security.IStackWalk.Assert" /> is ignored for a permission not granted because a demand for that permission will not succeed. However, if code lower on the call stack calls <see cref="M:System.Security.IStackWalk.Demand" /> for that permission, a <see cref="T:System.Security.SecurityException" /> is thrown when the stack walk reaches the code that tried to call <see cref="M:System.Security.IStackWalk.Assert" />. This happens because the code that called <see cref="M:System.Security.IStackWalk.Assert" /> has not been granted the permission, even though it tried to <see cref="M:System.Security.IStackWalk.Assert" /> it.</para>
<block subset="none" type="note">
<para>Because calling <see cref="M:System.Security.IStackWalk.Assert" /> removes the requirement that all code in the call chain must be granted permission to access the specified resource, it can open up security vulnerabilities if used incorrectly or inappropriately. Therefore, it should be used with great caution.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Asserts that 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.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Demand">
<MemberSignature Language="C#" Value="public void Demand ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void Demand() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is typically used by secure libraries to ensure that callers have permission to access a resource. For example, a file class in a secure class library calls <see cref="M:System.Security.IStackWalk.Demand" /> for the necessary <see cref="T:System.Security.Permissions.FileIOPermission" /> before performing a file operation requested by the caller.</para>
<para>The permissions of the code that calls this method are not examined; the check begins from the immediate caller of that code and proceeds up the stack. <see cref="M:System.Security.IStackWalk.Demand" /> succeeds only if no <see cref="T:System.Security.SecurityException" /> is raised.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Determines at run time whether all callers in the call stack have been granted the permission specified by the current permission object.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Deny">
<MemberSignature Language="C#" Value="public void Deny ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void Deny() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method prevents callers higher in the call stack from accessing the protected resource through the code that calls this method, even if those callers have been granted permission to access it. The call stack is typically represented as growing down, so that methods higher in the call stack call methods lower in the call stack.</para>
<para>
<see cref="M:System.Security.IStackWalk.Deny" /> can limit the liability of the programmer or help prevent accidental security vulnerabilities because it helps prevent the method that calls <see cref="M:System.Security.IStackWalk.Deny" /> from being used to access the resource protected by the denied permission. If a method calls <see cref="M:System.Security.IStackWalk.Deny" /> on a permission, and if a <see cref="M:System.Security.IStackWalk.Demand" /> for that permission is invoked by a caller lower in the call stack, that security check will fail when it reaches the <see cref="M:System.Security.IStackWalk.Deny" />.</para>
<para>
<see cref="M:System.Security.IStackWalk.Deny" /> is ignored for a permission not granted because a demand for that permission will not succeed.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Causes every <see cref="M:System.Security.IStackWalk.Demand" /> for the current object that passes through the calling code to fail.</para>
</summary>
</Docs>
</Member>
<Member MemberName="PermitOnly">
<MemberSignature Language="C#" Value="public void PermitOnly ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void PermitOnly() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>
<see cref="M:System.Security.IStackWalk.PermitOnly" /> is similar to <see cref="M:System.Security.IStackWalk.Deny" />, in that both cause stack walks to fail when they would otherwise succeed. The difference is that <see cref="M:System.Security.IStackWalk.Deny" /> specifies permissions that will cause the stack walk to fail, but <see cref="M:System.Security.IStackWalk.PermitOnly" /> specifies the only permissions that do not cause the stack walk to fail. Call this method to ensure that your code can be used to access only the specified resources.</para>
<para>
<see cref="M:System.Security.IStackWalk.PermitOnly" /> is ignored for a permission not granted because a demand for that permission will not succeed. However, if code lower on the call stack later calls <see cref="M:System.Security.IStackWalk.Demand" /> for that permission, a <see cref="T:System.Security.SecurityException" /> is thrown when the stack walk reaches the code that tried to call <see cref="M:System.Security.IStackWalk.PermitOnly" />. This is because the code that called <see cref="M:System.Security.IStackWalk.PermitOnly" /> has not been granted the permission, even though it called <see cref="M:System.Security.IStackWalk.PermitOnly" /> for that permission. The call stack is typically represented as growing down, so that methods higher in the call stack call methods lower in the call stack.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Causes every <see cref="M:System.Security.IStackWalk.Demand" /> for all objects except the current one that passes through the calling code to fail, even if code higher in the call stack has been granted permission to access other resources.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

367
mcs/class/corlib/Documentation/en/System.Security/NamedPermissionSet.xml Normal file
View File

@@ -0,0 +1,367 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="NamedPermissionSet" FullName="System.Security.NamedPermissionSet">
<TypeSignature Maintainer="auto" Language="C#" Value="public sealed class NamedPermissionSet : System.Security.PermissionSet" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi serializable sealed beforefieldinit NamedPermissionSet extends System.Security.PermissionSet" />
<AssemblyInfo>
<AssemblyName>mscorlib</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Security.PermissionSet</BaseTypeName>
</Base>
<Interfaces>
</Interfaces>
<Attributes>
<Attribute>
<AttributeName>System.Runtime.InteropServices.ComVisible(true)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Named permission sets are used in security policy administration to specify the permissions to be granted to code that belongs to certain code groups. Names are strings of alphanumeric characters. Description strings can consist of any printable characters. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Defines a permission set that has a name and description associated with it. This class cannot be inherited.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public NamedPermissionSet (System.Security.NamedPermissionSet permSet);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Security.NamedPermissionSet permSet) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="permSet" Type="System.Security.NamedPermissionSet" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Security.NamedPermissionSet" /> class from another named permission set.</para>
</summary>
<param name="permSet">
<attribution license="cc4" from="Microsoft" modified="false" />The named permission set from which to create the new instance. </param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public NamedPermissionSet (string name);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string name) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="name" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Using this constructor creates a named permission set with no permissions but with an <see cref="F:System.Security.Permissions.PermissionState.Unrestricted" /> permission state. A named permission set in an unrestricted state effectively contains all permissions that implement the <see cref="T:System.Security.Permissions.IUnrestrictedPermission" /> interface. The named permission set will contain all built-in permissions as well as all custom user-defined permissions that implement <see cref="T:System.Security.Permissions.IUnrestrictedPermission" />. All permissions will have the equivalent of an Unrestricted permission state. Permissions that do not implement <see cref="T:System.Security.Permissions.IUnrestrictedPermission" /> will be empty instances.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new, empty instance of the <see cref="T:System.Security.NamedPermissionSet" /> class with the specified name.</para>
</summary>
<param name="name">
<attribution license="cc4" from="Microsoft" modified="false" />The name for the new named permission set. </param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public NamedPermissionSet (string name, System.Security.Permissions.PermissionState state);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string name, valuetype System.Security.Permissions.PermissionState state) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="name" Type="System.String" />
<Parameter Name="state" Type="System.Security.Permissions.PermissionState" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A named permission set in an unrestricted state effectively contains all permissions that implement the <see cref="T:System.Security.Permissions.IUnrestrictedPermission" /> interface. The named permission set will contain all built-in permissions as well as all custom permissions. All permissions will have an Unrestricted <see cref="T:System.Security.Permissions.PermissionState" />. Permissions that do not implement <see cref="T:System.Security.Permissions.IUnrestrictedPermission" />, such as identity permissions, will be empty instances.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Security.NamedPermissionSet" /> class with the specified name in either an unrestricted or a fully restricted state.</para>
</summary>
<param name="name">
<attribution license="cc4" from="Microsoft" modified="false" />The name for the new named permission set. </param>
<param name="state">
<attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Security.Permissions.PermissionState" /> values. </param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public NamedPermissionSet (string name, System.Security.PermissionSet permSet);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string name, class System.Security.PermissionSet permSet) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="name" Type="System.String" />
<Parameter Name="permSet" Type="System.Security.PermissionSet" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Security.NamedPermissionSet" /> class with the specified name from a permission set.</para>
</summary>
<param name="name">
<attribution license="cc4" from="Microsoft" modified="false" />The name for the named permission set. </param>
<param name="permSet">
<attribution license="cc4" from="Microsoft" modified="false" />The permission set from which to take the value of the new named permission set. </param>
</Docs>
</Member>
<Member MemberName="Copy">
<MemberSignature Language="C#" Value="public override System.Security.PermissionSet Copy ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance class System.Security.PermissionSet Copy() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.PermissionSet</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates a permission set copy from a named permission set.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A permission set that is a copy of the permissions in the named permission set.</para>
</returns>
</Docs>
</Member>
<Member MemberName="Copy">
<MemberSignature Language="C#" Value="public System.Security.NamedPermissionSet Copy (string name);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Security.NamedPermissionSet Copy(string name) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.NamedPermissionSet</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="name" Type="System.String" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates a copy of the named permission set with a different name but the same permissions.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A copy of the named permission set with the new name.</para>
</returns>
<param name="name">
<attribution license="cc4" from="Microsoft" modified="false" />The name for the new named permission set. </param>
</Docs>
</Member>
<Member MemberName="Description">
<MemberSignature Language="C#" Value="public string Description { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string Description" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<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>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The description helps the administrator understand in words what permissions the set contains and its intended use.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the text description of the current named permission set.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Equals">
<MemberSignature Language="C#" Value="public override bool Equals (object obj);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance bool Equals(object obj) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.Runtime.InteropServices.ComVisible(false)</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="obj" Type="System.Object" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>For more information, see <see cref="M:System.Object.Equals(System.Object)" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Determines whether the specified <see cref="T:System.Security.NamedPermissionSet" /> object is equal to the current <see cref="T:System.Security.NamedPermissionSet" />.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>true if the specified <see cref="T:System.Security.NamedPermissionSet" /> is equal to the current <see cref="T:System.Security.NamedPermissionSet" /> object; otherwise, false.</para>
</returns>
<param name="obj">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.NamedPermissionSet" /> object to compare with the current <see cref="T:System.Security.NamedPermissionSet" />. </param>
</Docs>
</Member>
<Member MemberName="FromXml">
<MemberSignature Language="C#" Value="public override void FromXml (System.Security.SecurityElement et);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance void FromXml(class System.Security.SecurityElement et) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="et" Type="System.Security.SecurityElement" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method recreates the state of a named permission set from an XML element previously created by <see cref="M:System.Security.NamedPermissionSet.ToXml" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Reconstructs a named permission set with a specified state from an XML encoding.</para>
</summary>
<param name="et">
<attribution license="cc4" from="Microsoft" modified="false" />A security element containing the XML representation of the named permission set. </param>
</Docs>
</Member>
<Member MemberName="GetHashCode">
<MemberSignature Language="C#" Value="public override int GetHashCode ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance int32 GetHashCode() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.Runtime.InteropServices.ComVisible(false)</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The hash code for two instances of the same permission might differ, hence a hash code should not be used to compare two <see cref="T:System.Security.NamedPermissionSet" /> objects.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a hash code for the <see cref="T:System.Security.NamedPermissionSet" /> object that is suitable for use in hashing algorithms and data structures such as a hash table.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A hash code for the current <see cref="T:System.Security.NamedPermissionSet" /> object.</para>
</returns>
</Docs>
</Member>
<Member MemberName="Name">
<MemberSignature Language="C#" Value="public string Name { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string Name" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<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>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Code groups refer to permission sets by name.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the name of the current named permission set.</para>
</summary>
</Docs>
</Member>
<Member MemberName="ToXml">
<MemberSignature Language="C#" Value="public override System.Security.SecurityElement ToXml ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance class System.Security.SecurityElement ToXml() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.SecurityElement</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use <see cref="M:System.Security.NamedPermissionSet.FromXml(System.Security.SecurityElement)" /> to recreate the state represented by the returned element.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates an XML element description of the named permission set.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The XML representation of the named permission set.</para>
</returns>
</Docs>
</Member>
</Members>
</Type>

1087
mcs/class/corlib/Documentation/en/System.Security/PermissionSet.xml Normal file
View File

File diff suppressed because it is too large Load Diff

121
mcs/class/corlib/Documentation/en/System.Security/PolicyLevelType.xml Normal file
View File

@@ -0,0 +1,121 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="PolicyLevelType" FullName="System.Security.PolicyLevelType">
<TypeSignature Maintainer="auto" Language="C#" Value="public enum PolicyLevelType" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi serializable sealed PolicyLevelType extends System.Enum" />
<AssemblyInfo>
<AssemblyName>mscorlib</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Enum</BaseTypeName>
</Base>
<Attributes>
<Attribute>
<AttributeName>System.Runtime.InteropServices.ComVisible(true)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The highest level of security policy is enterprise-wide. Successive lower levels of hierarchy represent further policy restrictions, but can never grant more permissions than allowed by higher levels. The policy levels in order are the following.</para>
<para>1. Enterprise </para>
<para>2. Machine </para>
<para>3. User </para>
<para>4. Application domain </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies the type of a managed code policy level.</para>
</summary>
</Docs>
<Members>
<Member MemberName="AppDomain">
<MemberSignature Language="C#" Value="AppDomain" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Security.PolicyLevelType AppDomain = int32(3)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.PolicyLevelType</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Security policy for all managed code in an application.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Enterprise">
<MemberSignature Language="C#" Value="Enterprise" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Security.PolicyLevelType Enterprise = int32(2)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.PolicyLevelType</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Security policy for all managed code in an enterprise.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Machine">
<MemberSignature Language="C#" Value="Machine" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Security.PolicyLevelType Machine = int32(1)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.PolicyLevelType</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Security policy for all managed code that is run on the computer.</para>
</summary>
</Docs>
</Member>
<Member MemberName="User">
<MemberSignature Language="C#" Value="User" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Security.PolicyLevelType User = int32(0)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.PolicyLevelType</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Security policy for all managed code that is run by the user.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

383
mcs/class/corlib/Documentation/en/System.Security/SecureString.xml Normal file
View File

@@ -0,0 +1,383 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="SecureString" FullName="System.Security.SecureString">
<TypeSignature Language="C#" Value="public sealed class SecureString : IDisposable" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed SecureString extends System.Object implements class System.IDisposable" />
<AssemblyInfo>
<AssemblyName>mscorlib</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>System.IDisposable</InterfaceName>
</Interface>
</Interfaces>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An instance of the <see cref="T:System.String" /> class is both immutable and, when no longer needed, cannot be programmatically scheduled for garbage collection; that is, the instance is read-only after it is created and it is not possible to predict when the instance will be deleted from computer memory. Consequently, if a <see cref="T:System.String" /> object contains sensitive information such as a password, credit card number, or personal data, there is a risk the information could be revealed after it is used because your application cannot delete the data from computer memory. </para>
<para>A <see cref="T:System.Security.SecureString" /> object is similar to a <see cref="T:System.String" /> object in that it has a text value. However, the value of a <see cref="T:System.Security.SecureString" /> object is automatically encrypted, can be modified until your application marks it as read-only, and can be deleted from computer memory by either your application or the .NET Framework garbage collector. </para>
<para>The value of an instance of <see cref="T:System.Security.SecureString" /> is automatically encrypted when the instance is initialized or when the value is modified. Your application can render the instance immutable and prevent further modification by invoking the <see cref="M:System.Security.SecureString.MakeReadOnly" /> method. </para>
<para>Note that <see cref="T:System.Security.SecureString" /> has no members that inspect, compare, or convert the value of a <see cref="T:System.Security.SecureString" />. The absence of such members helps protect the value of the instance from accidental or malicious exposure. Use appropriate members of the <see cref="T:System.Runtime.InteropServices.Marshal" /> class, such as the <see cref="M:System.Runtime.InteropServices.Marshal.SecureStringToBSTR(System.Security.SecureString)" /> method, to manipulate the value of a <see cref="T:System.Security.SecureString" /> object.</para>
<para>The <see cref="T:System.Security.SecureString" /> class and its members are not visible to COM. For more information, see <see cref="T:System.Runtime.InteropServices.ComVisibleAttribute" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents text that should be kept confidential. The text is encrypted for privacy when being used, and deleted from computer memory when no longer needed. This class cannot be inherited.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SecureString ();" />
<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.Security.SecureString" /> class.</para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SecureString (char* value, int length);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(char* value, int32 length) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.CLSCompliant(false)</AttributeName>
</Attribute>
</Attributes>
<Parameters>
<Parameter Name="value" Type="System.Char*" />
<Parameter Name="length" Type="System.Int32" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This constructor initializes the new <see cref="T:System.Security.SecureString" /> object to the number of characters in <paramref name="value" /> specified by <paramref name="length" />; the value of the instance is then encrypted.</para>
<para>In C#, this constructor is defined only in the context of unsafe code.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Security.SecureString" /> class from a subarray of <see cref="T:System.Char" /> objects.</para>
</summary>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />A pointer to an array of <see cref="T:System.Char" /> objects.</param>
<param name="length">
<attribution license="cc4" from="Microsoft" modified="false" />The number of elements of <paramref name="value" /> to include in the new instance.</param>
</Docs>
</Member>
<Member MemberName="AppendChar">
<MemberSignature Language="C#" Value="public void AppendChar (char c);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void AppendChar(char c) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.Runtime.ExceptionServices.HandleProcessCorruptedStateExceptions</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="c" Type="System.Char" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The value of this secure string, if any, is decrypted; <paramref name="c" /> is appended; then the new value of the secure string is encrypted.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Appends a character to the end of the current secure string.</para>
</summary>
<param name="c">
<attribution license="cc4" from="Microsoft" modified="false" />A character to append to this secure string.</param>
</Docs>
</Member>
<Member MemberName="Clear">
<MemberSignature Language="C#" Value="public void Clear ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Clear() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The computer memory that contains the value of this secure string is zeroed, then the length of the value of this secure string is set to zero.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Deletes the value of the current secure string.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Copy">
<MemberSignature Language="C#" Value="public System.Security.SecureString Copy ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Security.SecureString Copy() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.SecureString</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If an instance of a <see cref="T:System.Security.SecureString" /> is marked read-only, the copy of that instance will not be read-only.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates a copy of the current secure string.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A duplicate of this secure string.</para>
</returns>
</Docs>
</Member>
<Member MemberName="Dispose">
<MemberSignature Language="C#" Value="public void Dispose ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void Dispose() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Security.SecureString.Dispose" /> method writes binary zeroes to the allocated memory that contains the value of this <see cref="T:System.Security.SecureString" /> object, then frees the allocated memory. </para>
<para>For more information, see <format type="text/html"><a href="fd376774-1643-499b-869e-9546a3aeea70">Finalize Methods and Destructors</a></format> and <format type="text/html"><a href="22b6cb97-0c80-4eeb-a2cf-5ed7655e37f9">Garbage Collection</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Releases all resources used by the current <see cref="T:System.Security.SecureString" /> object.</para>
</summary>
</Docs>
</Member>
<Member MemberName="InsertAt">
<MemberSignature Language="C#" Value="public void InsertAt (int index, char c);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void InsertAt(int32 index, char c) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.Runtime.ExceptionServices.HandleProcessCorruptedStateExceptions</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="index" Type="System.Int32" />
<Parameter Name="c" Type="System.Char" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The index is zero-based and the first character in this secure string is at index position zero. </para>
<para>The value of the secure string, if any, is decrypted; <paramref name="c" /> is inserted at the specified location; then the new value is encrypted. The <see cref="M:System.Security.SecureString.InsertAt(System.Int32,System.Char)" /> method yields the same results as the <see cref="M:System.Security.SecureString.AppendChar(System.Char)" /> method, which inserts a character at the end of a secure string, if the <paramref name="index" /> parameter of <see cref="M:System.Security.SecureString.InsertAt(System.Int32,System.Char)" /> is set to the length of this instance. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Inserts a character in this secure string at the specified index position.</para>
</summary>
<param name="index">
<attribution license="cc4" from="Microsoft" modified="false" />The index position where parameter <paramref name="c" /> is inserted.</param>
<param name="c">
<attribution license="cc4" from="Microsoft" modified="false" />The character to insert.</param>
</Docs>
</Member>
<Member MemberName="IsReadOnly">
<MemberSignature Language="C#" Value="public bool IsReadOnly ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance bool IsReadOnly() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>After an instance of <see cref="T:System.Security.SecureString" /> is marked read-only by the <see cref="M:System.Security.SecureString.MakeReadOnly" /> method, any attempt to modify the value of the instance throws an <see cref="T:System.InvalidOperationException" />. Use the <see cref="M:System.Security.SecureString.IsReadOnly" /> method to test whether a <see cref="T:System.Security.SecureString" /> is read-only.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Indicates whether this secure string is marked read-only.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>true if this secure string is marked read-only; otherwise, false.</para>
</returns>
</Docs>
</Member>
<Member MemberName="Length">
<MemberSignature Language="C#" Value="public int Length { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance int32 Length" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Int32</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="P:System.Security.SecureString.Length" /> property returns the number of <see cref="T:System.Char" /> objects in this instance, not the number of Unicode characters. The reason is that a Unicode character might be represented by more than one <see cref="T:System.Char" /> object.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the number of characters in the current secure string.</para>
</summary>
</Docs>
</Member>
<Member MemberName="MakeReadOnly">
<MemberSignature Language="C#" Value="public void MakeReadOnly ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void MakeReadOnly() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initialize the text value of an instance of the <see cref="T:System.Security.SecureString" /> class with the <see cref="Overload:System.Security.SecureString.#ctor" /> constructors, and modify the value with the <see cref="M:System.Security.SecureString.Clear" />, <see cref="M:System.Security.SecureString.RemoveAt(System.Int32)" />, <see cref="M:System.Security.SecureString.SetAt(System.Int32,System.Char)" />, <see cref="M:System.Security.SecureString.InsertAt(System.Int32,System.Char)" />, and <see cref="M:System.Security.SecureString.AppendChar(System.Char)" /> methods. </para>
<para>After you have made your final modifications, use the <see cref="M:System.Security.SecureString.MakeReadOnly" /> method to make the value of the instance immutable (read-only). After the value is marked as read-only, any further attempt to modify it throws an <see cref="T:System.InvalidOperationException" />. </para>
<para>The effect of invoking <see cref="M:System.Security.SecureString.MakeReadOnly" /> is permanent because no means is provided to make the secure string modifiable again. Use the <see cref="M:System.Security.SecureString.IsReadOnly" /> method to test whether an instance of <see cref="T:System.Security.SecureString" /> is read-only.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Makes the text value of this secure string read-only. </para>
</summary>
</Docs>
</Member>
<Member MemberName="RemoveAt">
<MemberSignature Language="C#" Value="public void RemoveAt (int index);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void RemoveAt(int32 index) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.Runtime.ExceptionServices.HandleProcessCorruptedStateExceptions</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="index" Type="System.Int32" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The index is zero-based and the first character in this instance is at index position zero.</para>
<para>The value of this secure string, if any, is decrypted; the character at the specified index position is removed; then the new value is encrypted.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Removes the character at the specified index position from this secure string.</para>
</summary>
<param name="index">
<attribution license="cc4" from="Microsoft" modified="false" />The index position of a character in this secure string.</param>
</Docs>
</Member>
<Member MemberName="SetAt">
<MemberSignature Language="C#" Value="public void SetAt (int index, char c);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void SetAt(int32 index, char c) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.Runtime.ExceptionServices.HandleProcessCorruptedStateExceptions</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="index" Type="System.Int32" />
<Parameter Name="c" Type="System.Char" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The index is zero-based and the first character in this instance is at index position zero.</para>
<para>The value of the secure string, if any, is decrypted; <paramref name="c" /> is assigned to the specified index position; then the new value is encrypted.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Replaces the existing character at the specified index position with another character.</para>
</summary>
<param name="index">
<attribution license="cc4" from="Microsoft" modified="false" />The index position of an existing character in this secure string</param>
<param name="c">
<attribution license="cc4" from="Microsoft" modified="false" />A character that replaces the existing character.</param>
</Docs>
</Member>
</Members>
</Type>

294
mcs/class/corlib/Documentation/en/System.Security/SecurityContext.xml Normal file
View File

@@ -0,0 +1,294 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="SecurityContext" FullName="System.Security.SecurityContext">
<TypeSignature Language="C#" Value="public sealed class SecurityContext : IDisposable" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit SecurityContext extends System.Object implements class System.IDisposable" />
<AssemblyInfo>
<AssemblyName>mscorlib</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>System.IDisposable</InterfaceName>
</Interface>
</Interfaces>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Security.SecurityContext" /> object captures all security-related information for a logical thread, including the information contained in the <see cref="T:System.Security.Principal.WindowsIdentity" /> and <see cref="T:System.Threading.CompressedStack" /> objects. This configuration allows the Windows identity and the security elements on the stack to be propagated automatically when the <see cref="T:System.Security.SecurityContext" /> is copied and transferred across asynchronous threads. </para>
<block subset="none" type="note">
<para>The common language runtime (CLR) is aware of impersonation operations performed using only managed code, not of impersonation performed outside of managed code, such as through platform invoke to unmanaged code or through direct calls to Win32 functions. Only managed <see cref="T:System.Security.Principal.WindowsIdentity" /> objects can flow across asynchronous points, unless the alwaysFlowImpersonationPolicy element has been set to true (&lt;alwaysFlowImpersonationPolicy enabled="true"/&gt;). Setting the alwaysFlowImpersonationPolicy element to true specifies that the Windows identity always flows across asynchronous points, regardless of how impersonation was performed. For more information about flowing unmanaged impersonation across asynchronous points, see <format type="text/html"><a href="ee622801-9e46-470b-85ab-88c4b1dd2ee1">&lt;alwaysFlowImpersonationPolicy&gt; Element</a></format>.</para>
</block>
<para>The <see cref="T:System.Security.SecurityContext" /> is part of the larger <see cref="T:System.Threading.ExecutionContext" /> and flows or migrates when the <see cref="T:System.Threading.ExecutionContext" /> flows or migrates.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Encapsulates and propagates all security-related data for execution contexts transferred across threads. This class cannot be inherited.</para>
</summary>
</Docs>
<Members>
<Member MemberName="Capture">
<MemberSignature Language="C#" Value="public static System.Security.SecurityContext Capture ();" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Security.SecurityContext Capture() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.SecurityContext</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The captured security context can be applied to another thread. The <see cref="T:System.Security.SecurityContext" /> consists of the <see cref="T:System.Threading.CompressedStack" /> and the <see cref="T:System.Security.Principal.WindowsIdentity" /> for the executing thread.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Captures the security context for the current thread.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The security context for the current thread.</para>
</returns>
</Docs>
</Member>
<Member MemberName="CreateCopy">
<MemberSignature Language="C#" Value="public System.Security.SecurityContext CreateCopy ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Security.SecurityContext CreateCopy() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.SecurityContext</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The current context must have been acquired through a capture or a copy operation. This method is useful for applying a captured <see cref="T:System.Security.SecurityContext" /> to multiple threads. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates a copy of the current security context.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The security context for the current thread.</para>
</returns>
</Docs>
</Member>
<Member MemberName="Dispose">
<MemberSignature Language="C#" Value="public void Dispose ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void Dispose() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Call Dispose when you are finished using the <see cref="T:System.Security.SecurityContext" />. The Dispose method leaves the <see cref="T:System.Security.SecurityContext" /> in an unusable state. After calling Dispose, you must release all references to the <see cref="T:System.Security.SecurityContext" /> so the garbage collector can reclaim the memory that the <see cref="T:System.Security.SecurityContext" /> was occupying.</para>
<para>For more information, see <format type="text/html"><a href="A17B0066-71C2-4BA4-9822-8E19332FC213">Cleaning Up Unmanaged Resources</a></format> and <format type="text/html"><a href="eb4e1af0-3b48-4fbc-ad4e-fc2f64138bf9">Implementing a Dispose Method</a></format>.</para>
<block subset="none" type="note">
<para>Always call Dispose before you release your last reference to the <see cref="T:System.Security.SecurityContext" />. Otherwise, the resources it is using will not be freed until the garbage collector calls the <see cref="T:System.Security.SecurityContext" /> object's Finalize method.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Releases all resources used by the current instance of the <see cref="T:System.Security.SecurityContext" /> class.</para>
</summary>
</Docs>
</Member>
<Member MemberName="IsFlowSuppressed">
<MemberSignature Language="C#" Value="public static bool IsFlowSuppressed ();" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig bool IsFlowSuppressed() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Security.SecurityContext.IsFlowSuppressed" /> method is used by infrastructure components to determine whether to transfer the <see cref="T:System.Security.SecurityContext" /> information during asynchronous operations.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Determines whether the flow of the security context has been suppressed.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>true if the flow has been suppressed; otherwise, false. </para>
</returns>
</Docs>
</Member>
<Member MemberName="IsWindowsIdentityFlowSuppressed">
<MemberSignature Language="C#" Value="public static bool IsWindowsIdentityFlowSuppressed ();" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig bool IsWindowsIdentityFlowSuppressed() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Security.SecurityContext.IsWindowsIdentityFlowSuppressed" /> method is used by infrastructure components to determine whether to transfer the Windows identity information when the <see cref="T:System.Security.SecurityContext" /> migrates during asynchronous operations.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Determines whether the flow of the Windows identity portion of the current security context has been suppressed.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>true if the flow has been suppressed; otherwise, false. </para>
</returns>
</Docs>
</Member>
<Member MemberName="RestoreFlow">
<MemberSignature Language="C#" Value="public static void RestoreFlow ();" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig void RestoreFlow() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Security.SecurityContext.RestoreFlow" /> method is called by the <see cref="M:System.Threading.AsyncFlowControl.Undo" /> method to reverse the effect of a prior <see cref="M:System.Security.SecurityContext.SuppressFlow" /> method call.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Restores the flow of the security context across asynchronous threads.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Run">
<MemberSignature Language="C#" Value="public static void Run (System.Security.SecurityContext securityContext, System.Threading.ContextCallback callback, object state);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig void Run(class System.Security.SecurityContext securityContext, class System.Threading.ContextCallback callback, object state) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="securityContext" Type="System.Security.SecurityContext" />
<Parameter Name="callback" Type="System.Threading.ContextCallback" />
<Parameter Name="state" Type="System.Object" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The security context for the current thread is returned to its previous state when the method call is complete.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Runs the specified method in the specified security context on the current thread.</para>
</summary>
<param name="securityContext">
<attribution license="cc4" from="Microsoft" modified="false" />The security context to set.</param>
<param name="callback">
<attribution license="cc4" from="Microsoft" modified="false" />The delegate that represents the method to run in the specified security context.</param>
<param name="state">
<attribution license="cc4" from="Microsoft" modified="false" />The object to pass to the callback method.</param>
</Docs>
</Member>
<Member MemberName="SuppressFlow">
<MemberSignature Language="C#" Value="public static System.Threading.AsyncFlowControl SuppressFlow ();" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig valuetype System.Threading.AsyncFlowControl SuppressFlow() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Threading.AsyncFlowControl</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use this method to suppress the flow of <see cref="T:System.Security.SecurityContext" /> information on the current thread for asynchronous operations. </para>
<para>The common language runtime (CLR) is only aware of the impersonation operations performed using managed code. The CLR has no knowledge of impersonation performed outside of managed code, such as platform invokes to unmanaged code that does the impersonation, or through calls to Win32 functions. To flow identity across asynchronous points you must use the managed <see cref="T:System.Security.Principal.WindowsIdentity" /> and <see cref="T:System.Security.Principal.WindowsImpersonationContext" /> methods. </para>
<para>Use the <see cref="M:System.Threading.AsyncFlowControl.Undo" /> method on the returned <see cref="T:System.Threading.AsyncFlowControl" /> structure to return the <see cref="T:System.Security.SecurityContext" /> object to its previous state.</para>
<para>This method is protected with a <see cref="F:System.Security.Permissions.SecurityAction.LinkDemand" /> for <see cref="F:System.Security.Permissions.SecurityPermissionFlag.Infrastructure" /> permission. A fully trusted component can call this method to suppress the flow of the <see cref="T:System.Security.SecurityContext" /> information during asynchronous calls. When the flow is suppressed, the <see cref="M:System.Security.SecurityContext.Capture" /> method returns null. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Suppresses the flow of the security context across asynchronous threads.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An <see cref="T:System.Threading.AsyncFlowControl" /> structure for restoring the flow.</para>
</returns>
</Docs>
</Member>
<Member MemberName="SuppressFlowWindowsIdentity">
<MemberSignature Language="C#" Value="public static System.Threading.AsyncFlowControl SuppressFlowWindowsIdentity ();" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig valuetype System.Threading.AsyncFlowControl SuppressFlowWindowsIdentity() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Threading.AsyncFlowControl</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use this method to suppress the flow of the Windows identity when the <see cref="T:System.Security.SecurityContext" /> migrates across asynchronous threads.</para>
<para>Use the <see cref="M:System.Threading.AsyncFlowControl.Undo" /> method on the returned <see cref="T:System.Threading.AsyncFlowControl" /> structure to return the <see cref="T:System.Security.SecurityContext" /> object to its previous state.</para>
<block subset="none" type="note">
<para>The common language runtime (CLR) is aware of impersonation operations performed using only managed code, not of impersonation performed outside of managed code, such as through platform invoke to unmanaged code or through direct calls to Win32 functions. Only managed <see cref="T:System.Security.Principal.WindowsIdentity" /> objects can flow across asynchronous points, unless the alwaysFlowImpersonationPolicy element has been set to true (&lt;alwaysFlowImpersonationPolicy enabled="true"/&gt;). Setting the alwaysFlowImpersonationPolicy element to true specifies that the Windows identity always flows across asynchronous points, regardless of how impersonation was performed. For more information about flowing unmanaged impersonation across asynchronous points, see <format type="text/html"><a href="ee622801-9e46-470b-85ab-88c4b1dd2ee1">&lt;alwaysFlowImpersonationPolicy&gt; Element</a></format>.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Suppresses the flow of the Windows identity portion of the current security context across asynchronous threads.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A structure for restoring the flow.</para>
</returns>
</Docs>
</Member>
</Members>
</Type>

58
mcs/class/corlib/Documentation/en/System.Security/SecurityContextSource.xml Normal file
View File

@@ -0,0 +1,58 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="SecurityContextSource" FullName="System.Security.SecurityContextSource">
<TypeSignature Language="C#" Value="public enum SecurityContextSource" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed SecurityContextSource extends System.Enum" />
<AssemblyInfo>
<AssemblyName>mscorlib</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Enum</BaseTypeName>
</Base>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Security.SecurityContextSource" /> enumeration is used to supply parameters for some assembly load methods.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Identifies the source for the security context.</para>
</summary>
</Docs>
<Members>
<Member MemberName="CurrentAppDomain">
<MemberSignature Language="C#" Value="CurrentAppDomain" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Security.SecurityContextSource CurrentAppDomain = int32(0)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.SecurityContextSource</ReturnType>
</ReturnValue>
<Docs>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The current application domain is the source for the security context.</para>
</summary>
</Docs>
</Member>
<Member MemberName="CurrentAssembly">
<MemberSignature Language="C#" Value="CurrentAssembly" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Security.SecurityContextSource CurrentAssembly = int32(1)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.SecurityContextSource</ReturnType>
</ReturnValue>
<Docs>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The current assembly is the source for the security context.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

105
mcs/class/corlib/Documentation/en/System.Security/SecurityCriticalAttribute.xml Normal file
View File

@@ -0,0 +1,105 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="SecurityCriticalAttribute" FullName="System.Security.SecurityCriticalAttribute">
<TypeSignature Language="C#" Value="public sealed class SecurityCriticalAttribute : Attribute" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit SecurityCriticalAttribute extends System.Attribute" />
<AssemblyInfo>
<AssemblyName>mscorlib</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Attribute</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Struct | System.AttributeTargets.Enum | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Field | System.AttributeTargets.Interface | System.AttributeTargets.Delegate | System.AttributeTargets.All, AllowMultiple=false, Inherited=false)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Security-critical operations are actions that affect code access security, such as elevation of privilege through suppression of code access security checks by using the <see cref="M:System.Security.CodeAccessPermission.Assert" /> method, calling unsafe managed code, and so forth. Either the <see cref="T:System.Security.SecurityCriticalAttribute" /> attribute or the <see cref="T:System.Security.SecuritySafeCriticalAttribute" /> attribute must be applied to code for the code to perform security-critical operations. </para>
<block subset="none" type="note">
<para>The <see cref="T:System.Security.SecurityCriticalAttribute" /> is equivalent to a link demand for full trust. A type or member marked with the <see cref="T:System.Security.SecurityCriticalAttribute" /> can be called only by fully trusted code; it does not have to demand specific permissions. It cannot be called by partially trusted code.</para>
</block>
<para>Applying the <see cref="T:System.Security.SecurityCriticalAttribute" /> at the assembly level identifies the assembly as a security-critical assembly. The entire assembly can be identified as critical by setting the scope parameter <see cref="F:System.Security.SecurityCriticalScope.Everything" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies that code or an assembly performs security-critical operations.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SecurityCriticalAttribute ();" />
<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.Security.SecurityCriticalAttribute" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SecurityCriticalAttribute (System.Security.SecurityCriticalScope scope);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(valuetype System.Security.SecurityCriticalScope scope) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="scope" Type="System.Security.SecurityCriticalScope" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This constructor is provided for compatibility with the .NET Framework version 2.0 transparency model. It does not apply to the net_v40_long. For more information, see <format type="text/html"><a href="4d05610a-0da6-4f08-acea-d54c9d6143c0">Security-Transparent Code, Level 2</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Security.SecurityCriticalAttribute" /> class with the specified scope. </para>
</summary>
<param name="scope">
<attribution license="cc4" from="Microsoft" modified="false" />One of the enumeration values that specifies the scope of the attribute. </param>
</Docs>
</Member>
<Member MemberName="Scope">
<MemberSignature Language="C#" Value="public System.Security.SecurityCriticalScope Scope { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype System.Security.SecurityCriticalScope Scope" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.Obsolete</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Security.SecurityCriticalScope</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the scope for the attribute.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

69
mcs/class/corlib/Documentation/en/System.Security/SecurityCriticalScope.xml Normal file
View File

@@ -0,0 +1,69 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="SecurityCriticalScope" FullName="System.Security.SecurityCriticalScope">
<TypeSignature Language="C#" Value="public enum SecurityCriticalScope" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed SecurityCriticalScope extends System.Enum" />
<AssemblyInfo>
<AssemblyName>mscorlib</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Enum</BaseTypeName>
</Base>
<Attributes>
<Attribute>
<AttributeName>System.Obsolete</AttributeName>
</Attribute>
</Attributes>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Security-critical code is any code that protects sensitive resources and exposes brokered access to the resource to untrusted or partially trusted code by performing the necessary elevation of privilege operations.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies the scope of a <see cref="T:System.Security.SecurityCriticalAttribute" />.</para>
</summary>
</Docs>
<Members>
<Member MemberName="Everything">
<MemberSignature Language="C#" Value="Everything" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Security.SecurityCriticalScope Everything = int32(1)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.SecurityCriticalScope</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The attribute applies to all code that follows it.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Explicit">
<MemberSignature Language="C#" Value="Explicit" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Security.SecurityCriticalScope Explicit = int32(0)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.SecurityCriticalScope</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The attribute applies only to the immediate target.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

715
mcs/class/corlib/Documentation/en/System.Security/SecurityElement.xml Normal file
View File

File diff suppressed because it is too large Load Diff

1224
mcs/class/corlib/Documentation/en/System.Security/SecurityException.xml Normal file
View File

File diff suppressed because it is too large Load Diff

Some files were not shown because too many files have changed in this diff Show More