Skip to content

Update SecurityTransparentAttribute.xml #3312

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Oct 10, 2019
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
3 changes: 3 additions & 0 deletions xml/System.Security.Permissions/FileIOPermissionAttribute.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
3 changes: 3 additions & 0 deletions xml/System.Security.Permissions/HostProtectionAttribute.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
3 changes: 3 additions & 0 deletions xml/System.Security.Permissions/MediaPermissionAttribute.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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>.
Expand Down
3 changes: 3 additions & 0 deletions xml/System.Security.Permissions/PermissionSetAttribute.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
10 changes: 9 additions & 1 deletion xml/System.Security.Permissions/SecurityAttribute.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
3 changes: 3 additions & 0 deletions xml/System.Security.Permissions/StorePermissionAttribute.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down
3 changes: 3 additions & 0 deletions xml/System.Security.Permissions/UIPermissionAttribute.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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>.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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]
Expand Down
2 changes: 2 additions & 0 deletions xml/System.Security/AllowPartiallyTrustedCallersAttribute.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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).
Expand Down
3 changes: 3 additions & 0 deletions xml/System.Security/SecurityCriticalAttribute.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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]
Expand Down
3 changes: 3 additions & 0 deletions xml/System.Security/SecurityRulesAttribute.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down
Loading