DigitalTwinsClient.UpdateComponentAsync Methode

Referenz

Definition

Namespace:: Azure.DigitalTwins.Core

Assembly:: Azure.DigitalTwins.Core.dll

Paket:: Azure.DigitalTwins.Core v1.4.0

Source:: DigitalTwinsClient.cs

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.

Updates Eigenschaften einer Komponente für einen digitalen Zwilling asynchron.

public virtual System.Threading.Tasks.Task<Azure.Response> UpdateComponentAsync (string digitalTwinId, string componentName, Azure.JsonPatchDocument jsonPatchDocument, Azure.ETag? ifMatch = default, System.Threading.CancellationToken cancellationToken = default);

abstract member UpdateComponentAsync : string * string * Azure.JsonPatchDocument * Nullable<Azure.ETag> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>
override this.UpdateComponentAsync : string * string * Azure.JsonPatchDocument * Nullable<Azure.ETag> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>

Public Overridable Function UpdateComponentAsync (digitalTwinId As String, componentName As String, jsonPatchDocument As JsonPatchDocument, Optional ifMatch As Nullable(Of ETag) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response)

Parameter

digitalTwinId: String

Die ID des digitalen Zwillings.

componentName: String

Die Komponente, die geändert wird.

jsonPatchDocument: JsonPatchDocument

Die application/json-patch+json-Vorgänge, die für die Komponente des angegebenen digitalen Zwillings ausgeführt werden sollen.

ifMatch: Nullable<ETag>

Optional. Führen Sie den Vorgang nur aus, wenn das ETag der Entität mit diesem optionalen ETag oder * (All) übereinstimmt.

cancellationToken: CancellationToken

Das Abbruchtoken.

Gibt zurück

Task<Response>

Die HTTP-Antwort Response<T>. Dieses Antwortobjekt enthält einen HTTP-Header, mit dem Sie das aktualisierte ETag für diese Ressource erhalten.

Ausnahmen

RequestFailedException

Die Ausnahme, die die Fehler des Diensts erfasst. Weitere Details finden Sie in den ErrorCode Eigenschaften und Status .

Beispiele

// Update Component1 by replacing the property ComponentProp1 value,
// using an optional utility to build the payload.
var componentJsonPatchDocument = new JsonPatchDocument();
componentJsonPatchDocument.AppendReplace("/ComponentProp1", "Some new value");
await client.UpdateComponentAsync(basicDtId, "Component1", componentJsonPatchDocument);
Console.WriteLine($"Updated component for digital twin '{basicDtId}'.");

Hinweise

Weitere Beispiele finden Sie in unseren Repositorybeispielen.

Gilt für:

Weitere Informationen

UpdateComponent(String, String, JsonPatchDocument, Nullable<ETag>, CancellationToken)

Freigeben über