ISettingsService.InitAsync Méthode
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.
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
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
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
Exceptions
Levée lorsque cette méthode est appelée plusieurs fois.