Skip to content

Commit 55f90d3

Browse files
committed
Merging changes synced from https://github.com/MicrosoftDocs/visualstudio-docs-pr (branch live)
2 parents 7ae9e63 + 4cb9ac3 commit 55f90d3

File tree

3 files changed

+31
-67
lines changed

3 files changed

+31
-67
lines changed

docs/containers/troubleshooting-docker-errors.md

Lines changed: 6 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.assetid: 346f70b9-7b52-4688-a8e8-8f53869618d3
99
ms.devlang: dotnet
1010
ms.topic: troubleshooting
1111
ms.workload: multiple
12-
ms.date: 11/12/2021
12+
ms.date: 10/12/2022
1313
ms.author: ghogen
1414
---
1515
# Troubleshoot Visual Studio development with Docker
@@ -28,7 +28,7 @@ File sharing only needs to be managed if you are using Hyper-V with Docker. If y
2828
![Shared drives](media/troubleshooting-docker-errors/docker-settings-image.png)
2929

3030
> [!TIP]
31-
> Visual Studio versions later than Visual Studio 2017 version 15.6 will prompt when **Shared Drives** aren't configured.
31+
> Visual Studio prompts you when **Shared Drives** aren't configured.
3232
3333
## Unable to start debugging
3434

@@ -89,18 +89,12 @@ Click **Apply & Restart**. These steps modify the configuration file at *%Progra
8989

9090
## Container type mismatch
9191

92-
When adding Docker support to a project, you choose either a Windows or a Linux container. If the Docker Server host is not configured to run the same container type as the project target, you will likely see an error similar to the one below:
92+
When adding Docker support to a project, you choose either a Windows or a Linux container. If the Docker Server host is not configured to run the same container type as the project target, you see an error similar to:
9393

9494
![Screenshot of Docker Host and Project Mismatch](media/troubleshooting-docker-errors/docker-host-config-change-linux-to-windows.png)
9595

96-
To resolve this issue:
96+
To resolve this issue, right-click the Docker for Windows icon in the System Tray and choose **Switch to Windows containers...** or **Switch to Linux containers...**.
9797

98-
- Right-click the Docker for Windows icon in the System Tray and choose **Switch to Windows containers...** or **Switch to Linux containers...**.
98+
## Other issues
9999

100-
## Microsoft/DockerTools GitHub repo
101-
102-
For any other issues you encounter, see [Microsoft/DockerTools](https://github.com/microsoft/dockertools/issues) issues.
103-
104-
## See also
105-
106-
- [Visual Studio troubleshooting](/troubleshoot/visualstudio/welcome-visual-studio/)
100+
For any other issues, see the [Microsoft/DockerTools](https://github.com/microsoft/dockertools/issues) repo.
Lines changed: 10 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Troubleshooting Service References
2+
title: Troubleshoot references to WCF or WCF Data Services
33
description: Review common issues that may occur when you are working with Windows Communication Foundation (WCF) or WCF Data Services references in Visual Studio.
44
ms.custom: SEO-VS-2020
55
ms.date: 11/04/2016
@@ -20,20 +20,20 @@ ms.technology: vs-data-tools
2020
ms.workload:
2121
- data-storage
2222
---
23-
# Troubleshoot service references
23+
# Troubleshoot Windows Communication Foundation (WCF) or WCF Data Services references in Visual Studio
2424

2525
[!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
2626

27-
This topic lists common issues that may occur when you are working with Windows Communication Foundation (WCF) or WCF Data Services references in Visual Studio.
27+
This topic lists solutions to common issues that may occur when you are working with references to [Windows Communication Foundation (WCF) or WCF Data Services in Visual Studio](../data-tools/windows-communication-foundation-services-and-wcf-data-services-in-visual-studio.md).
28+
29+
If you want to update or remove a service reference, see the article "[Add, update, or remove a WCF data service reference](how-to-add-update-or-remove-a-wcf-data-service-reference.md)".
2830

2931
## Error returning data from a service
3032

3133
When you return a `DataSet` or `DataTable` from a service, you may receive a "The maximum size quota for incoming messages has been exceeded" exception. By default, the `MaxReceivedMessageSize` property for some bindings is set to a relatively small value to limit exposure to denial-of-service attacks. You can increase this value to prevent the exception. For more information, see <xref:System.ServiceModel.HttpBindingBase.MaxReceivedMessageSize%2A>.
3234

3335
To fix this error:
34-
3536
1. In **Solution Explorer**, double-click the *app.config* file to open it.
36-
3737
2. Locate the `MaxReceivedMessageSize` property and change it to a larger value.
3838

3939
## Cannot find a service in my solution
@@ -42,26 +42,23 @@ When you click the **Discover** button in the **Add Service References** dialog
4242

4343
To fix this error:
4444

45-
- In **Solution Explorer**, right-click the WCF Service Library project and click **Build**.
45+
1. In **Solution Explorer**, right-click the WCF Service Library project.
46+
1. Click **Build**.
4647

4748
## Error accessing a service over a remote desktop
4849

4950
When a user accesses a Web-hosted WCF service over a remote desktop connection and the user does not have administrative permissions, NTLM authentication is used. If the user does not have administrative permissions, the user may receive the following error message: "The HTTP request is unauthorized with client authentication scheme 'Anonymous'. The authentication header received from the server was 'NTLM'."
5051

5152
To fix this error:
52-
5353
1. In the website project, open the **Properties** pages.
54-
5554
2. On the **Start Options** tab, clear the **NTLM Authentication** check box.
5655

57-
> [!NOTE]
58-
> You should turn off NTLM authentication only for websites that exclusively contain WCF services. Security for WCF services is managed through the configuration in the *web.config* file. This makes NTLM authentication unnecessary.
56+
> [!NOTE]
57+
> You should turn off NTLM authentication only for websites that exclusively contain WCF services. Security for WCF services is managed through the configuration in the *web.config* file. This makes NTLM authentication unnecessary.
5958
6059
## Access level for generated classes setting has no effect
6160

62-
Setting the **Access level for generated classes** option in the **Configure Service References** dialog box to **Internal** or **Friend** may not always work. Even though the option appears to be set in the dialog box, the resulting support classes are generated with an access level of `Public`.
63-
64-
This is a known limitation of certain types, such as those serialized using the <xref:System.Xml.Serialization.XmlSerializer>.
61+
Setting the **Access level for generated classes** option in the **Configure Service References** dialog box to **Internal** or **Friend** may not always work. Even though the option appears to be set in the dialog box, the resulting support classes are generated with an access level of `Public`. This is a known limitation of certain types, such as those serialized using the <xref:System.Xml.Serialization.XmlSerializer>.
6562

6663
## Error debugging service code
6764

@@ -74,17 +71,11 @@ If the service project is removed from the solution, this explicit build depende
7471
To fix this error, you have to manually rebuild the service project:
7572

7673
1. On the **Tools** menu, click **Options**.
77-
7874
2. In the **Options** dialog box, expand **Projects and Solutions**, and then select **General**.
79-
8075
3. Make sure that the **Show advanced build configurations** check box is selected, and then click **OK**.
81-
8276
4. Load the WCF service project.
83-
8477
5. In the **Configuration Manager** dialog box, set the **Active solution configuration** to **Debug**. For more information, see [How to: Create and edit configurations](../ide/how-to-create-and-edit-configurations.md).
85-
8678
6. In **Solution Explorer**, select the WCF service project.
87-
8879
7. On the **Build** menu, click **Rebuild** to rebuild the WCF service project.
8980

9081
## WCF Data Services do not display in the browser
@@ -94,13 +85,6 @@ When it attempts to view an XML representation of data in a [!INCLUDE[ss_data_se
9485
To fix this error, disable RSS feeds:
9586

9687
1. In Internet Explorer, on the **Tools** menu, click **Internet Options**.
97-
9888
2. On the **Content** tab, in the **Feeds** section, click **Settings**.
99-
10089
3. In the **Feed Settings** dialog box, clear the **Turn on feed reading view** check box, and then click **OK**.
101-
10290
4. Click **OK** to close the **Internet Options** dialog box.
103-
104-
## See also
105-
106-
- [Windows Communication Foundation Services and WCF Data Services in Visual Studio](../data-tools/windows-communication-foundation-services-and-wcf-data-services-in-visual-studio.md)

docs/msbuild/diagnosing-task-failures.md

Lines changed: 15 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -18,51 +18,37 @@ ms.technology: msbuild
1818
ms.workload:
1919
- multiple
2020
---
21-
# Diagnosing task failures
21+
# Diagnose MSBuild task failures
2222

2323
`MSB6006` is emitted when a <xref:Microsoft.Build.Utilities.ToolTask>–derived class runs a tool process that returns a nonzero exit code if the task did not log a more specific error.
2424

25-
## Identifying the failing task
25+
## Identify the failing task
2626

2727
When you encounter a task error, the first step is to identify the task that is failing.
2828

29-
The text of the error specifies the tool name (either a friendly name provided by the task's implementation of <xref:Microsoft.Build.Utilities.ToolTask.ToolName> or the name of the executable) and the numeric exit code. For example, in
29+
The text of the error specifies the tool name (either a friendly name provided by the task's implementation of <xref:Microsoft.Build.Utilities.ToolTask.ToolName> or the name of the executable) and the numeric exit code. For example, in `error MSB6006: "custom tool" exited with code 1.` the tool name is `custom tool` and the exit code is `1`.
3030

31-
```text
32-
error MSB6006: "custom tool" exited with code 1.
33-
```
31+
**To find the failed MSBuild task:**
3432

35-
The tool name is `custom tool` and the exit code is `1`.
33+
+ **In the command-line builds**: If the build was configured to include a summary (the default), the summary will look like this:
3634

37-
### Command-line builds
35+
```text
36+
Build FAILED.
3837
39-
If the build was configured to include a summary (the default), the summary will look like this:
38+
"S:\MSB6006_demo\MSB6006_demo.csproj" (default target) (1) ->
39+
(InvokeToolTask target) ->
40+
S:\MSB6006_demo\MSB6006_demo.csproj(19,5): error MSB6006: "custom tool" exited with code 1.
41+
```
4042

41-
```text
42-
Build FAILED.
43+
This result indicates that the error occurred in a task defined on line 19 of the file `S:\MSB6006_demo\MSB6006_demo.csproj`, in a target named `InvokeToolTask`, in the project `S:\MSB6006_demo\MSB6006_demo.csproj`.
4344

44-
"S:\MSB6006_demo\MSB6006_demo.csproj" (default target) (1) ->
45-
(InvokeToolTask target) ->
46-
S:\MSB6006_demo\MSB6006_demo.csproj(19,5): error MSB6006: "custom tool" exited with code 1.
47-
```
45+
+ **In the Visual Studio UI**: The same information is available in the Visual Studio error list in the columns `Project`, `File`, and `Line`.
4846

49-
This result indicates that the error occurred in a task defined on line 19 of the file `S:\MSB6006_demo\MSB6006_demo.csproj`, in a target named `InvokeToolTask`, in the project `S:\MSB6006_demo\MSB6006_demo.csproj`.
50-
51-
### In Visual Studio
52-
53-
The same information is available in the Visual Studio error list in the columns `Project`, `File`, and `Line`.
54-
55-
## Finding more failure information
47+
## Find more failure information
5648

5749
This error is emitted when the task did not log a specific error. The failure to log an error is often because the task is not configured to understand the error format emitted by the tool it calls.
5850

59-
Well-behaved tools generally emit some contextual or error information to their standard output or error stream, and tasks capture and log this information by default. Look in the log entries before the error occurred for additional information. Rerunning the build with a higher log level may be required to preserve this information.
51+
Well-behaved tools generally emit some contextual or error information to their standard output or error stream, and tasks capture and log this information by default. Look in the log entries before the error occurred for additional information. Rerunning the build with a higher log level may be required to preserve this information. Hopefully, the additional context or errors identified in logging reveal the root cause of the problem. If not, you may have to narrow down the potential causes by examining the properties and items that are inputs to the failing task.
6052

6153
> [!NOTE]
6254
> MSBuild recognizes a specific diagnostic output format. The details of this format are documented at [MSBuild and Visual Studio format for diagnostic messages](msbuild-diagnostic-format-for-tasks.md).
63-
64-
## Next steps
65-
66-
Hopefully, the additional context or errors identified in logging reveal the root cause of the problem.
67-
68-
If they do not, you may have to narrow down the potential causes by examining the properties and items that are inputs to the failing task.

0 commit comments

Comments
 (0)