RealtimeSessionOptions.RawRepresentationFactory Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene una devolución de llamada responsable de crear la representación sin procesar de las opciones de sesión a partir de una implementación subyacente.
public:
property Func<System::Object ^> ^ RawRepresentationFactory { Func<System::Object ^> ^ get(); void set(Func<System::Object ^> ^ value); };[System.Text.Json.Serialization.JsonIgnore]
public Func<object?>? RawRepresentationFactory { get; init; }[<System.Text.Json.Serialization.JsonIgnore>]
member this.RawRepresentationFactory : Func<obj> with get, setPublic Property RawRepresentationFactory As Func(Of Object)Valor de propiedad
- Atributos
Comentarios
La implementación subyacente IRealtimeClientSession puede tener su propia representación de opciones. Cuando se envía con SessionUpdateRealtimeClientMessage un RealtimeSessionOptions, esa implementación puede convertir las opciones proporcionadas en su propia representación para usarla mientras realiza la operación. En situaciones en las que un consumidor sabe qué concreto IRealtimeClientSession se está usando y cómo representa las opciones, esta devolución de llamada IRealtimeClientSession puede devolver una nueva instancia de ese tipo de opciones específica de la implementación, en lugar de crear una nueva instancia. Estas implementaciones pueden mutar aún más la instancia de opciones proporcionada en función de otras opciones proporcionadas en esta RealtimeSessionOptions instancia o de otras entradas. Por lo tanto, se recomienda encarecidamente no devolver instancias compartidas y, en su lugar, hacer que la devolución de llamada devuelva una nueva instancia en cada llamada. Normalmente se usa para establecer una configuración específica de la implementación que no se expone de las propiedades fuertemente tipadas en RealtimeSessionOptions.
A diferencia de las factorías similares en otros tipos de opciones, esta devolución de llamada no recibe la instancia de sesión como parámetro porque algunos proveedores deben evaluarla antes de crear la sesión (por ejemplo, para generar la configuración de conexión).
