Compartir a través de

DigitalTwinsClient.GetRelationshipsAsync<T> Método

  • Referencia

Definición

Espacio de nombres:
Azure.DigitalTwins.Core
Ensamblado:
Azure.DigitalTwins.Core.dll
Paquete:
Azure.DigitalTwins.Core v1.4.0
Source:
DigitalTwinsClient.cs

Obtiene todas las relaciones de un gemelo digital mediante la iteración de una colección de forma asincrónica.

public virtual Azure.AsyncPageable<T> GetRelationshipsAsync<T>(string digitalTwinId, string relationshipName = default, System.Threading.CancellationToken cancellationToken = default);
abstract member GetRelationshipsAsync : string * string * System.Threading.CancellationToken -> Azure.AsyncPageable<'T>
override this.GetRelationshipsAsync : string * string * System.Threading.CancellationToken -> Azure.AsyncPageable<'T>
Public Overridable Function GetRelationshipsAsync(Of T) (digitalTwinId As String, Optional relationshipName As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As AsyncPageable(Of T)

Parámetros de tipo

T

Tipo al que se va a deserializar la relación.

Parámetros

digitalTwinId
String

Identificador del gemelo digital de origen.

relationshipName
String

Nombre de una relación a la que se va a filtrar. Si es null, se devolverán todas las relaciones del gemelo digital.

cancellationToken
CancellationToken

Token de cancelación.

Devoluciones

AsyncPageable<T>

Lista paginable AsyncPageable<T> de relaciones application/json que pertenecen al gemelo digital especificado y a la respuesta HTTP.

Excepciones

RequestFailedException

Excepción que captura los errores del servicio. Consulte las ErrorCode propiedades y Status para obtener más detalles.

ArgumentNullException

La excepción se produce cuando digitalTwinId es null.

Ejemplos

En este ejemplo se muestra la iteración de las relaciones salientes y la deserialización de cadenas de relación en objetos BasicRelationship.

AsyncPageable<BasicRelationship> relationships = client.GetRelationshipsAsync<BasicRelationship>("buildingTwinId");
await foreach (BasicRelationship relationship in relationships)
{
    Console.WriteLine($"Retrieved relationship '{relationship.Id}' with source {relationship.SourceId}' and " +
        $"target {relationship.TargetId}.\n\t" +
        $"Prop1: {relationship.Properties["Prop1"]}\n\t" +
        $"Prop2: {relationship.Properties["Prop2"]}");
}

Comentarios

Las relaciones que se devuelven como parte de la lista paginable siempre se pueden deserializar en una instancia de BasicRelationship. También puede deserializar la relación en un tipo personalizado que extienda .BasicRelationship

Para obtener más ejemplos, consulte nuestros ejemplos de repositorio.

Se aplica a

Consulte también