DigitalTwinsClient.CreateOrReplaceRelationshipAsync<T> Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée une relation sur un jumeau numérique de façon asynchrone. Si l’ID de relation fourni est déjà utilisé, cette opération tente de remplacer la relation existante par la relation fournie.
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))
Paramètres de type
- T
Type auquel désérialiser la relation.
Paramètres
- digitalTwinId
- String
ID du jumeau numérique source.
- relationshipId
- String
ID de la relation en cours de création.
- relationship
- T
Relation application/json à créer.
En-tête If-None-Match qui rend la méthode de requête conditionnelle à un cache de destinataires ou un serveur d’origine n’ayant aucune représentation actuelle de la ressource cible. Pour plus d’informations sur cette propriété, consultez RFC 7232.
Les valeurs acceptables sont null ou ""
. Si l’option ifNonMatch a la valeur Null, le service remplace l’entité existante par la nouvelle entité.
Si l’option ifNoneMatch a la valeur «
»
(ou All), le service rejette la demande si l’entité existe déjà.
ETag facultatif pour effectuer la requête uniquement si la valeur ne correspond pas au service.
- cancellationToken
- CancellationToken
Jeton d'annulation.
Retours
Exceptions
Exception qui capture les erreurs du service. Pour plus d’informations, consultez les ErrorCode propriétés et Status .
L’exception est levée lorsque digitalTwinId
ou relationshipId
a la valeur null
.
Exemples
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}'.");
Remarques
Les relations sont un lien unidirectionnel entre un jumeau numérique source et un autre, comme décrit au moment de la création du modèle affecté du jumeau numérique.
Pour plus d’exemples, consultez nos exemples de dépôt.
S’applique à
Voir aussi
Azure SDK for .NET
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour