Update SecurityTransparentAttribute.xml (#3312)

jkotas · Ron Petrusha · commit c455b8564bdf · 2019-10-10T17:38:10.000Z
* Update SecurityTransparentAttribute.xml

Add note that partial trust code is no longer supported.

* Update xml/System.Security/SecurityTransparentAttribute.xml

* Update xml/System.Security/SecurityTransparentAttribute.xml

Co-Authored-By: Ron Petrusha &lt;ronpet@microsoft.com&gt;

* Add the note to all CAS attributes
diff --git a/xml/System.Security.Permissions/CodeAccessSecurityAttribute.xml b/xml/System.Security.Permissions/CodeAccessSecurityAttribute.xml
@@ -49,6 +49,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  This attribute class associates a <xref:System.Security.Permissions.SecurityAction>, for example, `Demand`, with a custom security attribute.  
   
  The types that derive from <xref:System.Security.Permissions.CodeAccessSecurityAttribute> are used to help restrict access to resources or securable operations.  
diff --git a/xml/System.Security.Permissions/DataProtectionPermissionAttribute.xml b/xml/System.Security.Permissions/DataProtectionPermissionAttribute.xml
@@ -32,6 +32,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> value that is used.  
   
  The security information declared by a security attribute is stored in the metadata of the attribute target and is accessed by the system at run time. <xref:System.Security.Permissions.DataProtectionPermissionAttribute> is used only for declarative security. For imperative security, use the <xref:System.Security.Permissions.DataProtectionPermission> class.  
diff --git a/xml/System.Security.Permissions/EnvironmentPermissionAttribute.xml b/xml/System.Security.Permissions/EnvironmentPermissionAttribute.xml
@@ -39,6 +39,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> that is used.  
   
  The security information declared by a security attribute is stored in the metadata of the attribute target and is accessed by the system at run time. Security attributes are used only for declarative security. For imperative security, use the corresponding permission class.  
diff --git a/xml/System.Security.Permissions/FileDialogPermissionAttribute.xml b/xml/System.Security.Permissions/FileDialogPermissionAttribute.xml
@@ -39,6 +39,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> that is used.  
   
  The security information declared by a security attribute is stored in the metadata of the attribute target and is accessed by the system at run time. Security attributes are used only for declarative security. For imperative security, use the corresponding permission class.  
diff --git a/xml/System.Security.Permissions/FileIOPermissionAttribute.xml b/xml/System.Security.Permissions/FileIOPermissionAttribute.xml
@@ -39,6 +39,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  Files and directories are specified using absolute paths. When accessing files, a security check is performed when the file is created or opened. The security check is not done again unless the file is closed and reopened. Checking permissions when the file is first accessed minimizes the impact of the security check on application performance because opening a file happens only once, while reading and writing can happen multiple times.  
   
  The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> that is used.  
diff --git a/xml/System.Security.Permissions/GacIdentityPermissionAttribute.xml b/xml/System.Security.Permissions/GacIdentityPermissionAttribute.xml
@@ -38,6 +38,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  This class is used to ensure that callers are registered in the global assembly cache (GAC).  
   
  The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> value that is used.  
diff --git a/xml/System.Security.Permissions/HostProtectionAttribute.xml b/xml/System.Security.Permissions/HostProtectionAttribute.xml
@@ -38,6 +38,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  This attribute affects only unmanaged applications that host the common language runtime and implement host protection, such as SQL Server. If the code is run in a client application or on a server that is not host-protected, the attribute "evaporates"; it is not detected and therefore not applied. When applied, the security action results in the creation of a link demand based on the host resources the class or method exposes.  
   
 > [!IMPORTANT]
diff --git a/xml/System.Security.Permissions/IsolatedStorageFilePermissionAttribute.xml b/xml/System.Security.Permissions/IsolatedStorageFilePermissionAttribute.xml
@@ -39,6 +39,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> that is used.  
   
  The security information declared by a security attribute is stored in the metadata of the attribute target and is accessed by the system at run time. Security attributes are used only for declarative security. For imperative security, use the corresponding permission class.  
diff --git a/xml/System.Security.Permissions/IsolatedStoragePermissionAttribute.xml b/xml/System.Security.Permissions/IsolatedStoragePermissionAttribute.xml
@@ -39,6 +39,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  This class is an abstract base class. This class is never used instantiated; instead, classes that extend it and represent access to a particular type of isolated storage are used.  
   
  The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> that is used.  
diff --git a/xml/System.Security.Permissions/KeyContainerPermissionAttribute.xml b/xml/System.Security.Permissions/KeyContainerPermissionAttribute.xml
@@ -38,6 +38,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> value that is used.  
   
  The security information declared by a security attribute is stored in the metadata of the attribute target and is accessed by the system at run time. <xref:System.Security.Permissions.KeyContainerPermissionAttribute> is used only for declarative security. For imperative security, use the <xref:System.Security.Permissions.KeyContainerPermission> class.  
diff --git a/xml/System.Security.Permissions/MediaPermissionAttribute.xml b/xml/System.Security.Permissions/MediaPermissionAttribute.xml
@@ -29,6 +29,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  <xref:System.Security.Permissions.MediaPermissionAttribute> controls the ability for audio, image, and video media to work in a partial-trust Windows Presentation Foundation (WPF) application. The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> that is used.  
   
  The security information declared by a security attribute is stored in the metadata of the attribute target and is accessed by the system at run time. Security attributes are used only for declarative security. For imperative security, use the corresponding permission class, <xref:System.Security.Permissions.MediaPermission>.  
diff --git a/xml/System.Security.Permissions/PermissionSetAttribute.xml b/xml/System.Security.Permissions/PermissionSetAttribute.xml
@@ -39,6 +39,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  The <xref:System.Security.Permissions.PermissionSetAttribute> properties <xref:System.Security.Permissions.PermissionSetAttribute.Name%2A>, <xref:System.Security.Permissions.PermissionSetAttribute.File%2A>, and <xref:System.Security.Permissions.PermissionSetAttribute.XML%2A> are mutually exclusive, meaning that a permission set can have as its source only one of the following: a named permission set, a file containing an XML representation of a permission set, or a string containing an XML representation of a permission set.  
   
  The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> that is used. A <xref:System.Security.Permissions.SecurityAction> performed on a <xref:System.Security.PermissionSet> is the equivalent of performing that action on each of the permissions within the set.  
diff --git a/xml/System.Security.Permissions/PrincipalPermissionAttribute.xml b/xml/System.Security.Permissions/PrincipalPermissionAttribute.xml
@@ -39,6 +39,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  <xref:System.Security.Permissions.PrincipalPermissionAttribute> can be used to declaratively demand that users running your code belong to a specified role or have been authenticated. Use of <xref:System.Security.Permissions.PermissionState.Unrestricted> creates a <xref:System.Security.Permissions.PrincipalPermission> with <xref:System.Security.Permissions.PrincipalPermissionAttribute.Authenticated%2A> set to `true` and <xref:System.Security.Permissions.PrincipalPermissionAttribute.Name%2A> and <xref:System.Security.Permissions.PrincipalPermissionAttribute.Role%2A> set to `null`.  
   
  The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> that is used. <xref:System.Security.Permissions.PrincipalPermissionAttribute> cannot be applied at the assembly level.  
diff --git a/xml/System.Security.Permissions/PublisherIdentityPermissionAttribute.xml b/xml/System.Security.Permissions/PublisherIdentityPermissionAttribute.xml
@@ -39,6 +39,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> that is used.  
   
  The properties <xref:System.Security.Permissions.PublisherIdentityPermissionAttribute.CertFile%2A>, <xref:System.Security.Permissions.PublisherIdentityPermissionAttribute.SignedFile%2A>, and <xref:System.Security.Permissions.PublisherIdentityPermissionAttribute.X509Certificate%2A> are mutually exclusive.  
diff --git a/xml/System.Security.Permissions/ReflectionPermissionAttribute.xml b/xml/System.Security.Permissions/ReflectionPermissionAttribute.xml
@@ -39,6 +39,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> that is used.  
   
  The security information declared by a security attribute is stored in the metadata of the attribute target and is accessed by the system at run time. Security attributes are used only for declarative security. For imperative security, use the corresponding permission class.  
diff --git a/xml/System.Security.Permissions/RegistryPermissionAttribute.xml b/xml/System.Security.Permissions/RegistryPermissionAttribute.xml
@@ -39,6 +39,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> that is used.  
   
  The security information declared by a security attribute is stored in the metadata of the attribute target and is accessed by the system at run time. Security attributes are used only for declarative security. For imperative security, use the corresponding permission class.  
diff --git a/xml/System.Security.Permissions/SecurityAttribute.xml b/xml/System.Security.Permissions/SecurityAttribute.xml
@@ -45,7 +45,15 @@
   </Attributes>
   <Docs>
     <summary>Specifies the base attribute class for declarative security from which <see cref="T:System.Security.Permissions.CodeAccessSecurityAttribute" /> is derived.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
+ ]]></format>
+    </remarks>
     <block subset="none" type="overrides">
       <para>When you inherit from <see cref="T:System.Security.Permissions.SecurityAttribute" />, you must override <see cref="M:System.Security.Permissions.SecurityAttribute.CreatePermission" />.</para>
     </block>
diff --git a/xml/System.Security.Permissions/SecurityPermissionAttribute.xml b/xml/System.Security.Permissions/SecurityPermissionAttribute.xml
@@ -49,6 +49,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> that is used.  
   
  The security information declared by a security attribute is stored in the metadata of the attribute target and is accessed by the system at run time. Security attributes are used only for declarative security. For imperative security, use the corresponding permission class.  
diff --git a/xml/System.Security.Permissions/SiteIdentityPermissionAttribute.xml b/xml/System.Security.Permissions/SiteIdentityPermissionAttribute.xml
@@ -39,6 +39,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  Site identity is only defined for code from URLs with the protocols of HTTP, HTTPS, and FTP. A site is the string between the "//" after the protocol of a URL and the following "/", if present, for example, `www.fourthcoffee.com` in the URL `http://www.fourthcoffee.com/process/grind.htm`. This excludes port numbers. If a given URL is `http://www.fourthcoffee.com:8000/`, the site is `www.fourthcoffee.com`, not `www.fourthcoffee.com:8000`.  
   
  Sites can be matched exactly, or by a wildcard ("\*") prefix at the dot delimiter. For example, the site name string `*.fourthcoffee.com` matches `fourthcoffee.com` as well as `www.fourthcoffee.com`. Without a wildcard, the site name must be a precise match. The site name string \* will match any site, but will not match code that has no site evidence.  
diff --git a/xml/System.Security.Permissions/StorePermissionAttribute.xml b/xml/System.Security.Permissions/StorePermissionAttribute.xml
@@ -34,6 +34,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> value that is used.  
   
  The security information declared by a security attribute is stored in the metadata of the attribute target and is accessed by the system at run time. The <xref:System.Security.Permissions.StorePermissionAttribute> attribute is used only for declarative security. For imperative security, use the <xref:System.Security.Permissions.StorePermission> class.  
diff --git a/xml/System.Security.Permissions/StrongNameIdentityPermissionAttribute.xml b/xml/System.Security.Permissions/StrongNameIdentityPermissionAttribute.xml
@@ -39,6 +39,8 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
   
 > [!IMPORTANT]
 >  Starting with the [!INCLUDE[net_v40_long](~/includes/net-v40-long-md.md)], identity permissions are not used.  
diff --git a/xml/System.Security.Permissions/TypeDescriptorPermissionAttribute.xml b/xml/System.Security.Permissions/TypeDescriptorPermissionAttribute.xml
@@ -29,7 +29,15 @@
   </Attributes>
   <Docs>
     <summary>Determines the permission flags that apply to a <see cref="T:System.ComponentModel.TypeDescriptor" />.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[  
+  
+## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
+ ]]></format>
+    </remarks>
     <altmember cref="T:System.ComponentModel.TypeDescriptor" />
   </Docs>
   <Members>
diff --git a/xml/System.Security.Permissions/UIPermissionAttribute.xml b/xml/System.Security.Permissions/UIPermissionAttribute.xml
@@ -39,6 +39,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> that is used.  
   
  The security information declared by a security attribute is stored in the metadata of the attribute target and is accessed by the system at run time. Security attributes are used only for declarative security. For imperative security, use the corresponding permission class.  
diff --git a/xml/System.Security.Permissions/UrlIdentityPermissionAttribute.xml b/xml/System.Security.Permissions/UrlIdentityPermissionAttribute.xml
@@ -39,6 +39,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  The complete URL is considered, including the protocol (HTTP, HTTPS, FTP) and the file. For example, http://www.fourthcoffee.com/process/grind.htm is a complete URL.  
   
  The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> that is used.  
diff --git a/xml/System.Security.Permissions/WebBrowserPermissionAttribute.xml b/xml/System.Security.Permissions/WebBrowserPermissionAttribute.xml
@@ -29,6 +29,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  <xref:System.Security.Permissions.WebBrowserPermissionAttribute> controls the ability of a Web browser control to run in a Windows Presentation Foundation (WPF) application. The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> that is used.  
   
  The security information declared by a security attribute is stored in the metadata of the attribute target and is accessed by the system at run time. Security attributes are used only for declarative security. For imperative security, use the corresponding permission class, <xref:System.Security.Permissions.WebBrowserPermission>.  
diff --git a/xml/System.Security.Permissions/ZoneIdentityPermissionAttribute.xml b/xml/System.Security.Permissions/ZoneIdentityPermissionAttribute.xml
@@ -39,6 +39,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  The scope of the declaration that is allowed depends on the <xref:System.Security.Permissions.SecurityAction> that is used.  
   
 > [!IMPORTANT]
diff --git a/xml/System.Security/AllowPartiallyTrustedCallersAttribute.xml b/xml/System.Security/AllowPartiallyTrustedCallersAttribute.xml
@@ -44,6 +44,8 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
   
 > [!NOTE]
 >  The [!INCLUDE[net_v40_long](~/includes/net-v40-long-md.md)] introduces new security rules that affect the behavior of the <xref:System.Security.AllowPartiallyTrustedCallersAttribute> attribute (see [Security-Transparent Code, Level 2](~/docs/framework/misc/security-transparent-code-level-2.md)). In the [!INCLUDE[net_v40_short](~/includes/net-v40-short-md.md)], 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 [Security Changes](~/docs/framework/security/security-changes.md).  
diff --git a/xml/System.Security/SecurityCriticalAttribute.xml b/xml/System.Security/SecurityCriticalAttribute.xml
@@ -43,6 +43,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  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 <xref:System.Security.CodeAccessPermission.Assert%2A> method, calling unsafe managed code, and so forth. Either the <xref:System.Security.SecurityCriticalAttribute> attribute or the <xref:System.Security.SecuritySafeCriticalAttribute> attribute must be applied to code for the code to perform security-critical operations.  
   
 > [!NOTE]
diff --git a/xml/System.Security/SecurityRulesAttribute.xml b/xml/System.Security/SecurityRulesAttribute.xml
@@ -35,6 +35,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+> [!IMPORTANT]
+> Partially trusted code is no longer supported. This attribute has no effect in .NET Core.
+
  This class indicates which set of security rules the common language runtime should enforce for an assembly. For example, an assembly that is marked with `[SecurityRules(SecurityRuleSet.Level1)]` uses the .NET Framework version 2.0 transparency rules, where public security-critical types and members are treated as security-safe-critical outside the assembly. This requires security-critical types and members to perform a link demand for full trust to enforce security-critical behavior when they are accessed by external callers. Typically, level 1 rules should be used only for compatibility, such as for version 2.0 assemblies. For more information about level 1 behavior, see [Security-Transparent Code, Level 1](~/docs/framework/misc/security-transparent-code-level-1.md). For information about level 2 behavior, see [Security-Transparent Code, Level 2](~/docs/framework/misc/security-transparent-code-level-2.md).  
   
  ]]></format>
diff --git a/xml/System.Security/SecuritySafeCriticalAttribute.xml b/xml/System.Security/SecuritySafeCriticalAttribute.xml
diff --git a/xml/System.Security/SecurityTransparentAttribute.xml b/xml/System.Security/SecurityTransparentAttribute.xml
diff --git a/xml/System.Security/SecurityTreatAsSafeAttribute.xml b/xml/System.Security/SecurityTreatAsSafeAttribute.xml
diff --git a/xml/System.Security/SuppressUnmanagedCodeSecurityAttribute.xml b/xml/System.Security/SuppressUnmanagedCodeSecurityAttribute.xml
