Jo Shields a575963da9 Imported Upstream version 3.6.0
Former-commit-id: da6be194a6b1221998fc28233f2503bd61dd9d14
2014-08-13 10:39:27 +01:00

102 lines
7.3 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<Type Name="DnsPermissionAttribute" FullName="System.Net.DnsPermissionAttribute" FullNameSP="System_Net_DnsPermissionAttribute" Maintainer="ecma">
<TypeSignature Language="ILASM" Value=".class public sealed serializable DnsPermissionAttribute extends System.Security.Permissions.CodeAccessSecurityAttribute" />
<TypeSignature Language="C#" Value="public sealed class DnsPermissionAttribute : System.Security.Permissions.CodeAccessSecurityAttribute" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi serializable sealed beforefieldinit DnsPermissionAttribute extends System.Security.Permissions.CodeAccessSecurityAttribute" />
<MemberOfLibrary>Networking</MemberOfLibrary>
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00 ]</AssemblyPublicKey>
<AssemblyVersion>1.0.x.x</AssemblyVersion>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadingSafetyStatement>All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe.</ThreadingSafetyStatement>
<Base>
<BaseTypeName>System.Security.Permissions.CodeAccessSecurityAttribute</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Struct | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.All, AllowMultiple=true, Inherited=false)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The security information declared by <see cref="T:System.Net.DnsPermissionAttribute" /> is stored in the metadata of the attribute target, which is the class to which the <see cref="T:System.Net.DnsPermissionAttribute" /> is applied. The system then accesses this information at run time. The <see cref="T:System.Security.Permissions.SecurityAction" /> that is passed to the constructor determines the allowable DNS targets.</para>
<para>These security attributes are used only for <format type="text/html"><a href="97E21EFD-6E89-4115-90D5-AD239513DAD8">[&lt;topic://cpcondeclarativesecurity&gt;]</a></format>. For <format type="text/html"><a href="15AAB1E1-6B7D-41AD-B102-C1ED7BEDEA27">[&lt;topic://cpconimperativesecurity&gt;]</a></format>, use the corresponding <see cref="T:System.Net.DnsPermission" /> class.</para>
<para>Security access is either fully restricted or fully unrestricted. Set the <see cref="F:System.Security.Permissions.PermissionState.Unrestricted" /> property to true to grant access, or false for no access. Set this property as a named parameter.</para>
<para>For more information about using attributes, see <format type="text/html"><a href="30386922-1E00-4602-9EBF-526B271A8B87">[&lt;topic://cpconExtendingMetadataUsingAttributes&gt;]</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies permission to request information from Domain Name Servers.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(valuetype System.Security.Permissions.SecurityAction action)" />
<MemberSignature Language="C#" Value="public DnsPermissionAttribute (System.Security.Permissions.SecurityAction action);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(valuetype System.Security.Permissions.SecurityAction action) 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="action" Type="System.Security.Permissions.SecurityAction" />
</Parameters>
<Docs>
<exception cref="T:System.ArgumentException">
<paramref name="action" /> is not a valid <see cref="T:System.Security.Permissions.SecurityAction" /> value. </exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Security.Permissions.SecurityAction" /> value that is passed to this constructor specifies the allowable <see cref="T:System.Net.DnsPermissionAttribute" /> targets.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Net.DnsPermissionAttribute" /> class with the specified <see cref="T:System.Security.Permissions.SecurityAction" /> value.</para>
</summary>
<param name="action">
<attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Security.Permissions.SecurityAction" /> values. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="CreatePermission">
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual class System.Security.IPermission CreatePermission()" />
<MemberSignature Language="C#" Value="public override System.Security.IPermission CreatePermission ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance class System.Security.IPermission CreatePermission() 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>The CreatePermission method is called by the security system, not by application code.</para>
<para>The security information described by <see cref="T:System.Net.DnsPermissionAttribute" /> is stored in the metadata of the attribute target, which is the class to which <see cref="T:System.Net.DnsPermissionAttribute" /> is applied. The system then accesses the information at run time and calls <see cref="M:System.Net.DnsPermissionAttribute.CreatePermission" />. The system uses the returned <see cref="T:System.Security.IPermission" /> to enforce the specified security requirements.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates and returns a new instance of the <see cref="T:System.Net.DnsPermission" /> class.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Net.DnsPermission" /> that corresponds to the security declaration.</para>
</returns>
</Docs>
<Excluded>0</Excluded>
</Member>
</Members>
<TypeExcluded>0</TypeExcluded>
</Type>