RealtimeSessionOptions.RawRepresentationFactory Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém um retorno de chamada responsável por criar a representação bruta das opções de sessão de uma implementação subjacente.
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, set
Public Property RawRepresentationFactory As Func(Of Object)
Valor da propriedade
- Atributos
Comentários
A implementação subjacente IRealtimeClientSession pode ter sua própria representação de opções. Quando um SessionUpdateRealtimeClientMessage é enviado com uma RealtimeSessionOptionsimplementação, essa implementação pode converter as opções fornecidas em sua própria representação para usá-la durante a execução da operação. Para situações em que um consumidor sabe qual concreto IRealtimeClientSession está sendo usado e como ele representa opções, uma nova instância desse tipo de opções específicas de implementação pode ser retornada por esse retorno de chamada para a IRealtimeClientSession implementação a ser usada, em vez de criar uma nova instância. Essas implementações podem alterar ainda mais a instância de opções fornecidas com base em outras configurações fornecidas nesta RealtimeSessionOptions instância ou em outras entradas. Portanto, é altamente recomendável não retornar instâncias compartilhadas e, em vez disso, fazer com que o retorno de chamada retorne uma nova instância em cada chamada. Normalmente, isso é usado para definir uma configuração específica da implementação que não é exposta de outra forma das propriedades fortemente tipadas.RealtimeSessionOptions
Ao contrário de fábricas semelhantes em outros tipos de opções, esse retorno de chamada não recebe a instância de sessão como um parâmetro porque alguns provedores precisam avaliá-la antes que a sessão seja criada (por exemplo, para produzir a configuração de conexão).