IDocumentClient.CreateDatabaseIfNotExistsAsync 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í.
Crea (si no existe) u obtiene (si ya existe) un recurso de base de datos como una operación asincrónica en el servicio Azure Cosmos DB. Puede comprobar el código de estado de la respuesta para determinar si se devolvió la base de datos recién creada (201) o la base de datos existente(200).
public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Database>> CreateDatabaseIfNotExistsAsync (Microsoft.Azure.Documents.Database database, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member CreateDatabaseIfNotExistsAsync : Microsoft.Azure.Documents.Database * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Database>>
Public Function CreateDatabaseIfNotExistsAsync (database As Database, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of Database))
Parámetros
- options
- RequestOptions
(Opcional) para RequestOptions la solicitud.
Devoluciones
Database que se creó dentro de un objeto de tarea que representa la respuesta del servicio para la operación asincrónica.
Excepciones
Si database
no se establece.
Representa una consolidación de errores que se produjeron durante el procesamiento asincrónico. Busque en InnerExceptions para buscar las excepciones reales.
Esta excepción puede encapsular muchos tipos diferentes de errores. Para determinar el error específico, examine siempre la propiedad StatusCode.
Ejemplos
En el ejemplo siguiente se crea un nuevo Database con una propiedad Id de "MyDatabase" Este fragmento de código está diseñado para usarse desde dentro de un método asincrónico, ya que usa la palabra clave await.
using (IDocumentClient client = new DocumentClient(new Uri("service endpoint"), "auth key"))
{
Database db = await client.CreateDatabaseIfNotExistsAsync(new Database { Id = "MyDatabase" });
}
Si desea construir un Database desde dentro de un método sincrónico, debe usar el código siguiente.
using (IDocumentClient client = new DocumentClient(new Uri("service endpoint"), "auth key"))
{
Database db = client.CreateDatabaseIfNotExistsAsync(new Database { Id = "MyDatabase" }).Result;
}
Se aplica a
Consulte también
Azure SDK for .NET
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de