RealtimeSessionOptions.RawRepresentationFactory Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un callback responsabile della creazione della rappresentazione non elaborata delle opzioni di sessione da un'implementazione sottostante.
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)
Valore della proprietà
- Attributi
Commenti
L'implementazione sottostante IRealtimeClientSession potrebbe avere una propria rappresentazione delle opzioni. Quando un oggetto SessionUpdateRealtimeClientMessage viene inviato con , RealtimeSessionOptionstale implementazione potrebbe convertire le opzioni fornite in una propria rappresentazione per usarlo durante l'esecuzione dell'operazione. Per le situazioni in cui un consumer sa quale concreto IRealtimeClientSession viene usato e come rappresenta le opzioni, è possibile restituire una nuova istanza del tipo di opzioni specifiche dell'implementazione da questo callback per l'implementazione IRealtimeClientSession da usare, anziché creare una nuova istanza. Tali implementazioni potrebbero modificare ulteriormente l'istanza delle opzioni fornite in base ad altre impostazioni fornite in questa RealtimeSessionOptions istanza o da altri input. Pertanto, è consigliabile non restituire istanze condivise e fare invece che il callback restituisca una nuova istanza in ogni chiamata. Viene in genere usato per impostare un'impostazione specifica dell'implementazione che non è altrimenti esposta dalle proprietà fortemente tipizzate in RealtimeSessionOptions.
A differenza di factory simili in altri tipi di opzioni, questo callback non riceve l'istanza di sessione come parametro perché alcuni provider devono valutarlo prima della creazione della sessione, ad esempio per produrre la configurazione della connessione.