Removing CDATA blocks, fixing cref links

Author: benrr101

doc/snippets/Microsoft.Data.SqlClient/ActiveDirectoryAuthenticationProvider.xml

@@ -178,7 +178,7 @@
         <see langword="true" /> if the specified authentication method is supported; otherwise, <see langword="false" />.
       </returns>
       <remarks>
-        The supported authentication modes with <see cref="Microsoft.Data.SqlClient.ActiveDirectoryAuthenticationProvider" /> are:
+        The supported authentication modes with <see cref="T:Microsoft.Data.SqlClient.ActiveDirectoryAuthenticationProvider" /> are:
         <list type="bullet">
           <item>Active Directory Password</item>
           <item>Active Directory Integrated</item>

doc/snippets/Microsoft.Data.SqlClient/ApplicationIntent.xml

@@ -2,7 +2,7 @@
   <members name="ApplicationIntent">
     <ApplicationIntent>
       <summary>
-        Specifies a value for <see cref="P:Microsoft.Data.SqlClient.SqlConnectionStringBuilder.ApplicationIntent" />. Possible values are <see cref="Microsoft.Data.SqlClient.ApplicationIntent.ReadWrite" /> and <see cref="Microsoft.Data.SqlClient.ApplicationIntent.ReadOnly" />.
+        Specifies a value for <see cref="P:Microsoft.Data.SqlClient.SqlConnectionStringBuilder.ApplicationIntent" />. Possible values are <see cref="F:Microsoft.Data.SqlClient.ApplicationIntent.ReadWrite" /> and <see cref="F:Microsoft.Data.SqlClient.ApplicationIntent.ReadOnly" />.
       </summary>
     </ApplicationIntent>
     <ReadWrite>

doc/snippets/Microsoft.Data.SqlClient/OnChangeEventHandler.xml

@@ -9,7 +9,7 @@
         Handles the <see cref="E:Microsoft.Data.SqlClient.SqlDependency.OnChange" /> event that is fired when a notification is received for any of the commands associated with a <see cref="T:Microsoft.Data.SqlClient.SqlDependency" /> object.
       </summary>
       <remarks>
-        The <see cref="Microsoft.Data.SqlClient.SqlDependency.OnChange" /> event does not necessarily imply a change in the data. Other circumstances, such as time-out expired and failure to set the notification request, also generate <see cref="Microsoft.Data.SqlClient.SqlDependency.OnChange" />.
+        The <see cref="E:Microsoft.Data.SqlClient.SqlDependency.OnChange" /> event does not necessarily imply a change in the data. Other circumstances, such as time-out expired and failure to set the notification request, also generate <see cref="E:Microsoft.Data.SqlClient.SqlDependency.OnChange" />.
       </remarks>
     </OnChangeEventHandler>
   </members>

doc/snippets/Microsoft.Data.SqlClient/SqlAuthenticationProvider.xml

@@ -8,64 +8,62 @@
       <example>
         The following example demonstrates implementing a custom SqlAuthenticationProvider and providing the same to SqlClient for overriding Device Code Flow authentication mode:
         <code language="c#">
-          <![CDATA[
-using System;
-using System.Threading.Tasks;
-using Microsoft.Identity.Client;
-using Microsoft.Data.SqlClient;
-
-namespace CustomAuthenticationProviderExamples
-{
-    /// summary>
-    /// Example demonstrating creating a custom device code flow authentication provider and attaching it to the driver.
-    /// This is helpful for applications that wish to override the Callback for the Device Code Result implemented by the SqlClient driver.
-    /// </summary>
-    public class CustomDeviceCodeFlowAzureAuthenticationProvider : SqlAuthenticationProvider
-    {
-        public override async Task<SqlAuthenticationToken> AcquireTokenAsync(SqlAuthenticationParameters parameters)
-        {
-            string clientId = "my-client-id";
-            string clientName = "My Application Name";
-            string s_defaultScopeSuffix = "/.default";
-
-            string[] scopes = new string[] { parameters.Resource.EndsWith(s_defaultScopeSuffix) ? parameters.Resource : parameters.Resource + s_defaultScopeSuffix };
-
-            IPublicClientApplication app = PublicClientApplicationBuilder.Create(clientId)
-                .WithAuthority(parameters.Authority)
-                .WithClientName(clientName)
-                .WithRedirectUri("https://login.microsoftonline.com/common/oauth2/nativeclient")
-                .Build();
-
-            AuthenticationResult result = await app.AcquireTokenWithDeviceCode(scopes,
-            deviceCodeResult => CustomDeviceFlowCallback(deviceCodeResult)).ExecuteAsync();
-            return new SqlAuthenticationToken(result.AccessToken, result.ExpiresOn);
-        }
-
-        public override bool IsSupported(SqlAuthenticationMethod authenticationMethod) =>
-            authenticationMethod.Equals(SqlAuthenticationMethod.ActiveDirectoryDeviceCodeFlow);
-
-        private Task CustomDeviceFlowCallback(DeviceCodeResult result)
-        {
-            Console.WriteLine(result.Message);
-            return Task.FromResult(0);
-        }
-    }
-
-    public class Program
-    {
-        public static void Main()
-        {
-            // Register our custom authentication provider class to override Active Directory Device Code Flow
-            SqlAuthenticationProvider.SetProvider(SqlAuthenticationMethod.ActiveDirectoryDeviceCodeFlow, new CustomDeviceCodeFlowAzureAuthenticationProvider());
-            using (SqlConnection sqlConnection = new SqlConnection("Server=<myserver>.database.windows.net;Authentication=Active Directory Device Code Flow;Database=<db>;"))
-            {
-                sqlConnection.Open();
-                Console.WriteLine("Connected successfully!");
-            }
-        }
-    }
-}
-        ]]>
+          using System;
+          using System.Threading.Tasks;
+          using Microsoft.Identity.Client;
+          using Microsoft.Data.SqlClient;
+          
+          namespace CustomAuthenticationProviderExamples
+          {
+              /// summary>
+              /// Example demonstrating creating a custom device code flow authentication provider and attaching it to the driver.
+              /// This is helpful for applications that wish to override the Callback for the Device Code Result implemented by the SqlClient driver.
+              /// &lt;/summary&gt;
+              public class CustomDeviceCodeFlowAzureAuthenticationProvider : SqlAuthenticationProvider
+              {
+                  public override async Task&lt;SqlAuthenticationToken&gt; AcquireTokenAsync(SqlAuthenticationParameters parameters)
+                  {
+                      string clientId = "my-client-id";
+                      string clientName = "My Application Name";
+                      string s_defaultScopeSuffix = "/.default";
+          
+                      string[] scopes = new string[] { parameters.Resource.EndsWith(s_defaultScopeSuffix) ? parameters.Resource : parameters.Resource + s_defaultScopeSuffix };
+          
+                      IPublicClientApplication app = PublicClientApplicationBuilder.Create(clientId)
+                          .WithAuthority(parameters.Authority)
+                          .WithClientName(clientName)
+                          .WithRedirectUri("https://login.microsoftonline.com/common/oauth2/nativeclient")
+                          .Build();
+          
+                      AuthenticationResult result = await app.AcquireTokenWithDeviceCode(scopes,
+                      deviceCodeResult => CustomDeviceFlowCallback(deviceCodeResult)).ExecuteAsync();
+                      return new SqlAuthenticationToken(result.AccessToken, result.ExpiresOn);
+                  }
+          
+                  public override bool IsSupported(SqlAuthenticationMethod authenticationMethod) =>
+                      authenticationMethod.Equals(SqlAuthenticationMethod.ActiveDirectoryDeviceCodeFlow);
+          
+                  private Task CustomDeviceFlowCallback(DeviceCodeResult result)
+                  {
+                      Console.WriteLine(result.Message);
+                      return Task.FromResult(0);
+                  }
+              }
+          
+              public class Program
+              {
+                  public static void Main()
+                  {
+                      // Register our custom authentication provider class to override Active Directory Device Code Flow
+                      SqlAuthenticationProvider.SetProvider(SqlAuthenticationMethod.ActiveDirectoryDeviceCodeFlow, new CustomDeviceCodeFlowAzureAuthenticationProvider());
+                      using (SqlConnection sqlConnection = new SqlConnection("Server=&lt;myserver&gt;.database.windows.net;Authentication=Active Directory Device Code Flow;Database=&lt;db&gt;;"))
+                      {
+                          sqlConnection.Open();
+                          Console.WriteLine("Connected successfully!");
+                      }
+                  }
+              }
+          }
         </code>
       </example>
     </SqlAuthenticationProvider>