Container.ReadItemAsync<T> Methode

Definition

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:

StatusCodeAusnahmegrund
429TooManyRequests: 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 Tabgerufen 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: