ISettingsService.InitAsync Méthode

Définition

Surcharges

InitAsync(String, String)
InitAsync(String, String, Guid)
InitAsync(String, Boolean, Int32, String, Guid, String)

Initialise le service. Doit être appelé une seule fois par connexion cliente, avant les autres méthodes.

InitAsync(String, String)

public System.Threading.Tasks.Task InitAsync (string collectionName, string telemetrySettings = default);
abstract member InitAsync : string * string -> System.Threading.Tasks.Task
Public Function InitAsync (collectionName As String, Optional telemetrySettings As String = Nothing) As Task

Paramètres

collectionName
String
telemetrySettings
String

Retours

Task

S’applique à

InitAsync(String, String, Guid)

public System.Threading.Tasks.Task InitAsync (string collectionName, string telemetrySettings = default, Guid clientId = default);
abstract member InitAsync : string * string * Guid -> System.Threading.Tasks.Task
Public Function InitAsync (collectionName As String, Optional telemetrySettings As String = Nothing, Optional clientId As Guid = Nothing) As Task

Paramètres

collectionName
String
telemetrySettings
String
clientId
Guid

Retours

Task

S’applique à

InitAsync(String, Boolean, Int32, String, Guid, String)

Initialise le service. Doit être appelé une seule fois par connexion cliente, avant les autres méthodes.

public System.Threading.Tasks.Task InitAsync (string collectionName, bool isRoamingEnabled, int roamingEnabledRevision, string telemetrySettings = default, Guid clientId = default, string durableClientIdentity = default);
abstract member InitAsync : string * bool * int * string * Guid * string -> System.Threading.Tasks.Task
Public Function InitAsync (collectionName As String, isRoamingEnabled As Boolean, roamingEnabledRevision As Integer, Optional telemetrySettings As String = Nothing, Optional clientId As Guid = Nothing, Optional durableClientIdentity As String = Nothing) As Task

Paramètres

collectionName
String

Collection de paramètres à cibler. Chaque collection est isolée des autres. En général, une instance de client spécifique ciblera un regroupement unique. Dans Visual Studio, la collection correspond au paramètre/rootSuffix du client, ce qui facilite les scénarios tels que l’isolation de la ruche expérimentale pour le développement d’extensions. Doit être non null ; une chaîne vide est OK.

isRoamingEnabled
Boolean

Indique au service s’il faut effectuer la synchronisation avec les paramètres en ligne de l’utilisateur.

roamingEnabledRevision
Int32

Numéro de révision stockée du client pour le paramètre d’itinérance activé. Cela permet d’éviter le remplacement d’une valeur mise à jour plus récente.

telemetrySettings
String

Sortie de ITelemetrySession. SerializeSettings à partir du client.

clientId
Guid

Identificateur du client

durableClientIdentity
String

Identificateur du client, c.-à-d. une instance de devenv

Retours

Task

Exceptions

Levée lorsque cette méthode est appelée plusieurs fois.

S’applique à