DigitalTwinsClient.CreateOrReplaceDigitalTwinAsync<T> 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.

Erstellt asynchron einen digitalen Zwilling. Wenn die bereitgestellte digitale Zwillings-ID bereits verwendet wird, wird versucht, den vorhandenen digitalen Zwilling durch den bereitgestellten digitalen Zwilling zu ersetzen.

public virtual System.Threading.Tasks.Task<Azure.Response<T>> CreateOrReplaceDigitalTwinAsync<T> (string digitalTwinId, T digitalTwin, Azure.ETag? ifNoneMatch = default, System.Threading.CancellationToken cancellationToken = default);

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

Public Overridable Function CreateOrReplaceDigitalTwinAsync(Of T) (digitalTwinId As String, digitalTwin As T, Optional ifNoneMatch As Nullable(Of ETag) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of T))

Typparameter

T

Der Typ, in den der digitale Zwilling deserialisiert werden soll.

Parameter

digitalTwinId: String

Die ID des digitalen Zwillings.

digitalTwin: T

Der zu erstellende digitale Zwilling anwendung/json.

ifNoneMatch: Nullable<ETag>

If-None-Match-Header, der die Anforderungsmethode davon abhängig macht, dass ein Empfängercache oder Ursprungsserver keine aktuelle Darstellung der Zielressource aufweist. Weitere Informationen zu dieser Eigenschaft finden Sie unter RFC 7232. Zulässige Werte sind NULL oder "". Wenn die Option ifNonMatch NULL ist, ersetzt der Dienst die vorhandene Entität durch die neue Entität. Wenn die IfNoneMatch-Option "" (oder All) ist, lehnt der Dienst die Anforderung ab, wenn die Entität bereits vorhanden ist. Ein optionales ETag, um die Anforderung nur dann zu stellen, wenn der Wert nicht mit dem Dienst übereinstimmt.

cancellationToken: CancellationToken

Das Abbruchtoken.

Gibt zurück

Task<Response<T>>

Der erstellte digitale Zwilling anwendung/json und die HTTP-Antwort Response<T>.

Ausnahmen

RequestFailedException

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

ArgumentNullException

Die Ausnahme wird ausgelöst, wenn digitalTwinId oder digitalTwin ist null.

Beispiele

var customTwin = new CustomDigitalTwin
{
    Id = customDtId,
    Metadata = { ModelId = modelId },
    Prop1 = "Prop1 val",
    Prop2 = 987,
    Component1 = new MyCustomComponent
    {
        ComponentProp1 = "Component prop1 val",
        ComponentProp2 = 123,
    },
};
Response<CustomDigitalTwin> createCustomDigitalTwinResponse = await client.CreateOrReplaceDigitalTwinAsync(customDtId, customTwin);
Console.WriteLine($"Created digital twin '{createCustomDigitalTwinResponse.Value.Id}'.");

Hinweise

Weitere Beispiele finden Sie in unseren Repositorybeispielen.

Gilt für:

Freigeben über