diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index ae7ab0accee2a..774861bd193a8 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -1,5 +1,10 @@ { "redirections": [ + { + "source_path": "docs/core/install/localized-intellisense.md", + "redirect_url": "/previous-versions/dotnet/core/install/localized-intellisense", + "redirect_document_id": false + }, { "source_path": "docs/spark/what-is-apache-spark-dotnet.md", "redirect_url": "/previous-versions/dotnet/spark/what-is-apache-spark-dotnet", diff --git a/docs/core/install/localized-intellisense.md b/docs/core/install/localized-intellisense.md deleted file mode 100644 index e706488b45a8b..0000000000000 --- a/docs/core/install/localized-intellisense.md +++ /dev/null @@ -1,126 +0,0 @@ ---- -title: Install localized IntelliSense files -description: Learn how to set up your development machine to use localized IntelliSense files for .NET projects (including .NET Core) in Visual Studio. -ms.date: 11/11/2024 ---- -# How to install localized IntelliSense files for .NET - -[IntelliSense](/visualstudio/ide/using-intellisense) is a code-completion aid that's available in different integrated development environments (IDEs), such as Visual Studio. By default, when you're developing .NET projects, the SDK only includes the English version of the IntelliSense files. This article explains: - -- How to install the localized version of those files. -- How to modify the Visual Studio installation to use a different language. - -> [!NOTE] -> Localized IntelliSense files are no longer available. The latest version they're available for is .NET 5. We recommend using the English IntelliSense files. - -## Prerequisites - -- [.NET SDK](https://dotnet.microsoft.com/download/dotnet/). -- [Visual Studio 2019 version 16.3](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=learn.microsoft.com&utm_campaign=inline+link&utm_content=download+vs2019) or a later version. - -## Download and install the localized IntelliSense files - -> [!IMPORTANT] -> This procedure requires that you have administrator permission to copy the IntelliSense files to the .NET installation folder. - -1. Go to the [Download IntelliSense files](https://dotnet.microsoft.com/download/intellisense) page. - -1. Download the IntelliSense file for the language and version you'd like to use. - -1. Extract the contents of the zip file. - -1. Navigate to the .NET Intellisense folder. - - 1. Navigate to the .NET installation folder. By default, it's under *%ProgramFiles%\dotnet\packs*. - 1. Choose which SDK you want to install the IntelliSense for, and navigate to the associated path. You have the following options: - - | SDK type | Path | - |-----------------------|------------------------------------| - | .NET | *Microsoft.NETCore.App.Ref* | - | Windows Desktop | *Microsoft.WindowsDesktop.App.Ref* | - | .NET Standard | *NETStandard.Library.Ref* | - - 1. Navigate to the version you want to install the localized IntelliSense for. For example, *5.0.0*. - 1. Open the *ref* folder. - 1. Open the moniker folder. For example, *net5.0*. - - So, the full path that you'd navigate to would look similar to *C:\Program Files\dotnet\packs\Microsoft.NETCore.App.Ref\5.0.0\ref\net5.0*. - -1. Create a subfolder inside the moniker folder you just opened. The name of the folder indicates which language you want to use. The following table specifies the different options: - - | Language | Folder name | - | --------------------- | ----------- | - | Brazilian Portuguese | *pt-br* | - | Chinese (simplified) | *zh-hans* | - | Chinese (traditional) | *zh-hant* | - | French | *fr* | - | German | *de* | - | Italian | *it* | - | Japanese | *ja* | - | Korean | *ko* | - | Russian | *ru* | - | Spanish | *es* | - -1. Copy the *.xml* files you extracted in step 3 to this new folder. The *.xml* files are broken down by SDK folders, so copy them to the matching SDK you chose in step 4. - -## Modify Visual Studio language - -For Visual Studio to use a different language for IntelliSense, install the appropriate language pack. This can be done [during installation](/visualstudio/install/install-visual-studio#step-6---install-language-packs-optional) or at a later time by modifying the Visual Studio installation. If you already have Visual Studio configured to the language of your choice, your IntelliSense installation is ready. - -### Install the language pack - -If you didn't install the desired language pack during setup, update Visual Studio as follows to install the language pack: - -> [!IMPORTANT] -> To install, update, or modify Visual Studio, you must log on with an account that has administrator permission. For more information, see [User permissions and Visual Studio](/visualstudio/ide/user-permissions-and-visual-studio). - -1. Find the Visual Studio Installer on your computer. - - For example, on a computer running Windows 10, select **Start**, and then scroll to the letter **V**, where it's listed as **Visual Studio Installer**. - - ![Open the Visual Studio Installer from Windows](./media/localized-intellisense/vs-installer-windows-start.png) - - > [!NOTE] - > You can also find the Visual Studio Installer in the following location: - > - > `C:\Program Files (x86)\Microsoft Visual Studio\Installer\vs_installer.exe` - - You might have to update the installer before continuing. If so, follow the prompts. - -1. In the installer, look for the edition of Visual Studio that you want to add the language pack to, and then choose **Modify**. - - ![Update or modify Visual Studio](./media/localized-intellisense/vs-installer-modify.png) - - > [!IMPORTANT] - > If you don't see a **Modify** button but you see an **Update** one instead, you need to update your Visual Studio before you can modify your installation. - > After the update is finished, the **Modify** button should appear. - -1. In the **Language packs** tab, select or deselect the languages you want to install or uninstall. - - ![Visual Studio language packs tab](./media/localized-intellisense/vs-modify-language-packs.png) - -1. Choose **Modify**. The update starts. - -### Modify language settings in Visual Studio - -Once you've installed the desired language packs, modify your Visual Studio settings to use a different language: - -1. Open Visual Studio. - -1. On the start window, choose **Continue without code**. - -1. On the menu bar, select **Tools** > **Options**. The Options dialog opens. - -1. Under the **Environment** node, choose **International Settings**. - -1. On the **Language** drop-down, select the desired language. Choose **OK**. - -1. A dialog informs you that you have to restart Visual Studio for the changes to take effect. Choose **OK**. - -1. Restart Visual Studio. - -After this, your IntelliSense should work as expected when you open a .NET project that targets the version of the IntelliSense files you just installed. - -## See also - -- [IntelliSense in Visual Studio](/visualstudio/ide/using-intellisense) diff --git a/docs/core/install/media/localized-intellisense/vs-installer-modify.png b/docs/core/install/media/localized-intellisense/vs-installer-modify.png deleted file mode 100644 index ee7bee527e25d..0000000000000 Binary files a/docs/core/install/media/localized-intellisense/vs-installer-modify.png and /dev/null differ diff --git a/docs/core/install/media/localized-intellisense/vs-installer-windows-start.png b/docs/core/install/media/localized-intellisense/vs-installer-windows-start.png deleted file mode 100644 index a94cdb88cccec..0000000000000 Binary files a/docs/core/install/media/localized-intellisense/vs-installer-windows-start.png and /dev/null differ diff --git a/docs/core/install/media/localized-intellisense/vs-modify-language-packs.png b/docs/core/install/media/localized-intellisense/vs-modify-language-packs.png deleted file mode 100644 index 454ce24fd0215..0000000000000 Binary files a/docs/core/install/media/localized-intellisense/vs-modify-language-packs.png and /dev/null differ diff --git a/docs/fundamentals/toc.yml b/docs/fundamentals/toc.yml index a60ca93629a6e..5fd27bcf17177 100644 --- a/docs/fundamentals/toc.yml +++ b/docs/fundamentals/toc.yml @@ -73,8 +73,6 @@ items: href: ../core/install/linux-package-mixup.md - name: How to check .NET versions href: ../core/install/how-to-detect-installed-versions.md - - name: Install localized IntelliSense - href: ../core/install/localized-intellisense.md - name: Overview items: - name: Introduction to .NET