Implement async schema APIs. Fixes #835

Author: bgrainger

docs/content/api/MySqlConnector/MySqlConnection/GetSchemaAsync.md

@@ -0,0 +1,26 @@
+---
+title: GetSchemaAsync
+---
+
+# MySqlConnection.GetSchemaAsync method
+
+Asynchronously returns schema information for the data source of this [`MySqlConnection`](../../MySqlConnectionType/).
+
+```csharp
+public Task<DataTable> GetSchemaAsync(string collectionName = null, string[] restrictions = null, 
+    CancellationToken cancellationToken = default(CancellationToken))
+```
+
+| parameter | description |
+| --- | --- |
+| collectionName | The schema name of data to be returned; if `null`, the `MetaDataCollections` schema is returned. |
+| restrictions | The restrictions to apply to the schema; this parameter is currently ignored. |
+| cancellationToken | A token to cancel the asynchronous operation. |
+
+## See Also
+
+* class [MySqlConnection](../../MySqlConnectionType/)
+* namespace [MySqlConnector](../../MySqlConnectionType/)
+* assembly [MySqlConnector](../../../MySqlConnectorAssembly/)
+
+<!-- DO NOT EDIT: generated by xmldocmd for MySqlConnector.dll -->

docs/content/api/MySqlConnector/MySqlConnectionType.md

@@ -41,6 +41,7 @@ public sealed class MySqlConnection : DbConnection, ICloneable
 | override [EnlistTransaction](../MySqlConnection/EnlistTransaction/)(…) |  |
 | override [GetSchema](../MySqlConnection/GetSchema/)() |  |
 | override [GetSchema](../MySqlConnection/GetSchema/)(…) |  (2 methods) |
+| [GetSchemaAsync](../MySqlConnection/GetSchemaAsync/)(…) | Asynchronously returns schema information for the data source of this [`MySqlConnection`](../MySqlConnectionType/). |
 | override [Open](../MySqlConnection/Open/)() |  |
 | override [OpenAsync](../MySqlConnection/OpenAsync/)(…) |  |
 | [Ping](../MySqlConnection/Ping/)() |  |

docs/content/api/MySqlConnector/MySqlDataReader/GetColumnSchemaAsync.md

@@ -0,0 +1,32 @@
+---
+title: GetColumnSchemaAsync
+---
+
+# MySqlDataReader.GetColumnSchemaAsync method
+
+Returns metadata about the columns in the result set.
+
+```csharp
+public Task<ReadOnlyCollection<DbColumn>> GetColumnSchemaAsync(
+    CancellationToken cancellationToken = default(CancellationToken))
+```
+
+| parameter | description |
+| --- | --- |
+| cancellationToken | A token to cancel the operation. |
+
+## Return Value
+
+A Task containing ReadOnlyCollection containing metadata about the result set.
+
+## Remarks
+
+This method runs synchronously; prefer to call [`GetColumnSchema`](../GetColumnSchema/) to avoid the overhead of allocating an unnecessary `Task`.
+
+## See Also
+
+* class [MySqlDataReader](../../MySqlDataReaderType/)
+* namespace [MySqlConnector](../../MySqlDataReaderType/)
+* assembly [MySqlConnector](../../../MySqlConnectorAssembly/)
+
+<!-- DO NOT EDIT: generated by xmldocmd for MySqlConnector.dll -->

docs/content/api/MySqlConnector/MySqlDataReader/GetSchemaTable.md

@@ -4,10 +4,16 @@ title: GetSchemaTable
 
 # MySqlDataReader.GetSchemaTable method
 
+Returns a DataTable that contains metadata about the columns in the result set.
+
 ```csharp
 public override DataTable GetSchemaTable()
 ```
 
+## Return Value
+
+A DataTable containing metadata about the columns in the result set.
+
 ## See Also
 
 * class [MySqlDataReader](../../MySqlDataReaderType/)

docs/content/api/MySqlConnector/MySqlDataReader/GetSchemaTableAsync.md

@@ -0,0 +1,32 @@
+---
+title: GetSchemaTableAsync
+---
+
+# MySqlDataReader.GetSchemaTableAsync method
+
+Returns a DataTable that contains metadata about the columns in the result set.
+
+```csharp
+public Task<DataTable> GetSchemaTableAsync(
+    CancellationToken cancellationToken = default(CancellationToken))
+```
+
+| parameter | description |
+| --- | --- |
+| cancellationToken | A token to cancel the operation. |
+
+## Return Value
+
+A DataTable containing metadata about the columns in the result set.
+
+## Remarks
+
+This method runs synchronously; prefer to call [`GetSchemaTable`](../GetSchemaTable/) to avoid the overhead of allocating an unnecessary `Task`.
+
+## See Also
+
+* class [MySqlDataReader](../../MySqlDataReaderType/)
+* namespace [MySqlConnector](../../MySqlDataReaderType/)
+* assembly [MySqlConnector](../../../MySqlConnectorAssembly/)
+
+<!-- DO NOT EDIT: generated by xmldocmd for MySqlConnector.dll -->

docs/content/api/MySqlConnector/MySqlDataReaderType.md

@@ -30,6 +30,7 @@ public sealed class MySqlDataReader : DbDataReader, IDbColumnSchemaGenerator
 | [GetChar](../MySqlDataReader/GetChar/)(…) |  |
 | override [GetChars](../MySqlDataReader/GetChars/)(…) |  |
 | [GetColumnSchema](../MySqlDataReader/GetColumnSchema/)() | Returns metadata about the columns in the result set. |
+| [GetColumnSchemaAsync](../MySqlDataReader/GetColumnSchemaAsync/)(…) | Returns metadata about the columns in the result set. |
 | override [GetDataTypeName](../MySqlDataReader/GetDataTypeName/)(…) |  |
 | override [GetDateTime](../MySqlDataReader/GetDateTime/)(…) |  |
 | [GetDateTime](../MySqlDataReader/GetDateTime/)(…) |  |
@@ -57,7 +58,8 @@ public sealed class MySqlDataReader : DbDataReader, IDbColumnSchemaGenerator
 | override [GetName](../MySqlDataReader/GetName/)(…) |  |
 | override [GetOrdinal](../MySqlDataReader/GetOrdinal/)(…) |  |
 | [GetSByte](../MySqlDataReader/GetSByte/)(…) |  (2 methods) |
-| override [GetSchemaTable](../MySqlDataReader/GetSchemaTable/)() |  |
+| override [GetSchemaTable](../MySqlDataReader/GetSchemaTable/)() | Returns a DataTable that contains metadata about the columns in the result set. |
+| [GetSchemaTableAsync](../MySqlDataReader/GetSchemaTableAsync/)(…) | Returns a DataTable that contains metadata about the columns in the result set. |
 | override [GetStream](../MySqlDataReader/GetStream/)(…) |  |
 | [GetStream](../MySqlDataReader/GetStream/)(…) |  |
 | override [GetString](../MySqlDataReader/GetString/)(…) |  |