markdig fixes - Part 12 (#2689)

* markdig fixes

* another try to add samples

* test code reference

* fix code references

Author: mairaw

xml/System.ServiceModel.Configuration/ServiceMetadataPublishingElement.xml

@@ -254,7 +254,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- If the <xref:System.ServiceModel.Configuration.ServiceMetadataPublishingElement.HttpGetUrl%2A> property is not specified, the address at which the metadata is published is the service address plus a "?wsdl". For example, if the service address is "http://localhost:8080/CalculatorService", the HTTP/Get metadata address is "http://localhost:8080/CalculatorService?wsdl".  
+ If the <xref:System.ServiceModel.Configuration.ServiceMetadataPublishingElement.HttpGetUrl%2A> property is not specified, the address at which the metadata is published is the service address plus a "?wsdl". For example, if the service address is `http://localhost:8080/CalculatorService`, the HTTP/Get metadata address is `http://localhost:8080/CalculatorService?wsdl`.  
   
  If this property is `false`, or the address of the service is not based on HTTP or HTTPS, "?wsdl" is ignored.  
   
@@ -385,7 +385,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- If the <xref:System.ServiceModel.Configuration.ServiceMetadataPublishingElement.HttpsGetUrl%2A> property is not specified, the address at which the metadata is published is the service address plus a "?wsdl". For example, if the service address is "https://localhost:8080/CalculatorService", the HTTP/Get metadata address is "https://localhost:8080/CalculatorService?wsdl".  
+ If the <xref:System.ServiceModel.Configuration.ServiceMetadataPublishingElement.HttpsGetUrl%2A> property is not specified, the address at which the metadata is published is the service address plus a "?wsdl". For example, if the service address is `https://localhost:8080/CalculatorService`, the HTTP/Get metadata address is `https://localhost:8080/CalculatorService?wsdl`.  
   
  If this property is `false`, or the address of the service is not based on HTTP or HTTPS, "?wsdl" is ignored.  
   

xml/System.ServiceModel.Configuration/WebHttpBindingElement.xml

@@ -177,7 +177,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- An Internet resource is local if it has a local address. A local address is one that is on same computer, the local LAN or intranet and is identified, syntactically, by the lack of a period (.) as in the URIs "http://webserver/" and "http://localhost/".  
+ An Internet resource is local if it has a local address. A local address is one that is on same computer, the local LAN or intranet and is identified, syntactically, by the lack of a period (.) as in the URIs `http://webserver/` and `http://localhost/`.  
   
  Setting the <xref:System.ServiceModel.Configuration.WebHttpBindingElement.BypassProxyOnLocal%2A> property determines whether endpoints configured with the <xref:System.ServiceModel.Configuration.WebHttpBindingElement> use the proxy server when accessing local resources.  
   

xml/System.ServiceModel.Dispatcher/EndpointAddressMessageFilter.xml

@@ -22,7 +22,7 @@
 ## Remarks  
  This filter tests whether a message satisfies a particular endpoint address. An <xref:System.ServiceModel.EndpointAddress> object includes a URI and an optional collection of addressing headers. The addressing and message headers are canonicalized in order to be compared for equality. If a parameter appears more than once in an <xref:System.ServiceModel.EndpointAddress>, the corresponding header must appear in the message at least that many times.  
   
- IIS and the underlying file system (NTFS or FAT) are case-insensitive. URI comparisons done by this class are also case-insensitive. So, for example, http://www.microsoft.com is evaluated as equal to http://WWW.microsoft.com.  
+ IIS and the underlying file system (NTFS or FAT) are case-insensitive. URI comparisons done by this class are also case-insensitive. So, for example, `http://www.microsoft.com` is evaluated as equal to `http://WWW.microsoft.com`.  
   
  ]]></format>
     </remarks>
@@ -92,15 +92,13 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- If you have a web service installed on your local machine, there are many equivalent ways to reference it, including the following:  
+
+If you have a web service installed on your local machine, there are many equivalent ways to reference it, including the following:  
   
--   http://localhost/foo.svc  
-  
--   http://192.168.1.100/foo.svc  
-  
--   http://[my-machine-name]/foo.svc  
-  
--   http://[my-machine-name].[my-company].com/foo.svc.  
+- `http://localhost/foo.svc`
+- `http://192.168.1.100/foo.svc`
+- `http://[my-machine-name]/foo.svc`
+- `http://[my-machine-name].[my-company].com/foo.svc`
   
  If the value of the `includeHostNameInComparison` parameter is `false`, the above URIs all resolve to the same endpoint.  
   
@@ -202,15 +200,13 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- If you have a web service installed on your local machine, there are many equivalent ways to reference it, including the following:  
-  
--   http://localhost/foo.svc  
-  
--   http://192.168.1.100/foo.svc  
-  
--   http://[my-machine-name]/foo.svc  
-  
--   http://[my-machine-name].[my-company].com/foo.svc.  
+
+If you have a web service installed on your local machine, there are many equivalent ways to reference it, including the following:  
+
+- `http://localhost/foo.svc`
+- `http://192.168.1.100/foo.svc`
+- `http://[my-machine-name]/foo.svc`
+- `http://[my-machine-name].[my-company].com/foo.svc`
   
  The default value of this property is `false`, so the above URIs all resolve to the same endpoint, unless you change this property.  
   

xml/System.ServiceModel.Dispatcher/PrefixEndpointAddressMessageFilter.xml

@@ -24,7 +24,7 @@
   
  This filter performs the same query as <xref:System.ServiceModel.Dispatcher.EndpointAddressMessageFilter>, except that the test for whether a message matches an endpoint address is done by a *Longest-Prefix Match*. This means that the URI specified in the filter does not have to match the message's URI exactly, but must be contained in that URI as a prefix. For example, if a filter specifies the address "www.foo.com", and a message is addressed to "www.foo.com/customerA", then the URI part of the filter query condition will be met. However, the header portion of the filter query still has to be done.  
   
- Internet Information Services (IIS) and the underlying file system (NTFS or FAT) are case-insensitive. URI comparisons done by this class are also case-insensitive. So, for example, http://www.microsoft.com is evaluated as equal to http://WWW.microsoft.com.  
+ Internet Information Services (IIS) and the underlying file system (NTFS or FAT) are case-insensitive. URI comparisons done by this class are also case-insensitive. So, for example, `http://www.microsoft.com` is evaluated as equal to `http://WWW.microsoft.com`.  
   
  ]]></format>
     </remarks>
@@ -94,15 +94,13 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- If you have a web service installed on your local machine, there are many equivalent ways to reference it, including the following:  
-  
--   http://localhost/foo.svc  
-  
--   http://192.168.1.100/foo.svc  
-  
--   http://[my-machine-name]/foo.svc  
-  
--   http://[my-machine-name].[my-company].com/foo.svc.  
+
+If you have a web service installed on your local machine, there are many equivalent ways to reference it, including the following:  
+
+- `http://localhost/foo.svc`
+- `http://192.168.1.100/foo.svc`
+- `http://[my-machine-name]/foo.svc`
+- `http://[my-machine-name].[my-company].com/foo.svc`
   
  If the value of the `includeHostNameInComparison` parameter is `false`, the above URIs all resolve to the same endpoint.  
   
@@ -199,15 +197,13 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- If you have a web service installed on your local machine, there are many equivalent ways to reference it, including the following:  
-  
--   http://localhost/foo.svc  
-  
--   http://192.168.1.100/foo.svc  
-  
--   http://[my-machine-name]/foo.svc  
-  
--   http://[my-machine-name].[my-company].com/foo.svc.  
+
+If you have a web service installed on your local machine, there are many equivalent ways to reference it, including the following:  
+
+- `http://localhost/foo.svc`
+- `http://192.168.1.100/foo.svc`
+- `http://[my-machine-name]/foo.svc`
+- `http://[my-machine-name].[my-company].com/foo.svc`
   
  The default value of this property is `false`, so the above URIs all resolve to the same endpoint, unless you change this property.  
   

xml/System.ServiceModel.Dispatcher/QueryStringConverter.xml

@@ -23,7 +23,7 @@
 ## Remarks  
  Parameters can be specified in a query string within a URL. This class takes those parameters specified in a string and converts them into objects. For example, the following contract is defined.  
   
-```  
+```csharp
 [ServiceContract]  
 interface Calculator  
 {  
@@ -33,7 +33,7 @@ interface Calculator
 }  
 ```  
   
- A Windows Communication Foundation (WCF) service implements this interface and exposes it on an endpoint with the <xref:System.ServiceModel.Description.WebHttpBehavior> at http://localhost:8000/MyCalcService. The `Add` service operation can be called by sending an HTTP GET to http://localhost:8000/MyCalcService/Add?n1=10&n2=5. The <xref:System.ServiceModel.Dispatcher.QueryStringConverter> receives this URL and converts the two parameters (n1 and n2) specified in the URL into two `long` objects with the appropriate values.  
+ A Windows Communication Foundation (WCF) service implements this interface and exposes it on an endpoint with the <xref:System.ServiceModel.Description.WebHttpBehavior> at `http://localhost:8000/MyCalcService`. The `Add` service operation can be called by sending an HTTP GET to `http://localhost:8000/MyCalcService/Add?n1=10&n2=5`. The <xref:System.ServiceModel.Dispatcher.QueryStringConverter> receives this URL and converts the two parameters (n1 and n2) specified in the URL into two `long` objects with the appropriate values.  
   
  You can derive a class from <xref:System.ServiceModel.Dispatcher.QueryStringConverter> to control how query string parameters are mapped into a service operation's parameters.  
   

xml/System.Web.Configuration/HttpRuntimeSection.xml

@@ -1317,7 +1317,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Web.Configuration.HttpRuntimeSection.UseFullyQualifiedRedirectUrl%2A> property indicates whether client-side redirects are fully qualified (in the form http://server/path) or whether relative redirects are instead sent to the client.  
+ The <xref:System.Web.Configuration.HttpRuntimeSection.UseFullyQualifiedRedirectUrl%2A> property indicates whether client-side redirects are fully qualified (in the form `http://server/path`) or whether relative redirects are instead sent to the client.  
   
 > [!NOTE]
 >  Some browsers might have problems loading pages in cookieless sessions when this value is `false`.  

xml/System.Web.Services/WebServiceAttribute.xml

@@ -44,9 +44,10 @@
    
   
 ## Examples  
- The following example sets the <xref:System.Web.Services.WebServiceAttribute.Description%2A> property of the <xref:System.Web.Services.WebServiceAttribute> to " `Common Server Variables` " and sets the XML namespace to http://www.microsoft.com/.  
-  
-  
+ The following example sets the <xref:System.Web.Services.WebServiceAttribute.Description%2A> property of the <xref:System.Web.Services.WebServiceAttribute> to `"Common Server Variables"` and sets the XML namespace to `http://www.microsoft.com/`.
+
+[!code-aspx-csharp[Classic WebServiceAttribute Example](~/samples/snippets/csharp/VS_Snippets_Remoting/Classic WebServiceAttribute Example/CS/sourcecs.asmx)]
+[!code-aspx-vb[Classic WebServiceAttribute Example](~/samples/snippets/visualbasic/VS_Snippets_Remoting/Classic WebServiceAttribute Example/VB/sourcevb.asmx)]    
   
  ]]></format>
     </remarks>
@@ -131,9 +132,10 @@
    
   
 ## Examples  
- The following example sets the <xref:System.Web.Services.WebServiceAttribute.Description%2A> property to " `Common Server Variables` ".  
-  
+ The following example sets the <xref:System.Web.Services.WebServiceAttribute.Description%2A> property to `"Common Server Variables"`.
   
+[!code-aspx-csharp[Classic WebServiceAttribute Example](~/samples/snippets/csharp/VS_Snippets_Remoting/Classic WebServiceAttribute Example/CS/sourcecs.asmx)]
+[!code-aspx-vb[Classic WebServiceAttribute Example](~/samples/snippets/visualbasic/VS_Snippets_Remoting/Classic WebServiceAttribute Example/VB/sourcevb.asmx)]    
   
  ]]></format>
         </remarks>
@@ -178,6 +180,8 @@
 ## Examples  
  The following example sets <xref:System.Web.Services.WebServiceAttribute.Name%2A> of the XML Web service to `MyName`.  
   
+[!code-aspx-csharp[Classic WebServiceAttribute.Name Example](~/samples/snippets/csharp/VS_Snippets_Remoting/Classic WebServiceAttribute.Name Example/CS/sourcecs.asmx)]
+[!code-aspx-vb[Classic WebServiceAttribute.Name Example](~/samples/snippets/visualbasic/VS_Snippets_Remoting/Classic WebServiceAttribute.Name Example/VB/sourcevb.asmx)]    
   
   
  ]]></format>
@@ -224,7 +228,8 @@
 ## Examples  
  The following example sets <xref:System.Web.Services.WebServiceAttribute.Namespace%2A> to `http://www.contoso.com` and overrides that namespace for the <xref:System.Web.Services.Protocols.SoapDocumentMethodAttribute.Action%2A> property by adding a <xref:System.Web.Services.Protocols.SoapDocumentMethodAttribute> to the `Time` XML Web service method.  
   
-  
+[!code-aspx-csharp[Classic WebServiceAttribute.Namespace Example](~/samples/snippets/csharp/VS_Snippets_Remoting/Classic WebServiceAttribute.Namespace Example/CS/sourcecs.asmx)]
+[!code-aspx-vb[Classic WebServiceAttribute.Namespace Example](~/samples/snippets/visualbasic/VS_Snippets_Remoting/Classic WebServiceAttribute.Namespace Example/VB/sourcevb.asmx)]    
   
  ]]></format>
         </remarks>
@@ -237,4 +242,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Web/HttpRequest.xml

@@ -731,7 +731,7 @@ End Class
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Web.HttpRequest.FilePath%2A> property does not include the <xref:System.Web.HttpRequest.PathInfo%2A> trailer. For example, for the URL http://www.contoso.com/virdir/page.html/tail, the <xref:System.Web.HttpRequest.FilePath%2A> value is /virdir/page.html.  
+ The <xref:System.Web.HttpRequest.FilePath%2A> property does not include the <xref:System.Web.HttpRequest.PathInfo%2A> trailer. For example, for the URL `http://www.contoso.com/virdir/page.html/tail`, the <xref:System.Web.HttpRequest.FilePath%2A> value is /virdir/page.html.  
   
    
   
@@ -1631,7 +1631,7 @@ No <see cref="T:System.Web.HttpContext" /> object is defined for the request.</e
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Web.HttpRequest.Path%2A> is the concatenation of the <xref:System.Web.HttpRequest.FilePath%2A> and the <xref:System.Web.HttpRequest.PathInfo%2A> trailer. For example, for the URL http://www.contoso.com/virdir/page.html/tail, the <xref:System.Web.HttpRequest.Path%2A> is /virdir/page.html/tail.  
+ The <xref:System.Web.HttpRequest.Path%2A> is the concatenation of the <xref:System.Web.HttpRequest.FilePath%2A> and the <xref:System.Web.HttpRequest.PathInfo%2A> trailer. For example, for the URL `http://www.contoso.com/virdir/page.html/tail`, the <xref:System.Web.HttpRequest.Path%2A> is /virdir/page.html/tail.  
   
    
   
@@ -1671,7 +1671,7 @@ No <see cref="T:System.Web.HttpContext" /> object is defined for the request.</e
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- For the URL Http://www.contoso.com/virdir/page.html/tail, the <xref:System.Web.HttpRequest.PathInfo%2A> value is /tail.  
+ For the URL `http://www.contoso.com/virdir/page.html/tail`, the <xref:System.Web.HttpRequest.PathInfo%2A> value is /tail.  
   
    
   
@@ -1835,7 +1835,7 @@ Dim fullname2 As String = Request("fullname")
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The raw URL is defined as the part of the URL following the domain information. In the URL string http://www.contoso.com/articles/recent.aspx, the raw URL is /articles/recent.aspx. The raw URL includes the query string, if present.  
+ The raw URL is defined as the part of the URL following the domain information. In the URL string `http://www.contoso.com/articles/recent.aspx`, the raw URL is /articles/recent.aspx. The raw URL includes the query string, if present.  
   
    
   

xml/System.Web/HttpRequestBase.xml

@@ -1150,7 +1150,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- For the URL Http://www.contoso.com/virdir/page.html/tail, the <xref:System.Web.HttpRequestBase.PathInfo%2A> value is /tail.  
+ For the URL `http://www.contoso.com/virdir/page.html/tail`, the <xref:System.Web.HttpRequestBase.PathInfo%2A> value is /tail.  
   
  ]]></format>
         </remarks>

xml/System.Web/HttpRequestWrapper.xml

@@ -1178,7 +1178,7 @@ No <see cref="T:System.Web.HttpContext" /> object is defined for the request.</e
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- For the URL Http://www.contoso.com/virdir/page.html/tail, the <xref:System.Web.HttpRequestWrapper.PathInfo%2A> value is /tail.  
+ For the URL `http://www.contoso.com/virdir/page.html/tail`, the <xref:System.Web.HttpRequestWrapper.PathInfo%2A> value is /tail.  
   
  ]]></format>
         </remarks>