DigitalTwinsClient.CreateOrReplaceRelationshipAsync<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 eine Beziehung zu einem digitalen Zwilling. Wenn die angegebene Beziehungs-ID bereits verwendet wird, wird versucht, die vorhandene Beziehung durch die bereitgestellte Beziehung zu ersetzen.

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

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

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

Typparameter

T

Der Typ, mit dem die Beziehung deserialisiert werden soll.

Parameter

digitalTwinId: String

Die ID des digitalen Quellzwillens.

relationshipId: String

Die ID der Beziehung, die erstellt wird.

relationship: T

Die zu erstellende Anwendungs-/JSON-Beziehung.

ifNoneMatch: Nullable<ETag>

If-None-Match-Header, der die Anforderungsmethode für einen Empfängercache oder Ursprungsserver abhängig macht, der 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 Option ifNoneMatch auf "" (oder All) festgelegt 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>>

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 relationshipId ist null.

Beispiele

var floorBuildingRelationshipPayload = new CustomRelationship
{
    Id = "floorBuildingRelationshipId",
    SourceId = "floorTwinId",
    TargetId = "buildingTwinId",
    Name = "containedIn",
    Prop1 = "Prop1 val",
    Prop2 = 4
};

Response<CustomRelationship> createCustomRelationshipResponse = await client
    .CreateOrReplaceRelationshipAsync<CustomRelationship>("floorTwinId", "floorBuildingRelationshipId", floorBuildingRelationshipPayload);
Console.WriteLine($"Created a digital twin relationship '{createCustomRelationshipResponse.Value.Id}' " +
    $"from twin '{createCustomRelationshipResponse.Value.SourceId}' to twin '{createCustomRelationshipResponse.Value.TargetId}'.");

Hinweise

Beziehungen sind eine unidirektionale Verknüpfung von einem digitalen Quellzwillen zu einem anderen, wie bei der Erstellung des zugewiesenen Modells des digitalen Zwillings beschrieben.

Weitere Beispiele finden Sie in unseren Repositorybeispielen.

Gilt für:

Weitere Informationen

CreateOrReplaceRelationship<T>(String, String, T, Nullable<ETag>, CancellationToken)

Freigeben über