DigitalTwinsClient.GetRelationshipAsync<T> Method

Reference

Definition

Namespace:: Azure.DigitalTwins.Core

Assembly:: Azure.DigitalTwins.Core.dll

Package:: Azure.DigitalTwins.Core v1.4.0

Source:: DigitalTwinsClient.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets a relationship on a digital twin asynchronously.

public virtual System.Threading.Tasks.Task<Azure.Response<T>> GetRelationshipAsync<T> (string digitalTwinId, string relationshipId, System.Threading.CancellationToken cancellationToken = default);

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

Public Overridable Function GetRelationshipAsync(Of T) (digitalTwinId As String, relationshipId As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of T))

Type Parameters

T

The type to deserialize the relationship to.

Parameters

digitalTwinId: String

The Id of the source digital twin.

relationshipId: String

The Id of the relationship to retrieve.

cancellationToken: CancellationToken

The cancellation token.

Returns

Task<Response<T>>

The deserialized application/json relationship corresponding to the provided relationshipId and the HTTP response Response<T>.

Exceptions

RequestFailedException

The exception that captures the errors from the service. Check the ErrorCode and Status properties for more details.

ArgumentNullException

The exception is thrown when digitalTwinId or relationshipId is null.

Examples

This sample demonstrates getting and deserializing a digital twin relationship into a custom data type.

Response<CustomRelationship> getCustomRelationshipResponse = await client.GetRelationshipAsync<CustomRelationship>(
    "floorTwinId",
    "floorBuildingRelationshipId");
CustomRelationship getCustomRelationship = getCustomRelationshipResponse.Value;
Console.WriteLine($"Retrieved and deserialized relationship '{getCustomRelationship.Id}' from twin '{getCustomRelationship.SourceId}'.\n\t" +
    $"Prop1: {getCustomRelationship.Prop1}\n\t" +
    $"Prop2: {getCustomRelationship.Prop2}");

Remarks

For more samples, see our repo samples.

Applies to

Share via