Skip to content

Commit bfb3cab

Browse files
authored
Merge pull request #5722 from MicrosoftDocs/master637327855226007465
For protected CLA branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents 08fbac1 + 7682d31 commit bfb3cab

19 files changed

+240
-63
lines changed

docs/code-quality/code-analysis-warnings-for-managed-code-by-checkid.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -286,6 +286,7 @@ f1_keywords:
286286
- CA2247
287287
- CA5122
288288
- CA5374
289+
- IL3000
289290
ms.assetid: 5cb221f6-dc59-4abf-9bfa-adbd6f907f96
290291
author: mikejo5000
291292
ms.author: mikejo
@@ -597,3 +598,4 @@ The following table lists Code Analysis warnings for managed code by the CheckId
597598
| CA5400 | [CA5400 Ensure HttpClient certificate revocation list check is not disabled](../code-quality/ca5400.md) | A revoked certificate isn't trusted anymore. It could be used by attackers passing some malicious data or stealing sensitive data in HTTPS communication. |
598599
| CA5401 | [CA5401 Do not use CreateEncryptor with non-default IV](../code-quality/ca5401.md) | Symmetric encryption should always use a non-repeatable initialization vector to prevent dictionary attacks. |
599600
| CA5402 | [CA5402 Use CreateEncryptor with the default IV](../code-quality/ca5402.md) | Symmetric encryption should always use a non-repeatable initialization vector to prevent dictionary attacks. |
601+
| IL3000 | [IL3000 Avoid using accessing Assembly file path when publishing as a single-file](../code-quality/il3000.md) | Avoid using accessing Assembly file path when publishing as a single-file |

docs/code-quality/il3000.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
title: "IL3000: Avoid using accessing Assembly file path when publishing as a single-file"
3+
description: "Assembly.Location always returns an empty string for assemblies embedded in a single-file bundle"
4+
ms.date: 08/04/2020
5+
ms.topic: reference
6+
author: agocke
7+
ms.author: angocke
8+
manager: angocke
9+
ms.workload:
10+
- "multiple"
11+
f1_keywords:
12+
- "IL3000"
13+
- "AvoidAssemblyLocationInSingleFile"
14+
---
15+
# IL3000: Avoid using accessing Assembly file path when publishing as a single-file
16+
17+
## Cause
18+
19+
When publishing as a single-file (for example, by setting the PublishSingleFile property in a project to true), calling the `Assembly.Location` property for
20+
assemblies embedded inside the single-file bundle always returns an empty string.
21+
22+
## How to fix violations
23+
24+
If the app only needs the containing directory for the single-file bundle, consider using the `AppContext.BaseDirectory` property instead. Otherwise, consider
25+
removing the call entirely.
26+
27+
## When to suppress warnings
28+
29+
It's appropriate to silence this warning if the assembly being accessed is definitely not in the single-file bundle. This may be the case if the assembly is being loaded dynamically from a file path.

docs/code-quality/toc.yml

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -983,3 +983,9 @@
983983
href: ca2248.md
984984
- name: Automatic feature suspension
985985
href: automatic-feature-suspension.md
986+
- name: Publish warnings
987+
items:
988+
- name: Overview
989+
displayName: "publish warnings"
990+
- name: "IL3000: Avoid using accessing Assembly file path when publishing as a single-file"
991+
href: il3000.md

docs/extensibility/internals/microsoft-help-viewer-sdk.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -440,7 +440,7 @@ Note: variables noted by "{n}" have code dependencies - removing or changing the
440440

441441
**Branding.xml**
442442

443-
| | |
443+
| Feature | Description |
444444
| - | - |
445445
| Feature: | **CollapsibleArea** |
446446
| Use: | Expand collapses content control text |

docs/extensibility/ux-guidelines/composite-patterns-for-visual-studio.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -514,13 +514,13 @@ Composite patterns combine interaction and design elements in distinct configura
514514

515515
||Basic experience|Optimized experience|Elevated experience|
516516
|-|----------------------|--------------------------|-------------------------|
517-
|Enables users to ...|Fix code and solution/project-level reading without dead ends|Perform maintenance, refactors, and navigation tasks|Operate in a consistent, intuitive, and fluid experience with confidence|
518-
|Editor|Touch panning and selection<br /><br /> Scrollbar touch to jump and press+drag|Pinch zoom<br /><br /> Fast scroll<br /><br /> Selection<br /><br /> Easy use of context menu||
519-
|Top tool windows|List panning<br /><br /> Item selection<br /><br /> Scrollbar touch to jump and press+drag|Easy item scrolling and selection||
520-
|Windowing||Resize window<br /><br /> Quick access||
521-
|Document well||Easy navigation between open files||
522-
|Gestures||Ensure common gestures work across the IDE|Gesture-based actions<br /><br /> Support drag-and-drop and designers|
523-
|Other considerations|||Custom onscreen keyboard|
517+
|**Enables users to ...**|Fix code and solution/project-level reading without dead ends|Perform maintenance, refactors, and navigation tasks|Operate in a consistent, intuitive, and fluid experience with confidence|
518+
|**Editor**|Touch panning and selection<br /><br /> Scrollbar touch to jump and press+drag|Pinch zoom<br /><br /> Fast scroll<br /><br /> Selection<br /><br /> Easy use of context menu||
519+
|**Top tool windows**|List panning<br /><br /> Item selection<br /><br /> Scrollbar touch to jump and press+drag|Easy item scrolling and selection||
520+
|**Windowing**||Resize window<br /><br /> Quick access||
521+
|**Document well**||Easy navigation between open files||
522+
|**Gestures**||Ensure common gestures work across the IDE|Gesture-based actions<br /><br /> Support drag-and-drop and designers|
523+
|**Other considerations**|||Custom onscreen keyboard|
524524

525525
#### Gestures
526526
Gestures provide users a shortcut to commands that might otherwise require a more complicated interaction. Refer to the Windows guidelines on [common touch gestures for Desktop Applications](/windows/desktop/wintouch/windows-touch-gestures-overview), and follow this guidance for most gestures, including simple gestures such as panning and zooming.
Loading
357 Bytes
Loading

docs/ide/suggest-a-feature.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,13 @@ A feature suggestion marked **Need More Info** means that we need more details s
8181

8282
Found the information we were looking for? You may request to reactivate the ticket when you have the additional information.
8383

84+
- - -
85+
86+
![Closed - Out of Scope state for suggestions on Developer Community](../ide/media/SuggestStates/closed-out-of-scope.png)
87+
88+
**Closed - Out of Scope** If a suggestion doesn’t match our overall product direction, we will close it as *Out of Scope*. For example, we may have similar investments in other members of the Visual Studio family of products. Or the feature suggested might only be relevant to a few people, making an extension better suited to provide it.
89+
90+
8491
- - -
8592

8693
![Completed - Preview state for suggestions on Developer Community](../ide/media/SuggestStates/CompletedPreview.jpg)

docs/install/command-line-parameter-examples.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,8 @@ For lists of the workloads and components that you can install by using the comm
6666
```
6767

6868
```powershell
69-
$exitCode = Start-Process -FilePath vs_enterprise.exe -ArgumentList "--installPath", "C:\VS", "--passive", "--wait" -Wait -PassThru
69+
$process = Start-Process -FilePath vs_enterprise.exe -ArgumentList "--installPath", "C:\VS", "--passive", "--wait" -Wait -PassThru
70+
Write-Output $process.ExitCode
7071
```
7172

7273
or

docs/install/install-visual-studio.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Install Visual Studio
33
titleSuffix: ''
44
description: Learn how to install Visual Studio, step-by-step.
55
ms.date: 12/13/2019
6-
ms.custom: seodec18
6+
ms.custom: contperfq1
77
ms.topic: conceptual
88
f1_keywords:
99
- vs.about

docs/install/visual-studio-build-numbers-and-release-dates.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: A list of released versions and build numbers for Visual Studio, so
55
author: ornellaalt
66
ms.author: ornella
77
manager: jillfra
8-
ms.date: 08/05/2020
8+
ms.date: 08/11/2020
99
ms.topic: reference
1010
ms.workload:
1111
- multiple
@@ -23,6 +23,9 @@ The following table lists the build numbers and release dates for Visual Studio
2323

2424
| **Version**| **Channel** | **Release date** | **Build version** |
2525
| ---------------------- | ----------- | ---------------- | ----------------- |
26+
| 16.7.1 | Release | August 11, 2020 | 16.7.30406.217 |
27+
| 16.4.12 | Release | August 11, 2020 | 16.4.30406.169 |
28+
| 16.0.17 | Release | August 11, 2020 | 16.0.28803.806 |
2629
| 16.8.0 | Preview 1 | August 5, 2020 | 16.8.30404.54 |
2730
| 16.7.0 | Release | August 5, 2020 | 16.7.30330.147 |
2831
| 16.7.0 | Preview 6 | July 28, 2020 | 16.7.30323.103 |
@@ -160,6 +163,7 @@ The following table lists the build numbers and release dates for Visual Studio
160163

161164
| **Version**| **Channel** | **Release date** | **Build version** |
162165
| ---------------------- | ----------- | ---------------- | ----------------- |
166+
| 15.9.26 | Release | August 11, 2020 | 15.9.28307.1234 |
163167
| 15.9.25 | Release | July 14, 2020 | 15.9.28307.1216 |
164168
| 15.9.24 | Release | June 9, 2020 | 15.9.28307.1177 |
165169
| 15.9.23 | Release | May 12, 2020 | 15.9.28307.1146 |

docs/vs-2015/extensibility/image-service-and-catalog.md

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -151,12 +151,10 @@ This cookbook contains guidance and best practices for adopting the Visual Studi
151151
</Source>
152152
```
153153

154-
| | |
155-
|---------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
156-
| **Attribute** | **Definition** |
157-
| Uri | [Required] A URI that defines where the image can be loaded from. It can be one of the following:<br /><br /> - A [Pack URI](https://msdn.microsoft.com/library/aa970069\(v=vs.100\).aspx) using the application:/// authority<br />- An absolute component resource reference<br />- A path to a file containing a native resource |
158-
| Background | [Optional] Indicates what on kind of background the source is intended to be used.<br /><br /> It can be one of the following:<br /><br /> *Light:* The source can be used on a light background.<br /><br /> <em>Dark:</em>The source can be used on a dark background.<br /><br /> *HighContrast:* The source can be used on any background in High Contrast mode.<br /><br /> *HighContrastLight:* The source can be used on a light background in High Contrast mode.<br /><br /> *HighContrastDark:* The source can be used on a dark background in High Contrast mode.<br /><br /> If the Background attribute is omitted, the source can be used on any background.<br /><br /> If Background is *Light*, *Dark*, *HighContrastLight*, or *HighContrastDark*, the source’s colors are never inverted. If Background is omitted or set to *HighContrast*, the inversion of the source’s colors is controlled by the image’s **AllowColorInversion** attribute. |
159-
| | |
154+
|**Attribute**|**Definition**|
155+
|-|-|
156+
| Uri | [Required] A URI that defines where the image can be loaded from. It can be one of the following:<br /><br /> - A [Pack URI](https://msdn.microsoft.com/library/aa970069\(v=vs.100\).aspx) using the application:/// authority<br />- An absolute component resource reference<br />- A path to a file containing a native resource |
157+
| Background | [Optional] Indicates what on kind of background the source is intended to be used.<br /><br /> It can be one of the following:<br /><br /> *Light:* The source can be used on a light background.<br /><br /> <em>Dark:</em>The source can be used on a dark background.<br /><br /> *HighContrast:* The source can be used on any background in High Contrast mode.<br /><br /> *HighContrastLight:* The source can be used on a light background in High Contrast mode.<br /><br /> *HighContrastDark:* The source can be used on a dark background in High Contrast mode.<br /><br /> If the Background attribute is omitted, the source can be used on any background.<br /><br /> If Background is *Light*, *Dark*, *HighContrastLight*, or *HighContrastDark*, the source’s colors are never inverted. If Background is omitted or set to *HighContrast*, the inversion of the source’s colors is controlled by the image’s **AllowColorInversion** attribute. |
160158

161159
A \<Source> element can have exactly one of the following optional subelements:
162160

docs/vs-2015/extensibility/license-element-vsix-language-pack-schema.md

Lines changed: 33 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -48,13 +48,39 @@ Optional. The path of a localized version of the license file for the extension.
4848
If the `License` element is defined, then the text of the designated license file is displayed during setup and the user must accept the license to continue.
4949

5050
## Element Information
51-
52-
| | |
53-
|-----------------|-----------------------------------------------------------|
54-
| Namespace | `http://schemas.microsoft.com/developer/vsx-schema-lp/2010` |
55-
| Schema Name | VSIX Language Pack Schema |
56-
| Validation File | VSIXLanguagePackSchema.xsd |
57-
| Can be Empty | Not applicable |
51+
52+
:::row:::
53+
:::column:::
54+
Namespace
55+
:::column-end:::
56+
:::column:::
57+
`http://schemas.microsoft.com/developer/vsx-schema-lp/2010`
58+
:::column-end:::
59+
:::row-end:::
60+
:::row:::
61+
:::column:::
62+
Schema Name
63+
:::column-end:::
64+
:::column:::
65+
VSIX Language Pack Schema
66+
:::column-end:::
67+
:::row-end:::
68+
:::row:::
69+
:::column:::
70+
Validation File
71+
:::column-end:::
72+
:::column:::
73+
VSIXLanguagePackSchema.xsd
74+
:::column-end:::
75+
:::row-end:::
76+
:::row:::
77+
:::column:::
78+
Can be Empty
79+
:::column-end:::
80+
:::column:::
81+
Not applicable
82+
:::column-end:::
83+
:::row-end:::
5884

5985
## See Also
6086
[VSX Language Pack Schema Reference](../extensibility/vsx-language-pack-schema-reference.md)

docs/vs-2015/extensibility/localizeddescription-element-vsix-language-pack-schema.md

Lines changed: 33 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -45,13 +45,39 @@ Required. Provides a localized description of the extension.
4545
Required. A text description of the extension in the target language.
4646

4747
## Element Information
48-
49-
| | |
50-
|-----------------|-----------------------------------------------------------|
51-
| Namespace | `http://schemas.microsoft.com/developer/vsx-schema-lp/2010` |
52-
| Schema Name | VSIX Language Pack Schema |
53-
| Validation File | VSIXLanguagePackSchema.xsd |
54-
| Can be Empty | Not applicable |
48+
49+
:::row:::
50+
:::column:::
51+
Namespace
52+
:::column-end:::
53+
:::column:::
54+
`http://schemas.microsoft.com/developer/vsx-schema-lp/2010`
55+
:::column-end:::
56+
:::row-end:::
57+
:::row:::
58+
:::column:::
59+
Schema Name
60+
:::column-end:::
61+
:::column:::
62+
VSIX Language Pack Schema
63+
:::column-end:::
64+
:::row-end:::
65+
:::row:::
66+
:::column:::
67+
Validation File
68+
:::column-end:::
69+
:::column:::
70+
VSIXLanguagePackSchema.xsd
71+
:::column-end:::
72+
:::row-end:::
73+
:::row:::
74+
:::column:::
75+
Can be Empty
76+
:::column-end:::
77+
:::column:::
78+
Not applicable
79+
:::column-end:::
80+
:::row-end:::
5581

5682
## See Also
5783
[VSX Language Pack Schema Reference](../extensibility/vsx-language-pack-schema-reference.md)

docs/vs-2015/extensibility/localizedname-element-vsix-language-pack-schema.md

Lines changed: 33 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -45,13 +45,39 @@ Required. The localized name of the extension to be installed.
4545
Required. The name of the language pack in the target language.
4646

4747
## Element Information
48-
49-
| | |
50-
|-----------------|-----------------------------------------------------------|
51-
| Namespace | `http://schemas.microsoft.com/developer/vsx-schema-lp/2010` |
52-
| Schema Name | VSIX Language Pack Schema |
53-
| Validation File | VSIXLanguagePackSchema.xsd |
54-
| Can be Empty | Not applicable |
48+
49+
:::row:::
50+
:::column:::
51+
Namespace
52+
:::column-end:::
53+
:::column:::
54+
`http://schemas.microsoft.com/developer/vsx-schema-lp/2010`
55+
:::column-end:::
56+
:::row-end:::
57+
:::row:::
58+
:::column:::
59+
Schema Name
60+
:::column-end:::
61+
:::column:::
62+
VSIX Language Pack Schema
63+
:::column-end:::
64+
:::row-end:::
65+
:::row:::
66+
:::column:::
67+
Validation File
68+
:::column-end:::
69+
:::column:::
70+
VSIXLanguagePackSchema.xsd
71+
:::column-end:::
72+
:::row-end:::
73+
:::row:::
74+
:::column:::
75+
Can be Empty
76+
:::column-end:::
77+
:::column:::
78+
Not applicable
79+
:::column-end:::
80+
:::row-end:::
5581

5682
## See Also
5783
[VSX Language Pack Schema Reference](../extensibility/vsx-language-pack-schema-reference.md)

0 commit comments

Comments
 (0)