Container.ReadItemAsync<T> 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.
Liest ein Element aus dem Azure Cosmos-Dienst als asynchronen Vorgang.
public abstract System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.ItemResponse<T>> ReadItemAsync<T> (string id, Microsoft.Azure.Cosmos.PartitionKey partitionKey, Microsoft.Azure.Cosmos.ItemRequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);
abstract member ReadItemAsync : string * Microsoft.Azure.Cosmos.PartitionKey * Microsoft.Azure.Cosmos.ItemRequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.ItemResponse<'T>>
Public MustOverride Function ReadItemAsync(Of T) (id As String, partitionKey As PartitionKey, Optional requestOptions As ItemRequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ItemResponse(Of T))
Typparameter
- T
Parameter
- id
- String
Die Cosmos-Element-ID
- partitionKey
- PartitionKey
Der Partitionsschlüssel für das Element.
- requestOptions
- ItemRequestOptions
(Optional) Die Optionen für die Elementanforderung.
- cancellationToken
- CancellationToken
(Optional) CancellationToken stellt die Anforderungsabbruch dar.
Gibt zurück
Eine Task , die einen ItemResponse<T> enthält, der den Leseressourcendatensatz umschließt.
Ausnahmen
Diese Ausnahme kann viele verschiedene Fehlertypen kapseln. Um den spezifischen Fehler zu ermitteln, sehen Sie sich immer die StatusCode-Eigenschaft an. Einige häufige Codes, die Sie beim Erstellen eines Dokuments erhalten, sind:
StatusCode | Ausnahmegrund |
---|---|
429 | TooManyRequests: Dies bedeutet, dass Sie die Anzahl der Anforderungseinheiten pro Sekunde überschritten haben. |
Beispiele
public class ToDoActivity{
public string id {get; set;}
public string status {get; set;}
}
ToDoActivity toDoActivity = await this.container.ReadItemAsync<ToDoActivity>("id", new PartitionKey("partitionKey"));
Hinweise
Elemente enthalten Metadaten, die durch Zuordnung dieser Metadatenattribute zu Eigenschaften in T
abgerufen werden können. * "_ts": Ruft den dem Element zugeordneten Zeitstempel der letzten Änderung aus dem Azure Cosmos DB-Dienst ab. * "_etag": Ruft das Entitätstag ab, das dem Element aus dem Azure Cosmos DB-Dienst zugeordnet ist. * "ttl": Ruft die Laufzeit des Elements im Azure Cosmos DB-Dienst in Sekunden ab.
Gilt für:
Azure SDK for .NET