Merge pull request #664 from MicrosoftDocs/master

merge to live

Author: ghogen

docs/TOC.md

@@ -13,6 +13,6 @@
 # [Cross-Platform Mobile Development](cross-platform/cross-platform-mobile-development-in-visual-studio.md)
 # [Office and Sharepoint Development](vsto/office-and-sharepoint-development-in-visual-studio.md)
 # [Port, Migrate, and Upgrade Your Code](porting\port-migrate-and-upgrade-visual-studio-projects.md)
-# [Extensibility](extensibility/extensibility-in-visual-studio.md)
+# [Extensibility](extensibility/)
 # [Talk to Us](ide/talk-to-us.md)
 ## [How to Report a Problem with Visual Studio 2017](ide/how-to-report-a-problem-with-visual-studio-2017.md)

docs/_breadcrumb/toc.yml

@@ -18,7 +18,7 @@
         topicHref: /visualstudio/data-tools/accessing-data-in-visual-studio
       - name: Extensibility
         tocHref: /visualstudio/extensibility/
-        topicHref: /visualstudio/extensibility/extensibility-in-visual-studio
+        topicHref: /visualstudio/extensibility/
         items:
         - name: Inside the Visual Studio SDK
           tocHref: /visualstudio/extensibility/internals/

docs/code-quality/anonymous-methods-and-code-analysis.md

@@ -42,7 +42,7 @@ An *anonymous method* is a method that has no name. Anonymous methods are most f
 
  For example, in the following class, any warnings that are found in the declaration of **anonymousMethod** should be raised against **Method1** and not **Method2**.  
 
-```vb#  
+```vb  
 
       Delegate Function ADelegate(ByVal value As Integer) As Boolean  
 Class AClass  
@@ -55,7 +55,7 @@ Class AClass
     End SubEnd Class  
 ```  
 
-```c#  
+```csharp  
 
       delegate void Delegate();  
 class Class  
@@ -81,7 +81,7 @@ class Class
 
  For example, in the following class, any warnings that are found in the declaration of **anonymousMethod1** will be raised against the implicitly generated default constructor of **Class**. Whereas, those found in **anonymousMethod2** will be applied against the implicitly generated class constructor.  
 
-```vb#  
+```vb  
 
   Delegate Function ADelegate(ByVal value As Integer) As BooleanClass AClass  
 Dim anonymousMethod1 As ADelegate = Function(ByVal value As    Integer) value > 5  
@@ -93,7 +93,7 @@ Sub Method1()
 End SubEnd Class  
 ```  
 
-```c#  
+```csharp  
 
       delegate void Delegate();  
 class Class  
@@ -120,7 +120,7 @@ class Class
 
  For example, in the following class, any warnings that are found in the declaration of **anonymousMethod** should be raised against **Class(int)** and **Class(string)** but not against **Class()**.  
 
-```vb#  
+```vb  
 
   Delegate Function ADelegate(ByVal value As Integer) As BooleanClass AClass  
 
@@ -134,7 +134,7 @@ End SubSub New(ByVal a As String)
 End SubEnd Class  
 ```  
 
-```c#  
+```csharp  
 
       delegate void Delegate();  
 class Class  

docs/code-quality/ca1000-do-not-declare-static-members-on-generic-types.md

@@ -56,7 +56,7 @@ GenericType(Of Integer).SharedMethod()
 someObject.GenericMethod(Of Integer)()  
 ```  
 
-```c#  
+```csharp  
 // Static method in a generic type.  
 GenericType<int>.StaticMethod();  
 

docs/code-quality/ca1013-overload-operator-equals-on-overloading-add-and-subtract.md

@@ -63,7 +63,7 @@ Else
 End If  
 ```  
 
-```c#  
+```csharp  
 if (Object.ReferenceEquals(left, null))   
     return Object.ReferenceEquals(right, null);  
 return left.Equals(right);  

docs/code-quality/ca1024-use-properties-where-appropriate.md

@@ -102,7 +102,7 @@ Namespace Microsoft.Samples
 End Namespace  
 ```  
 
-```c#  
+```csharp  
 
       using System;   
 using System.Diagnostics;   

docs/code-quality/ca1058-types-should-not-extend-certain-base-types.md

@@ -71,7 +71,7 @@ translation.priority.ht:
 
  **Examples of Incorrect Usage**  
 
-```c#  
+```csharp  
 public class MyCollection : CollectionBase  
 {  
 }  
@@ -83,7 +83,7 @@ public class MyReadOnlyCollection : ReadOnlyCollectionBase
 
  **Examples of Correct Usage**  
 
-```c#  
+```csharp  
 public class MyCollection : Collection<T>  
 {  
 }  

docs/code-quality/ca1062-validate-arguments-of-public-methods.md

@@ -60,7 +60,7 @@ translation.priority.ht:
 ## Example  
  The following example shows a method that violates the rule and a method that satisfies the rule.  
 
- ```cs
+ ```csharp
  using System;
 
 namespace DesignLibrary
@@ -129,7 +129,7 @@ End Namespace
 ## Example  
  In [!INCLUDE[vsprvslong](../code-quality/includes/vsprvslong_md.md)], this rule does not detect that parameters are being passed to another method that does the validation.  
 
-```cs
+```csharp
 public string Method(string value)
 {
 	EnsureNotNull(value);
@@ -165,7 +165,7 @@ End Sub
 
  In the following `Person` class example, the `other` object that is passed to the `Person` copy constructor might be `null`.  
 
-```cs  
+```csharp  
 public class Person  
 {  
     public string Name { get; private set; }  
@@ -189,7 +189,7 @@ public class Person
 ## Example  
  In the following revised `Person` example, the `other` object that is passed to the copy constructor is first checked for null in the `PassThroughNonNull` method.  
 
-```cs  
+```csharp  
 public class Person  
 {  
     public string Name { get; private set; }  

docs/code-quality/ca1407-avoid-static-members-in-com-visible-types.md

@@ -55,7 +55,7 @@ translation.priority.mt:
 
  For this rule to occur, an assembly-level <xref:System.Runtime.InteropServices.ComVisibleAttribute> must be set to `false` and the class- <xref:System.Runtime.InteropServices.ComVisibleAttribute> must be set to `true`, as the following code shows.  
 
-```c#  
+```csharp  
 using System;  
 using System.Runtime.InteropServices;   
 

docs/code-quality/ca1812-avoid-uninstantiated-internal-classes.md

@@ -83,7 +83,7 @@ translation.priority.mt:
 
 -   The class is passed as a generic type parameter that has a new constraint. For example, the following example will raise this rule.  
 
-    ```c#  
+    ```csharp  
     internal class MyClass  
     {     
         public DoSomething()     

docs/code-quality/ca1901-p-invoke-declarations-should-be-portable.md

@@ -62,7 +62,7 @@ translation.priority.mt:
 ## Example  
  The following example demonstrates a violation of this rule.  
 
-```c#  
+```csharp  
 internal class NativeMethods  
 {  
     [DllImport("shell32.dll", CharSet=CharSet.Auto)]  
@@ -73,15 +73,15 @@ internal class NativeMethods
 
  In this example, the `nIconIndex` parameter is declared as an `IntPtr`, which is 4 bytes wide on a 32-bit platform and 8 bytes wide on a 64-bit platform. In the unmanaged declaration that follows, you can see that `nIconIndex` is a 4-byte unsigned integer on all platforms.  
 
-```c#  
+```csharp  
 HICON ExtractIcon(HINSTANCE hInst, LPCTSTR lpszExeFileName,   
     UINT nIconIndex);  
 ```  
 
 ## Example  
  To fix the violation, change the declaration to the following:  
 
-```c#  
+```csharp  
 internal class NativeMethods{  
     [DllImport("shell32.dll", CharSet=CharSet.Auto)]   
     internal static extern IntPtr ExtractIcon(IntPtr hInst,   

docs/code-quality/ca2000-dispose-objects-before-losing-scope.md

@@ -62,7 +62,7 @@ translation.priority.ht:
 
 -   Nesting constructors that are protected only by one exception handler. For example,  
 
-    ```cs
+    ```csharp
     using (StreamReader sr = new StreamReader(new FileStream("C:\myfile.txt", FileMode.Create)))  
     { ... }  
     ```
@@ -94,7 +94,7 @@ translation.priority.ht:
 
  The `finally` block checks the value of `tempPort`. If it is not null, an operation in the method has failed, and `tempPort` is closed to make sure that any resources are released. The returned port object will contain the opened SerialPort object if the operations of the method succeeded, or it will be null if an operation failed.  
 
-```cs
+```csharp
 public SerialPort OpenPort1(string portName)
 {
    SerialPort port = new SerialPort(portName);

docs/code-quality/ca2151-fields-with-critical-types-should-be-security-critical.md

@@ -39,7 +39,7 @@ translation.priority.ht:
 ## Cause  
  A security transparent field or a safe critical field is declared. Its type is specified as security critical. For example:  
 
-```c#  
+```csharp  
 [assembly: AllowPartiallyTrustedCallers]  
 
    [SecurityCritical]  
@@ -60,7 +60,7 @@ translation.priority.ht:
 ## How to Fix Violations  
  To fix a violation of this rule, mark the field with the <xref:System.Security.SecurityCriticalAttribute> attribute, or make the type that is referenced by the field eith security transparent or safe critical.  
 
-```c#  
+```csharp  
 // Fix 1: Make the referencing field security critical  
 [assembly: AllowPartiallyTrustedCallers]  
 

docs/code-quality/ca2231-overload-operator-equals-on-overriding-valuetype-equals.md

@@ -59,7 +59,7 @@ Else
 End If  
 ```  
 
-```c#  
+```csharp  
 if (Object.ReferenceEquals(left, null))   
     return Object.ReferenceEquals(right, null);  
 return left.Equals(right);  

docs/code-quality/ca3075-insecure-dtd-processing.md

@@ -89,7 +89,7 @@ translation.priority.mt:
 
 ### Violation  
 
-```c#  
+```csharp  
 using System.IO;   
 using System.Xml.Schema;   
 
@@ -110,7 +110,7 @@ class TestClass
 
 ### Solution  
 
-```c#  
+```csharp  
 using System.IO;   
 using System.Xml;   
 using System.Xml.Schema;   
@@ -133,7 +133,7 @@ class TestClass
 
 ### Violation  
 
-```c#  
+```csharp  
 using System.Xml;   
 
 namespace TestNamespace   
@@ -151,7 +151,7 @@ namespace TestNamespace
 
 ### Solution  
 
-```c#  
+```csharp  
 using System.Xml;   
 
 namespace TestNamespace   
@@ -173,7 +173,7 @@ namespace TestNamespace
 
 ### Violations  
 
-```c#  
+```csharp  
 using System.Xml;   
 
 namespace TestNamespace   
@@ -189,7 +189,7 @@ namespace TestNamespace
 }  
 ```  
 
-```c#  
+```csharp  
 using System.Xml;   
 
 namespace TestNamespace   
@@ -207,7 +207,7 @@ namespace TestNamespace
 
 ### Solution  
 
-```c#  
+```csharp  
 using System.Xml;   
 
 public static void TestMethod(string xml)   
@@ -221,7 +221,7 @@ public static void TestMethod(string xml)
 
 ### Violation  
 
-```c#  
+```csharp  
 using System.IO;   
 using System.Xml;   
 using System.Xml.Serialization;   
@@ -241,7 +241,7 @@ namespace TestNamespace
 
 ### Solution  
 
-```c#  
+```csharp  
 using System.IO;   
 using System.Xml;   
 using System.Xml.Serialization;   
@@ -262,7 +262,7 @@ namespace TestNamespace
 
 ### Violation  
 
-```c#  
+```csharp  
 using System.Xml;   
 using System.Xml.XPath;   
 
@@ -280,7 +280,7 @@ namespace TestNamespace
 
 ### Solution  
 
-```c#  
+```csharp  
 using System.Xml;   
 using System.Xml.XPath;   
 
@@ -299,7 +299,7 @@ namespace TestNamespace
 
 ### Violation  
 
-```c#  
+```csharp  
 using System.Xml;   
 
 namespace TestNamespace   
@@ -313,7 +313,7 @@ namespace TestNamespace
 
 ### Solution  
 
-```c#  
+```csharp  
 using System.Xml;   
 
 namespace TestNamespace   
@@ -327,7 +327,7 @@ namespace TestNamespace
 
 ### Violations  
 
-```c#  
+```csharp  
 using System.Xml;   
 
 namespace TestNamespace   
@@ -343,7 +343,7 @@ namespace TestNamespace
 }  
 ```  
 
-```c#  
+```csharp  
 using System.Xml;   
 
 namespace TestNamespace   
@@ -358,7 +358,7 @@ namespace TestNamespace
 }  
 ```  
 
-```c#  
+```csharp  
 using System.Xml;   
 
 namespace TestNamespace   
@@ -379,7 +379,7 @@ namespace TestNamespace
 
 ### Solution  
 
-```c#  
+```csharp  
 using System.Xml;   
 
 namespace TestNamespace