SqlConnection.GetSchemaAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| Nombre | Description |
|---|---|
| GetSchemaAsync(CancellationToken) |
Una versión asincrónica de , que devuelve información de GetSchema()esquema para el origen de datos de este SqlConnection. Para obtener más información sobre los esquemas, consulte SQL Server Colecciones de esquemas. |
| GetSchemaAsync(String, CancellationToken) |
Una versión asincrónica de , que devuelve información de GetSchema(String)esquema para el origen de datos de este SqlConnection utilizando la cadena especificada para el nombre del esquema. |
| GetSchemaAsync(String, String[], CancellationToken) |
Una versión asincrónica de , que devuelve información de GetSchema(String, String[])esquema para el origen de datos de este SqlConnection utilizando la cadena especificada para el nombre del esquema y la matriz de cadenas especificada para los valores de restricción. |
GetSchemaAsync(CancellationToken)
Una versión asincrónica de , que devuelve información de GetSchema()esquema para el origen de datos de este SqlConnection. Para obtener más información sobre los esquemas, consulte SQL Server Colecciones de esquemas.
public System.Threading.Tasks.Task<System.Data.DataTable> GetSchemaAsync(System.Threading.CancellationToken cancellationToken = default);public override System.Threading.Tasks.Task<System.Data.DataTable> GetSchemaAsync(System.Threading.CancellationToken cancellationToken = default);member this.GetSchemaAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.DataTable>override this.GetSchemaAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.DataTable>Public Function GetSchemaAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of DataTable)Public Overrides Function GetSchemaAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of DataTable)Parámetros
- cancellationToken
- CancellationToken
Token de cancelación.
Devoluciones
Tarea que representa la operación asincrónica.
Comentarios
Para obtener más información sobre la programación asincrónica en la Proveedor de datos de .NET Framework para SQL Server, consulte Asynchronous Programming.
Se aplica a
GetSchemaAsync(String, CancellationToken)
Una versión asincrónica de , que devuelve información de GetSchema(String)esquema para el origen de datos de este SqlConnection utilizando la cadena especificada para el nombre del esquema.
public System.Threading.Tasks.Task<System.Data.DataTable> GetSchemaAsync(string collectionName, System.Threading.CancellationToken cancellationToken = default);public override System.Threading.Tasks.Task<System.Data.DataTable> GetSchemaAsync(string collectionName, System.Threading.CancellationToken cancellationToken = default);member this.GetSchemaAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.DataTable>override this.GetSchemaAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.DataTable>Public Function GetSchemaAsync (collectionName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DataTable)Public Overrides Function GetSchemaAsync (collectionName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DataTable)Parámetros
- collectionName
- String
Especifica el nombre del esquema que se va a devolver.
- cancellationToken
- CancellationToken
Token de cancelación.
Devoluciones
Tarea que representa la operación asincrónica.
Excepciones
collectionName se especifica como null.
Comentarios
Para obtener más información sobre la programación asincrónica en la Proveedor de datos de .NET Framework para SQL Server, consulte Asynchronous Programming.
Se aplica a
GetSchemaAsync(String, String[], CancellationToken)
Una versión asincrónica de , que devuelve información de GetSchema(String, String[])esquema para el origen de datos de este SqlConnection utilizando la cadena especificada para el nombre del esquema y la matriz de cadenas especificada para los valores de restricción.
public System.Threading.Tasks.Task<System.Data.DataTable> GetSchemaAsync(string collectionName, string[] restrictionValues, System.Threading.CancellationToken cancellationToken = default);public override System.Threading.Tasks.Task<System.Data.DataTable> GetSchemaAsync(string collectionName, string[] restrictionValues, System.Threading.CancellationToken cancellationToken = default);member this.GetSchemaAsync : string * string[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.DataTable>override this.GetSchemaAsync : string * string[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.DataTable>Public Function GetSchemaAsync (collectionName As String, restrictionValues As String(), Optional cancellationToken As CancellationToken = Nothing) As Task(Of DataTable)Public Overrides Function GetSchemaAsync (collectionName As String, restrictionValues As String(), Optional cancellationToken As CancellationToken = Nothing) As Task(Of DataTable)Parámetros
- collectionName
- String
Especifica el nombre del esquema que se va a devolver.
- restrictionValues
- String[]
Conjunto de valores de restricción para el esquema solicitado.
- cancellationToken
- CancellationToken
Token de cancelación.
Devoluciones
Tarea que representa la operación asincrónica.
Excepciones
collectionName se especifica como null.
Comentarios
El restrictionValues parámetro puede proporcionar n profundidad de valores, que especifica la colección de restricciones para una colección específica. Para establecer valores en una restricción determinada y no establecer los valores de otras restricciones, debe establecer las restricciones null anteriores en y, a continuación, colocar el valor adecuado en para la restricción para la que desea especificar un valor.
Un ejemplo de esto es la colección "Tables". Si la colección "Tables" tiene tres restricciones:-base de datos, propietario y nombre de tabla- y desea recuperar solo las tablas asociadas con el propietario "Carl", debe pasar los siguientes valores: null, "Carl". Si no se pasa un valor de restricción, los valores predeterminados se usan para esa restricción. Esta es la misma asignación que pasar null, que es diferente de pasar una cadena vacía para el valor del parámetro. En ese caso, la cadena vacía ("") se considera el valor del parámetro especificado.