Skip to content

Commit 04ad3e2

Browse files
authored
Merge pull request #2127 from MicrosoftDocs/repo_sync_working_branch
Confirm merge from repo_sync_working_branch to master to sync with https://github.com/MicrosoftDocs/visualstudio-docs (branch master)
2 parents 910350c + 2b82100 commit 04ad3e2

6 files changed

+35
-9
lines changed

docs/debugger/using-the-debuggerdisplay-attribute.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -82,6 +82,7 @@ public sealed class MyClass
8282
}
8383
}
8484
```
85+
The ",nq" suffix tells the expression evaluator to remove the quotes when displaying the final value (nq = no quotes).
8586

8687
## Example
8788
The following code example shows how to use `DebuggerDisplay`, together with `DebuggerBrowseable` and `DebuggerTypeProxy`. When viewed in a debugger variables window, such as the **Watch** window, it produces an expansion that looks like this:

docs/deployment/creating-bootstrapper-packages.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ The following table shows the properties that are automatically populated by the
8181
|ApplicationName|The name of the application.|
8282
|ProcessorArchitecture|The processor and bits-per-word of the platform targeted by an executable. Values include the following:<br /><br /> - Intel<br />- IA64<br />- AMD64|
8383
|[Version9x](https://msdn.microsoft.com/en-us/library/aa372490\(v=vs.140\).aspx)|The version number for Microsoft Windows 95, Windows 98, or Windows ME operating systems. The syntax of the version is Major.Minor.ServicePack.|
84-
|[VersionNT](https://msdn.microsoft.com/en-us/library/aa372495\(v=vs.140\).xaspx)|The version number for the Windows NT, Windows 2000, Windows XP, Windows Vista, Windows Server 2008, or Windows 7 operating systems. The syntax of the version is Major.Minor.ServicePack.|
84+
|[VersionNT](https://msdn.microsoft.com/en-us/library/aa372495\(v=vs.140\).aspx)|The version number for the Windows NT, Windows 2000, Windows XP, Windows Vista, Windows Server 2008, or Windows 7 operating systems. The syntax of the version is Major.Minor.ServicePack.|
8585
|[VersionMSI](https://msdn.microsoft.com/en-us/library/aa372493\(v=vs.140\).aspx)|The version of the Windows Installer assembly (msi.dll) run during the installation.|
8686
|[AdminUser](https://msdn.microsoft.com/en-us/library/aa367545\(v=vs.140\).aspx)|This property is set if the user has administrator privileges. Values are true or false.|
8787
|InstallMode|The installation mode indicates where the component needs to be installed from. Values include the following:<br /><br /> - HomeSite - prerequisites are installed from the vendor's Web site.<br />- SpecificSite - prerequisites are installed from the location that you select.<br />- SameSite - prerequisites are installed from the same location as the application.|
@@ -104,4 +104,4 @@ The redistributable list is an XML file that you should name using the following
104104
[How to: Install Prerequisites with a ClickOnce Application](../deployment/how-to-install-prerequisites-with-a-clickonce-application.md)
105105
[Prerequisites Dialog Box](../ide/reference/prerequisites-dialog-box.md)
106106
[Product and Package Schema Reference](../deployment/product-and-package-schema-reference.md)
107-
[Use the Visual Studio 2005 Bootstrapper to Kick-Start Your Installation](http://go.microsoft.com/fwlink/?LinkId=107537)
107+
[Use the Visual Studio 2005 Bootstrapper to Kick-Start Your Installation](http://go.microsoft.com/fwlink/?LinkId=107537)

docs/deployment/trusted-application-deployment-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ This topic provides an overview of how to deploy [!INCLUDE[ndptecclick](../deplo
8181
Trusted Application Deployment is specific to [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)], and can only be used with [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] applications.
8282

8383
### Sign the Deployment
84-
After obtaining your certificate, you must use it to sign your deployment. If you are deploying your application by using the [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] Publish wizard, the wizard will automatically generate a test certificate for you if you have not specified a certificate yourself. You can also use the [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] Project Designer window, however, to supply a certificate provided by a CA. Also see [How to: Publish a ClickOnce Application using the Publish Wizard](http://msdn.microsoft.com/library/31kztyey\(v=vs.110\).
84+
After obtaining your certificate, you must use it to sign your deployment. If you are deploying your application by using the [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] Publish wizard, the wizard will automatically generate a test certificate for you if you have not specified a certificate yourself. You can also use the [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] Project Designer window, however, to supply a certificate provided by a CA. Also see [How to: Publish a ClickOnce Application using the Publish Wizard](../deployment/how-to-publish-a-clickonce-application-using-the-publish-wizard.md).
8585

8686
> [!CAUTION]
8787
> We do not recommend that the application be deployed with a test certificate.

docs/ide/editorconfig-code-style-settings-reference.md

Lines changed: 28 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,7 @@ The following list shows the allowable language convention rules:
6969
- dotnet\_style\_require\_accessibility_modifiers
7070
- csharp\_preferred\_modifier_order
7171
- visual\_basic\_preferred\_modifier_order
72+
- dotnet\_style\_readonly\_field
7273
- [Expression-level preferences](#expression_level)
7374
- dotnet\_style\_object_initializer
7475
- dotnet\_style\_collection_initializer
@@ -233,7 +234,7 @@ The following table shows the rule names, rules IDs, applicable programming lang
233234

234235
| Rule name | Rule ID | Applicable languages | Visual Studio default |
235236
| --------- | ------- | -------------------- | ----------------------|
236-
| dotnet_style_predefined_type_for_locals_ parameters_members | IDE0012 and IDE0014 | C# and Visual Basic | true:none |
237+
| dotnet_style_predefined_type_for_locals_parameters_members | IDE0012 and IDE0014 | C# and Visual Basic | true:none |
237238
| dotnet_style_predefined_type_for_member_access | IDE0013 and IDE0015 | C# and Visual Basic | true:none |
238239

239240
**dotnet\_style\_predefined\_type\_for\_locals\_parameters_members**
@@ -293,7 +294,7 @@ dotnet_style_predefined_type_for_member_access = true:suggestion
293294

294295
#### <a name="normalize_modifiers"></a>Modifier preferences
295296

296-
The style rules in this section concern modifier preferences, including requiring accessibility modifiers and specifying the desired modifier sort order.
297+
The style rules in this section concern modifier preferences, including requiring accessibility modifiers, specifying the desired modifier sort order, and requiring the read-only modifier.
297298

298299
The following table shows the rule names, rule IDs, applicable programming languages, default values, and first supported version of Visual Studio:
299300

@@ -302,6 +303,7 @@ The following table shows the rule names, rule IDs, applicable programming langu
302303
| dotnet_style_require_ accessibility_modifiers | IDE0040 | C# and Visual Basic | for_non_interface_members:none | 15.5 |
303304
| csharp_preferred_modifier_order | IDE0036 | C# | public, private, protected, internal, static, extern, new, virtual, abstract, sealed, override, readonly, unsafe, volatile, async:none | 15.5 |
304305
| visual_basic_preferred_modifier_order | IDE0036 | Visual Basic | Partial, Default, Private, Protected, Public, Friend, NotOverridable, Overridable, MustOverride, Overloads, Overrides, MustInherit, NotInheritable, Static, Shared, Shadows, ReadOnly, WriteOnly, Dim, Const,WithEvents, Widening, Narrowing, Custom, Async:none | 15.5 |
306+
| dotnet_style_readonly_field | IDE0044 | C# and Visual Basic | true:suggestion | 15.7 |
305307

306308
**dotnet\_style\_require\_accessibility_modifiers**
307309

@@ -310,7 +312,7 @@ This rule does not accept a **true** or **false** value; instead it accepts a va
310312
| Value | Description |
311313
| ----- |:----------- |
312314
| always | Prefer accessibility modifiers to be specified |
313-
| for\_non\_interface_members | Prefer accessibility modifiers to be declared except for public interface members. This will currently not differ from **always** and will act as future proofing for if C# adds default interface methods. |
315+
| for\_non\_interface_members | Prefer accessibility modifiers to be declared except for public interface members. This is the same as **always** and has been added for future proofing if C# adds default interface methods. |
314316
| never | Do not prefer accessibility modifiers to be specified |
315317

316318
Code examples:
@@ -359,12 +361,35 @@ Public Class MyClass
359361
End Class
360362
```
361363

364+
**dotnet_style_readonly_field**
365+
366+
- When this rule is set to **true**, prefer that fields should be marked with `readonly` (C#) or `ReadOnly` (Visual Basic) if they are only ever assigned inline, or inside of a constructor.
367+
- When this rule is set to **false**, specify no preference over whether fields should be marked with `readonly` (C#) or `ReadOnly` (Visual Basic).
368+
369+
Code examples:
370+
371+
```csharp
372+
// dotnet_style_readonly_field = true
373+
class MyClass
374+
{
375+
private readonly int _daysInYear = 365;
376+
}
377+
```
378+
379+
```vb
380+
' dotnet_style_readonly_field = true
381+
Public Class MyClass
382+
Private ReadOnly daysInYear As Int = 365
383+
End Class
384+
```
385+
362386
These rules could appear in an *.editorconfig* file as follows:
363387

364388
```EditorConfig
365389
# CSharp and Visual Basic code style settings:
366390
[*.{cs,vb}]
367391
dotnet_style_require_accessibility_modifiers = always:suggestion
392+
dotnet_style_readonly_field = true:warning
368393
369394
# CSharp code style settings:
370395
[*.cs]

docs/python/learn-django-in-visual-studio-step-04-full-django-project-template.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ ms.workload:
1717

1818
**Previous step: [Serve static files, add pages, and use template inheritance](learn-django-in-visual-studio-step-03-serve-static-files-and-add-pages.md)**
1919

20-
Now that you've explored the basics of Django by building an app upon the "Blank Django App Project" template in Visual Studio, you can easily understand the fuller app that's produced by the "Django Web Project" template.
20+
Now that you've explored the basics of Django by building an app upon the "Blank Django Web Project" template in Visual Studio, you can easily understand the fuller app that's produced by the "Django Web Project" template.
2121

2222
In this step you now:
2323

@@ -213,4 +213,4 @@ Answer: The lack of the trailing '$' in the regular expression was a simple over
213213
## Going deeper
214214

215215
- [Writing your first Django app, part 4 - forms and generic views](https://docs.djangoproject.com/en/2.0/intro/tutorial04/) (docs.djangoproject.com)
216-
- Tutorial source code on GitHub: [Microsoft/python-sample-vs-learning-django](https://github.com/Microsoft/python-sample-vs-learning-django)
216+
- Tutorial source code on GitHub: [Microsoft/python-sample-vs-learning-django](https://github.com/Microsoft/python-sample-vs-learning-django)

mac/docfx.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@
3333
"globalMetadata": {
3434
"feedback_system": "GitHub",
3535
"feedback_github_repo": "MicrosoftDocs/visualstudio-docs",
36-
"feedback_product_url": "https://developercommunity.visualstudio.com/",
36+
"feedback_product_url": "https://developercommunity.visualstudio.com/spaces/41/index.html",
3737
"contributors_to_exclude": ["conceptdev","meganbradley"],
3838
"breadcrumb_path": "~/_breadcrumb/toc.yml",
3939
"manager": "crdun",

0 commit comments

Comments
 (0)