Freigeben über

DigitalTwinsClient.CreateOrReplaceRelationship<T> Methode

  • Referenz

Definition

Namespace:
Azure.DigitalTwins.Core
Assembly:
Azure.DigitalTwins.Core.dll
Paket:
Azure.DigitalTwins.Core v1.4.0
Source:
DigitalTwinsClient.cs

Erstellt synchron 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 Azure.Response<T> CreateOrReplaceRelationship<T> (string digitalTwinId, string relationshipId, T relationship, Azure.ETag? ifNoneMatch = default, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateOrReplaceRelationship : string * string * 'T * Nullable<Azure.ETag> * System.Threading.CancellationToken -> Azure.Response<'T>
override this.CreateOrReplaceRelationship : string * string * 'T * Nullable<Azure.ETag> * System.Threading.CancellationToken -> Azure.Response<'T>
Public Overridable Function CreateOrReplaceRelationship(Of T) (digitalTwinId As String, relationshipId As String, relationship As T, Optional ifNoneMatch As Nullable(Of ETag) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Response(Of T)

Typparameter

T

Der Typ, zu dem die Beziehung deserialisiert werden soll.

Parameter

digitalTwinId
String

Die ID des digitalen Quellzwillens.

relationshipId
String

Die ID der zu löschenden Beziehung.

relationship
T

Die zu erstellende Anwendungs-JSON-Beziehung.

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

Response<T>

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

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