From f3ba8173372163622afb085a468f9c68aa012217 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Fri, 28 Nov 2025 09:59:42 -0800 Subject: [PATCH] prevent tags from loc --- ...sembly-binding-redirection-security-permission.md | 12 ++++++------ ...able-and-disable-automatic-binding-redirection.md | 4 ++-- .../how-to-locate-assemblies-by-using-devpath.md | 2 +- docs/framework/configure-apps/index.md | 2 +- .../map-algorithm-names-to-cryptography-classes.md | 12 ++++++------ ...-object-identifiers-to-cryptography-algorithms.md | 2 +- .../configure-apps/redirect-assembly-versions.md | 2 +- .../configure-apps/specify-assembly-location.md | 10 +++++----- 8 files changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/framework/configure-apps/assembly-binding-redirection-security-permission.md b/docs/framework/configure-apps/assembly-binding-redirection-security-permission.md index cd7c6a32a60eb..1200671aa5835 100644 --- a/docs/framework/configure-apps/assembly-binding-redirection-security-permission.md +++ b/docs/framework/configure-apps/assembly-binding-redirection-security-permission.md @@ -17,16 +17,16 @@ Explicit assembly binding redirection in an application configuration file requi The permission is not required if assembly redirection is performed in a publisher policy file that is controlled by the component publisher, or in the machine configuration file that is controlled by the administrator. However, the permission is required for an application to explicitly ignore publisher policy using the [\](./file-schema/runtime/publisherpolicy-element.md) element in the application configuration file. - The following table shows the default security settings for the **BindingRedirects** flag. + The following table shows the default security settings for the `BindingRedirects` flag. | Zone | BindingRedirects flag setting | |------------------------------|-------------------------------| -| Trusted Zone (local machine) | **ON** | -| Intranet Zone | **ON** | -| Internet Zone | **OFF** | -| Untrusted zones | **OFF** | +| Trusted Zone (local machine) | `ON` | +| Intranet Zone | `ON` | +| Internet Zone | `OFF` | +| Untrusted zones | `OFF` | - An administrator can change these security settings to support or restrict specific scenarios on a given computer. There are no tools for changing the **BindingRedirects** flag setting from the default; an administrator must manually edit the Security.config file on a user's computer. + An administrator can change these security settings to support or restrict specific scenarios on a given computer. There are no tools for changing the `BindingRedirects` flag setting from the default; an administrator must manually edit the Security.config file on a user's computer. ## See also diff --git a/docs/framework/configure-apps/how-to-enable-and-disable-automatic-binding-redirection.md b/docs/framework/configure-apps/how-to-enable-and-disable-automatic-binding-redirection.md index f252b9521adbc..e2b0540d6073c 100644 --- a/docs/framework/configure-apps/how-to-enable-and-disable-automatic-binding-redirection.md +++ b/docs/framework/configure-apps/how-to-enable-and-disable-automatic-binding-redirection.md @@ -63,7 +63,7 @@ You can enable automatic binding redirects in existing apps that target older ve - In Visual Studio, select the project in **Solution Explorer**, and then choose **Open Folder in File Explorer** from the shortcut menu. In File Explorer, find the project (.csproj or .vbproj) file and open it in Notepad. - In Visual Studio, in **Solution Explorer**, right-click the project and choose **Unload Project**. Right-click the unloaded project again, and then choose **Edit [projectname.csproj]**. -2. Add the following element to the first configuration property group (under the \ tag): +2. Add the following element to the first configuration property group (under the `` tag): ```xml true @@ -106,5 +106,5 @@ To add binding redirects to a **web.config** file: ## See also -- [\ Element](./file-schema/runtime/bindingredirect-element.md) +- [`` Element](./file-schema/runtime/bindingredirect-element.md) - [Redirecting Assembly Versions](redirect-assembly-versions.md) diff --git a/docs/framework/configure-apps/how-to-locate-assemblies-by-using-devpath.md b/docs/framework/configure-apps/how-to-locate-assemblies-by-using-devpath.md index 9a3082d24499c..b9a2cb3df26de 100644 --- a/docs/framework/configure-apps/how-to-locate-assemblies-by-using-devpath.md +++ b/docs/framework/configure-apps/how-to-locate-assemblies-by-using-devpath.md @@ -19,7 +19,7 @@ Developers might want to make sure that a shared assembly they are building work For example, assume that you are building a shared assembly called MySharedAssembly and the output directory is C:\MySharedAssembly\Debug. You can put C:\MySharedAssembly\Debug in the DEVPATH variable. You must then specify the [\](./file-schema/runtime/developmentmode-element.md) element in the machine configuration file. This element tells the common language runtime to use DEVPATH to locate assemblies. - The shared assembly must be discoverable by the runtime. To specify a private directory for resolving assembly references use the [\ Element](./file-schema/runtime/codebase-element.md) or [\ Element](./file-schema/runtime/probing-element.md) in a configuration file, as described in [Specifying an Assembly's Location](specify-assembly-location.md). You can also put the assembly in a subdirectory of the application directory. For more information, see [How the Runtime Locates Assemblies](../deployment/how-the-runtime-locates-assemblies.md). + The shared assembly must be discoverable by the runtime. To specify a private directory for resolving assembly references use the [`` Element](./file-schema/runtime/codebase-element.md) or [`` Element](./file-schema/runtime/probing-element.md) in a configuration file, as described in [Specifying an Assembly's Location](specify-assembly-location.md). You can also put the assembly in a subdirectory of the application directory. For more information, see [How the Runtime Locates Assemblies](../deployment/how-the-runtime-locates-assemblies.md). > [!NOTE] > This is an advanced feature, intended only for development. diff --git a/docs/framework/configure-apps/index.md b/docs/framework/configure-apps/index.md index 635d54ed5cb6a..ac5103e45c585 100644 --- a/docs/framework/configure-apps/index.md +++ b/docs/framework/configure-apps/index.md @@ -54,7 +54,7 @@ This article describes the syntax of configuration files and provides informatio The machine configuration file, *Machine.config*, contains settings that apply to an entire computer. This file is located in the %*runtime install path*%\Config directory. *Machine.config* contains configuration settings for machine-wide assembly binding, built-in [remoting channels](/previous-versions/dotnet/netframework-4.0/dkfd3wha(v=vs.100)), and ASP.NET. - The configuration system first looks in the machine configuration file for the [**\** element](./file-schema/appsettings/index.md) and other configuration sections that a developer might define. It then looks in the application configuration file. To keep the machine configuration file manageable, it is best to put these settings in the application configuration file. However, putting the settings in the machine configuration file can make your system more maintainable. For example, if you have a third-party component that both your client and server application uses, it is easier to put the settings for that component in one place. In this case, the machine configuration file is the appropriate place for the settings, so you don't have the same settings in two different files. + The configuration system first looks in the machine configuration file for the [`` element](./file-schema/appsettings/index.md) and other configuration sections that a developer might define. It then looks in the application configuration file. To keep the machine configuration file manageable, it is best to put these settings in the application configuration file. However, putting the settings in the machine configuration file can make your system more maintainable. For example, if you have a third-party component that both your client and server application uses, it is easier to put the settings for that component in one place. In this case, the machine configuration file is the appropriate place for the settings, so you don't have the same settings in two different files. > [!NOTE] > Deploying an application using XCOPY will not copy the settings in the machine configuration file. diff --git a/docs/framework/configure-apps/map-algorithm-names-to-cryptography-classes.md b/docs/framework/configure-apps/map-algorithm-names-to-cryptography-classes.md index 94b32957cd3d3..4803214e65165 100644 --- a/docs/framework/configure-apps/map-algorithm-names-to-cryptography-classes.md +++ b/docs/framework/configure-apps/map-algorithm-names-to-cryptography-classes.md @@ -15,15 +15,15 @@ ms.assetid: 01327c69-c5e1-4ef6-b73f-0a58351f0492 There are four ways a developer can create a cryptography object using the Windows SDK: -- Create an object by using the **new** operator. +- Create an object by using the `new` operator. -- Create an object that implements a particular cryptography algorithm by calling the **Create** method on the abstract class for that algorithm. +- Create an object that implements a particular cryptography algorithm by calling the `Create` method on the abstract class for that algorithm. - Create an object that implements a particular cryptography algorithm by calling the method. -- Create an object that implements a class of cryptographic algorithms (such as a symmetric block cipher) by calling the **Create** method on the abstract class for that type of algorithm (such as ). +- Create an object that implements a class of cryptographic algorithms (such as a symmetric block cipher) by calling the `Create` method on the abstract class for that type of algorithm (such as ). - For example, suppose a developer wants to compute the SHA1 hash of a set of bytes. The namespace contains two implementations of the SHA1 algorithm, one purely managed implementation and one that wraps CryptoAPI. The developer can choose to instantiate a particular SHA1 implementation (such as the ) by calling the **new** operator. However, if it does not matter which class the common language runtime loads as long as the class implements the SHA1 hash algorithm, the developer can create an object by calling the method. This method calls **System.Security.Cryptography.CryptoConfig.CreateFromName("System.Security.Cryptography.SHA1")**, which must return an implementation of the SHA1 hash algorithm. + For example, suppose a developer wants to compute the SHA1 hash of a set of bytes. The namespace contains two implementations of the SHA1 algorithm, one purely managed implementation and one that wraps CryptoAPI. The developer can choose to instantiate a particular SHA1 implementation (such as the ) by calling the `new` operator. However, if it does not matter which class the common language runtime loads as long as the class implements the SHA1 hash algorithm, the developer can create an object by calling the method. This method calls **System.Security.Cryptography.CryptoConfig.CreateFromName("System.Security.Cryptography.SHA1")**, which must return an implementation of the SHA1 hash algorithm. The developer can also call **System.Security.Cryptography.CryptoConfig.CreateFromName("SHA1")** because, by default, cryptography configuration includes short names for the algorithms shipped in the .NET Framework. @@ -57,9 +57,9 @@ There are four ways a developer can create a cryptography object using the Windo ``` - You can specify the name of the attribute in the [ element](./file-schema/cryptography/cryptoclass-element.md) (the previous example names the attribute `MySHA1Hash`). The value of the attribute in the **\** element is a string that the common language runtime uses to find the class. You can use any string that meets the requirements specified in [Specifying Fully Qualified Type Names](../../fundamentals/reflection/specifying-fully-qualified-type-names.md). + You can specify the name of the attribute in the [`` element](./file-schema/cryptography/cryptoclass-element.md) (the previous example names the attribute `MySHA1Hash`). The value of the attribute in the `` element is a string that the common language runtime uses to find the class. You can use any string that meets the requirements specified in [Specifying Fully Qualified Type Names](../../fundamentals/reflection/specifying-fully-qualified-type-names.md). - Many algorithm names can map to the same class. The [\ element](./file-schema/cryptography/nameentry-element.md) maps a class to one friendly algorithm name. The **name** attribute can be either a string that is used when calling the **System.Security.Cryptography.CryptoConfig.CreateFromName** method or the name of an abstract cryptography class in the namespace. The value of the **class** attribute is the name of the attribute in the **\** element. + Many algorithm names can map to the same class. The [`` element](./file-schema/cryptography/nameentry-element.md) maps a class to one friendly algorithm name. The `name` attribute can be either a string that is used when calling the **System.Security.Cryptography.CryptoConfig.CreateFromName** method or the name of an abstract cryptography class in the namespace. The value of the `class` attribute is the name of the attribute in the `` element. > [!NOTE] > You can get an SHA1 algorithm by calling the or the **Security.CryptoConfig.CreateFromName("SHA1")** method. Each method guarantees only that it returns an object that implements the SHA1 algorithm. You do not have to map each friendly name of an algorithm to the same class in the configuration file. diff --git a/docs/framework/configure-apps/map-object-identifiers-to-cryptography-algorithms.md b/docs/framework/configure-apps/map-object-identifiers-to-cryptography-algorithms.md index 7add7a241b84c..abe86d2cfe20e 100644 --- a/docs/framework/configure-apps/map-object-identifiers-to-cryptography-algorithms.md +++ b/docs/framework/configure-apps/map-object-identifiers-to-cryptography-algorithms.md @@ -36,7 +36,7 @@ Digital signatures ensure that data is not tampered with when it is sent from on ``` - The [\ element](./file-schema/cryptography/oidentry-element.md) contains two attributes. The **OID** attribute is the object identifier number. The **name** attribute is the value of the **name** attribute from the [\ element](./file-schema/cryptography/nameentry-element.md). There must be a mapping from an algorithm name to a class before an object identifier can be mapped to a simple name. + The [`` element](./file-schema/cryptography/oidentry-element.md) contains two attributes. The `OID` attribute is the object identifier number. The `name` attribute is the value of the `name` attribute from the [`` element](./file-schema/cryptography/nameentry-element.md). There must be a mapping from an algorithm name to a class before an object identifier can be mapped to a simple name. ## See also diff --git a/docs/framework/configure-apps/redirect-assembly-versions.md b/docs/framework/configure-apps/redirect-assembly-versions.md index d9c39ab5fa34e..07db79c23f721 100644 --- a/docs/framework/configure-apps/redirect-assembly-versions.md +++ b/docs/framework/configure-apps/redirect-assembly-versions.md @@ -176,7 +176,7 @@ For example, to redirect one reference to a .NET Framework 3.5 assembly and anot ## See also - [How to: Enable and Disable Automatic Binding Redirection](how-to-enable-and-disable-automatic-binding-redirection.md) -- [\ Element](./file-schema/runtime/bindingredirect-element.md) +- [`` Element](./file-schema/runtime/bindingredirect-element.md) - [Assembly Binding Redirection Security Permission](assembly-binding-redirection-security-permission.md) - [Assemblies in .NET](../../standard/assembly/index.md) - [Programming with Assemblies](../../standard/assembly/index.md) diff --git a/docs/framework/configure-apps/specify-assembly-location.md b/docs/framework/configure-apps/specify-assembly-location.md index f773baec0e0b2..cea42a05487a5 100644 --- a/docs/framework/configure-apps/specify-assembly-location.md +++ b/docs/framework/configure-apps/specify-assembly-location.md @@ -20,9 +20,9 @@ There are two ways to specify an assembly's location: You can also use the [.NET Framework Configuration Tool (Mscorcfg.msc)](/previous-versions/dotnet/netframework-4.0/2bc0cxhc(v=vs.100)) to specify assembly locations or specify locations for the common language runtime to probe for assemblies. -## Using the \ Element +## Using the `` Element - You can use the **\** element only in machine configuration or publisher policy files that also redirect the assembly version. When the runtime determines which assembly version to use, it applies the code base setting from the file that determines the version. If no code base is indicated, the runtime probes for the assembly in the normal way. For details, see [How the Runtime Locates Assemblies](../deployment/how-the-runtime-locates-assemblies.md). + You can use the `` element only in machine configuration or publisher policy files that also redirect the assembly version. When the runtime determines which assembly version to use, it applies the code base setting from the file that determines the version. If no code base is indicated, the runtime probes for the assembly in the normal way. For details, see [How the Runtime Locates Assemblies](../deployment/how-the-runtime-locates-assemblies.md). The following example shows how to specify an assembly's location. @@ -42,12 +42,12 @@ There are two ways to specify an assembly's location: ``` - The **version** attribute is required for all strong-named assemblies but should be omitted for assemblies that are not strong-named. The **\** element requires the **href** attribute. You cannot specify version ranges in the **\** element. + The `version` attribute is required for all strong-named assemblies but should be omitted for assemblies that aren't strong-named. The `` element requires the `href` attribute. You cannot specify version ranges in the `` element. > [!NOTE] > If you are supplying a code base hint for an assembly that is not strong-named, the hint must point to the application base or a subdirectory of the application base directory. -## Using the \ Element +## Using the `` Element The runtime locates assemblies that do not have a code base by probing. For more information about probing, see [How the Runtime Locates Assemblies](../deployment/how-the-runtime-locates-assemblies.md). @@ -63,7 +63,7 @@ There are two ways to specify an assembly's location: ``` - The **privatePath** attribute contains the directories that the runtime should search for assemblies. If the application is located at C:\Program Files\MyApp, the runtime will look for assemblies that do not specify a code base in C:\Program Files\MyApp\Bin, C:\Program Files\MyApp\Bin2\Subbin, and C:\Program Files\MyApp\Bin3. The directories specified in **privatePath** must be subdirectories of the application base directory. + The `privatePath` attribute contains the directories that the runtime should search for assemblies. If the application is located at C:\Program Files\MyApp, the runtime will look for assemblies that do not specify a code base in C:\Program Files\MyApp\Bin, C:\Program Files\MyApp\Bin2\Subbin, and C:\Program Files\MyApp\Bin3. The directories specified in `privatePath` must be subdirectories of the application base directory. ## See also