TransactionalBatch.ExecuteAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| ExecuteAsync(CancellationToken) |
Führt den Transaktionsbatch im Azure Cosmos-Dienst als asynchronen Vorgang aus. |
| ExecuteAsync(TransactionalBatchRequestOptions, CancellationToken) |
Führt den Transaktionsbatch im Azure Cosmos-Dienst als asynchronen Vorgang aus. |
ExecuteAsync(CancellationToken)
- Quelle:
- TransactionalBatch.cs
Führt den Transaktionsbatch im Azure Cosmos-Dienst als asynchronen Vorgang aus.
public abstract System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.TransactionalBatchResponse> ExecuteAsync (System.Threading.CancellationToken cancellationToken = default);abstract member ExecuteAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.TransactionalBatchResponse>Public MustOverride Function ExecuteAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of TransactionalBatchResponse)Parameter
- cancellationToken
- CancellationToken
(Optional) Abbruchtoken, das die Anforderungsabbruch darstellt.
Gibt zurück
Eine erwartbare Antwort, die Details zur Ausführung des Transaktionsbatches enthält.
Wenn der Transaktionsbatch erfolgreich ausgeführt wird, wird für die StatusCode zurückgegebene Antwort auf OKfestgelegt.
Wenn bei einem Vorgang innerhalb des Transaktionsbatches während der Ausführung ein Fehler auftritt, werden keine Änderungen des Batches committet, und die status des fehlerhaften Vorgangs wird in verfügbar StatusCodegemacht. Um weitere Details zum fehlgeschlagenen Vorgang zu erhalten, kann die Antwort aufgelistet werden. Dadurch werden Instanzen zurückgegeben TransactionalBatchOperationResult , die den einzelnen Vorgängen im Transaktionsbatch in der Reihenfolge entsprechen, in der sie dem Transaktionsbatch hinzugefügt wurden. Für ein Ergebnis, das einem Vorgang innerhalb des Transaktionsbatches entspricht, gibt das den StatusCode status des Vorgangs an. Wenn der Vorgang nicht ausgeführt wurde oder aufgrund des Fehlers eines anderen Vorgangs innerhalb des Transaktionsbatches abgebrochen wurde, lautet der Wert dieses Felds HTTP 424 (Fehlerabhängigkeit); für den Vorgang, der den Batch zum Abbrechen veranlasst hat, Der Wert dieses Felds gibt die Fehlerursache als HTTP-status Code an.
Die StatusCode für die zurückgegebene Antwort kann auch Werte wie HTTP 5xx bei Serverfehlern und HTTP 429 (Zu viele Anforderungen) aufweisen.
Hinweise
Diese API löst nur clientseitige Ausnahmen aus. Dies dient dazu, die Leistung zu steigern und den Mehraufwand für das Auslösen von Ausnahmen zu verhindern. Verwenden Sie IsSuccessStatusCode für die zurückgegebene Antwort, um sicherzustellen, dass der Transaktionsbatch erfolgreich war. Grenzwerte für TransactionalBatch-Anforderungen
Gilt für:
ExecuteAsync(TransactionalBatchRequestOptions, CancellationToken)
- Quelle:
- TransactionalBatch.cs
Führt den Transaktionsbatch im Azure Cosmos-Dienst als asynchronen Vorgang aus.
public abstract System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.TransactionalBatchResponse> ExecuteAsync (Microsoft.Azure.Cosmos.TransactionalBatchRequestOptions requestOptions, System.Threading.CancellationToken cancellationToken = default);abstract member ExecuteAsync : Microsoft.Azure.Cosmos.TransactionalBatchRequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.TransactionalBatchResponse>Public MustOverride Function ExecuteAsync (requestOptions As TransactionalBatchRequestOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of TransactionalBatchResponse)Parameter
- requestOptions
- TransactionalBatchRequestOptions
Optionen, die speziell für Batchanforderungen gelten.
- cancellationToken
- CancellationToken
(Optional) Abbruchtoken, das die Anforderungsabbruch darstellt.
Gibt zurück
Eine erwartbare Antwort, die Details zur Ausführung des Transaktionsbatches enthält.
Wenn der Transaktionsbatch erfolgreich ausgeführt wird, wird für die StatusCode zurückgegebene Antwort auf OKfestgelegt.
Wenn bei einem Vorgang innerhalb des Transaktionsbatches während der Ausführung ein Fehler auftritt, werden keine Änderungen des Batches committet, und die status des fehlerhaften Vorgangs wird in verfügbar StatusCodegemacht. Um weitere Details zum fehlgeschlagenen Vorgang zu erhalten, kann die Antwort aufgelistet werden. Dadurch werden Instanzen zurückgegeben TransactionalBatchOperationResult , die den einzelnen Vorgängen im Transaktionsbatch in der Reihenfolge entsprechen, in der sie dem Transaktionsbatch hinzugefügt wurden. Für ein Ergebnis, das einem Vorgang innerhalb des Transaktionsbatches entspricht, gibt das den StatusCode status des Vorgangs an. Wenn der Vorgang nicht ausgeführt wurde oder aufgrund des Fehlers eines anderen Vorgangs innerhalb des Transaktionsbatches abgebrochen wurde, lautet der Wert dieses Felds HTTP 424 (Fehlerabhängigkeit); für den Vorgang, der den Batch zum Abbrechen veranlasst hat, Der Wert dieses Felds gibt die Fehlerursache als HTTP-status Code an.
Die StatusCode für die zurückgegebene Antwort kann auch Werte wie HTTP 5xx bei Serverfehlern und HTTP 429 (Zu viele Anforderungen) aufweisen.
Hinweise
Diese API löst nur clientseitige Ausnahmen aus. Dies dient dazu, die Leistung zu steigern und den Mehraufwand für das Auslösen von Ausnahmen zu verhindern. Verwenden Sie IsSuccessStatusCode für die zurückgegebene Antwort, um sicherzustellen, dass der Transaktionsbatch erfolgreich war. Grenzwerte für TransactionalBatch-Anforderungen
Gilt für:
Azure SDK for .NET