RealtimeSessionOptions.RawRepresentationFactory Propriété
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.
Obtient un rappel responsable de la création de la représentation brute des options de session à partir d’une implémentation sous-jacente.
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)
Valeur de propriété
- Attributs
Remarques
L’implémentation sous-jacente IRealtimeClientSession peut avoir sa propre représentation des options. Lorsqu’une SessionUpdateRealtimeClientMessage application est envoyée avec un RealtimeSessionOptions, cette implémentation peut convertir les options fournies en sa propre représentation afin de l’utiliser lors de l’exécution de l’opération. Pour les situations où un consommateur sait quel béton IRealtimeClientSession est utilisé et comment il représente des options, une nouvelle instance de ce type d’options spécifiques à l’implémentation peut être retournée par ce rappel pour que l’implémentation IRealtimeClientSession utilise, au lieu de créer une nouvelle instance. Ces implémentations peuvent muter l’instance d’options fournies en fonction d’autres paramètres fournis sur cette RealtimeSessionOptions instance ou d’autres entrées. Par conséquent, il est fortement recommandé de ne pas retourner d’instances partagées et de retourner à la place un nouveau rappel sur chaque appel. Il est généralement utilisé pour définir un paramètre spécifique à l’implémentation qui n’est pas exposé autrement à partir des propriétés fortement typées sur RealtimeSessionOptions.
Contrairement aux fabriques similaires sur d’autres types d’options, ce rappel ne reçoit pas l’instance de session en tant que paramètre, car certains fournisseurs doivent l’évaluer avant la création de la session (par exemple, pour produire une configuration de connexion).