JsonRpc.InvokeCoreAsync 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
InvokeCoreAsync<TResult>(RequestId, String, IReadOnlyList<Object>, CancellationToken)
Appelle la méthode RPC spécifiée.
protected System.Threading.Tasks.Task<TResult> InvokeCoreAsync<TResult> (StreamJsonRpc.RequestId id, string targetName, System.Collections.Generic.IReadOnlyList<object?>? arguments, System.Threading.CancellationToken cancellationToken);
member this.InvokeCoreAsync : StreamJsonRpc.RequestId * string * System.Collections.Generic.IReadOnlyList<obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>
Protected Function InvokeCoreAsync(Of TResult) (id As RequestId, targetName As String, arguments As IReadOnlyList(Of Object), cancellationToken As CancellationToken) As Task(Of TResult)
Paramètres de type
- TResult
Type de retour de méthode RPC.
Paramètres
- id
- RequestId
Identificateur établi par le client qui DOIT contenir une valeur String, Number ou NULL si elle est incluse. S’il n’est pas inclus, il est supposé être une notification.
- targetName
- String
Nom de la méthode à appeler. Ne doit pas être vide ou avoir la valeur null.
- arguments
- IReadOnlyList<Object>
Arguments à passer à la méthode appelée. Ils doivent être sérialisables à l’aide de l’élément sélectionné IJsonRpcMessageFormatter. Si null
, aucun argument n’est passé.
- cancellationToken
- CancellationToken
Jeton dont l’annulation doit signaler au serveur d’arrêter le traitement de cette requête.
Retours
Tâche dont le résultat est la réponse désérialisée du serveur JSON-RPC.
S’applique à
InvokeCoreAsync<TResult>(Nullable<Int32>, String, IReadOnlyList<Object>, CancellationToken)
Appelle la méthode RPC spécifiée
protected virtual System.Threading.Tasks.Task<TResult> InvokeCoreAsync<TResult> (int? id, string targetName, System.Collections.Generic.IReadOnlyList<object> arguments, System.Threading.CancellationToken cancellationToken);
abstract member InvokeCoreAsync : Nullable<int> * string * System.Collections.Generic.IReadOnlyList<obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>
override this.InvokeCoreAsync : Nullable<int> * string * System.Collections.Generic.IReadOnlyList<obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>
Protected Overridable Function InvokeCoreAsync(Of TResult) (id As Nullable(Of Integer), targetName As String, arguments As IReadOnlyList(Of Object), cancellationToken As CancellationToken) As Task(Of TResult)
Paramètres de type
- TResult
Type de retour de méthode RPC
Paramètres
Identificateur établi par le client qui DOIT contenir une valeur String, Number ou NULL si elle est incluse. S’il n’est pas inclus, il est supposé être une notification.
- targetName
- String
Nom de la méthode à appeler.
- arguments
- IReadOnlyList<Object>
Arguments à passer à la méthode appelée. Si la valeur est Null, aucun argument n’est passé.
- cancellationToken
- CancellationToken
Jeton dont l’annulation doit signaler au serveur d’arrêter le traitement de cette requête.
Retours
Tâche dont le résultat est la réponse désérialisée du serveur JSON-RPC.
S’applique à
InvokeCoreAsync<TResult>(Nullable<Int64>, String, IReadOnlyList<Object>, CancellationToken)
Attention
Use the InvokeCoreAsync(RequestId, ...) overload instead.
Appelle la méthode RPC spécifiée.
protected System.Threading.Tasks.Task<TResult> InvokeCoreAsync<TResult> (long? id, string targetName, System.Collections.Generic.IReadOnlyList<object> arguments, System.Threading.CancellationToken cancellationToken);
[System.Obsolete("Use the InvokeCoreAsync(RequestId, ...) overload instead.")]
protected System.Threading.Tasks.Task<TResult> InvokeCoreAsync<TResult> (long? id, string targetName, System.Collections.Generic.IReadOnlyList<object?>? arguments, System.Threading.CancellationToken cancellationToken);
member this.InvokeCoreAsync : Nullable<int64> * string * System.Collections.Generic.IReadOnlyList<obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>
[<System.Obsolete("Use the InvokeCoreAsync(RequestId, ...) overload instead.")>]
member this.InvokeCoreAsync : Nullable<int64> * string * System.Collections.Generic.IReadOnlyList<obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>
Protected Function InvokeCoreAsync(Of TResult) (id As Nullable(Of Long), targetName As String, arguments As IReadOnlyList(Of Object), cancellationToken As CancellationToken) As Task(Of TResult)
Paramètres de type
- TResult
Type de retour de méthode RPC.
Paramètres
Identificateur établi par le client qui DOIT contenir une valeur String, Number ou NULL si elle est incluse. S’il n’est pas inclus, il est supposé être une notification.
- targetName
- String
Nom de la méthode à appeler. Ne doit pas être vide ou avoir la valeur null.
- arguments
- IReadOnlyList<Object>
Arguments à passer à la méthode appelée. Ils doivent être sérialisables à l’aide de l’élément sélectionné IJsonRpcMessageFormatter. Si null
, aucun argument n’est passé.
- cancellationToken
- CancellationToken
Jeton dont l’annulation doit signaler au serveur d’arrêter le traitement de cette requête.
Retours
Tâche dont le résultat est la réponse désérialisée du serveur JSON-RPC.
- Attributs
S’applique à
InvokeCoreAsync<TResult>(RequestId, String, IReadOnlyList<Object>, CancellationToken, Boolean)
Appelle la méthode RPC spécifiée.
protected System.Threading.Tasks.Task<TResult> InvokeCoreAsync<TResult> (StreamJsonRpc.RequestId id, string targetName, System.Collections.Generic.IReadOnlyList<object?>? arguments, System.Threading.CancellationToken cancellationToken, bool isParameterObject);
member this.InvokeCoreAsync : StreamJsonRpc.RequestId * string * System.Collections.Generic.IReadOnlyList<obj> * System.Threading.CancellationToken * bool -> System.Threading.Tasks.Task<'Result>
Protected Function InvokeCoreAsync(Of TResult) (id As RequestId, targetName As String, arguments As IReadOnlyList(Of Object), cancellationToken As CancellationToken, isParameterObject As Boolean) As Task(Of TResult)
Paramètres de type
- TResult
Type de retour de méthode RPC.
Paramètres
- id
- RequestId
Identificateur établi par le client. Si la valeur par défaut est donnée, elle est supposée être une notification.
- targetName
- String
Nom de la méthode à appeler.
- arguments
- IReadOnlyList<Object>
Arguments à passer à la méthode appelée. Si la valeur est Null, aucun argument n’est passé.
- cancellationToken
- CancellationToken
Jeton dont l’annulation doit signaler au serveur d’arrêter le traitement de cette requête.
- isParameterObject
- Boolean
Valeur qui indique si le paramètre doit être passé en tant qu’objet.
Retours
Tâche dont le résultat est la réponse désérialisée du serveur JSON-RPC.
S’applique à
InvokeCoreAsync<TResult>(Nullable<Int32>, String, IReadOnlyList<Object>, CancellationToken, Boolean)
Appelle la méthode RPC spécifiée
protected virtual System.Threading.Tasks.Task<TResult> InvokeCoreAsync<TResult> (int? id, string targetName, System.Collections.Generic.IReadOnlyList<object> arguments, System.Threading.CancellationToken cancellationToken, bool isParameterObject);
abstract member InvokeCoreAsync : Nullable<int> * string * System.Collections.Generic.IReadOnlyList<obj> * System.Threading.CancellationToken * bool -> System.Threading.Tasks.Task<'Result>
override this.InvokeCoreAsync : Nullable<int> * string * System.Collections.Generic.IReadOnlyList<obj> * System.Threading.CancellationToken * bool -> System.Threading.Tasks.Task<'Result>
Protected Overridable Function InvokeCoreAsync(Of TResult) (id As Nullable(Of Integer), targetName As String, arguments As IReadOnlyList(Of Object), cancellationToken As CancellationToken, isParameterObject As Boolean) As Task(Of TResult)
Paramètres de type
- TResult
Type de retour de méthode RPC
Paramètres
Identificateur établi par le client qui DOIT contenir une valeur String, Number ou NULL si elle est incluse. S’il n’est pas inclus, il est supposé être une notification.
- targetName
- String
Nom de la méthode à appeler.
- arguments
- IReadOnlyList<Object>
Arguments à passer à la méthode appelée. Si la valeur est Null, aucun argument n’est passé.
- cancellationToken
- CancellationToken
Jeton dont l’annulation doit signaler au serveur d’arrêter le traitement de cette requête.
- isParameterObject
- Boolean
Valeur qui indique si le paramètre doit être passé en tant qu’objet.
Retours
Tâche dont le résultat est la réponse désérialisée du serveur JSON-RPC.
S’applique à
InvokeCoreAsync<TResult>(Nullable<Int64>, String, IReadOnlyList<Object>, CancellationToken, Boolean)
Attention
Use the InvokeCoreAsync(RequestId, ...) overload instead.
Appelle une méthode donnée sur un serveur JSON-RPC.
protected System.Threading.Tasks.Task<TResult> InvokeCoreAsync<TResult> (long? id, string targetName, System.Collections.Generic.IReadOnlyList<object> arguments, System.Threading.CancellationToken cancellationToken, bool isParameterObject);
[System.Obsolete("Use the InvokeCoreAsync(RequestId, ...) overload instead.")]
protected System.Threading.Tasks.Task<TResult> InvokeCoreAsync<TResult> (long? id, string targetName, System.Collections.Generic.IReadOnlyList<object?>? arguments, System.Threading.CancellationToken cancellationToken, bool isParameterObject);
member this.InvokeCoreAsync : Nullable<int64> * string * System.Collections.Generic.IReadOnlyList<obj> * System.Threading.CancellationToken * bool -> System.Threading.Tasks.Task<'Result>
[<System.Obsolete("Use the InvokeCoreAsync(RequestId, ...) overload instead.")>]
member this.InvokeCoreAsync : Nullable<int64> * string * System.Collections.Generic.IReadOnlyList<obj> * System.Threading.CancellationToken * bool -> System.Threading.Tasks.Task<'Result>
Protected Function InvokeCoreAsync(Of TResult) (id As Nullable(Of Long), targetName As String, arguments As IReadOnlyList(Of Object), cancellationToken As CancellationToken, isParameterObject As Boolean) As Task(Of TResult)
Paramètres de type
- TResult
Type de retour de méthode RPC.
Paramètres
Identificateur établi par le client. Si la valeur par défaut est donnée, elle est supposée être une notification.
- targetName
- String
Nom de la méthode à appeler. Ne doit pas être vide ou avoir la valeur null.
- arguments
- IReadOnlyList<Object>
Arguments à passer à la méthode appelée. Ils doivent être sérialisables à l’aide de l’élément sélectionné IJsonRpcMessageFormatter. Si null
, aucun argument n’est passé.
- cancellationToken
- CancellationToken
Jeton dont l’annulation doit signaler au serveur d’arrêter le traitement de cette requête.
- isParameterObject
- Boolean
Valeur qui indique si le paramètre doit être passé en tant qu’objet.
Retours
Tâche dont le résultat est la réponse désérialisée du serveur JSON-RPC.
- Attributs
S’applique à
InvokeCoreAsync<TResult>(RequestId, String, IReadOnlyList<Object>, IReadOnlyList<Type>, IReadOnlyDictionary<String,Type>, CancellationToken, Boolean)
Appelle une méthode donnée sur un serveur JSON-RPC.
protected System.Threading.Tasks.Task<TResult> InvokeCoreAsync<TResult> (StreamJsonRpc.RequestId id, string targetName, System.Collections.Generic.IReadOnlyList<object?>? arguments, System.Collections.Generic.IReadOnlyList<Type>? positionalArgumentDeclaredTypes, System.Collections.Generic.IReadOnlyDictionary<string,Type>? namedArgumentDeclaredTypes, System.Threading.CancellationToken cancellationToken, bool isParameterObject);
member this.InvokeCoreAsync : StreamJsonRpc.RequestId * string * System.Collections.Generic.IReadOnlyList<obj> * System.Collections.Generic.IReadOnlyList<Type> * System.Collections.Generic.IReadOnlyDictionary<string, Type> * System.Threading.CancellationToken * bool -> System.Threading.Tasks.Task<'Result>
Protected Function InvokeCoreAsync(Of TResult) (id As RequestId, targetName As String, arguments As IReadOnlyList(Of Object), positionalArgumentDeclaredTypes As IReadOnlyList(Of Type), namedArgumentDeclaredTypes As IReadOnlyDictionary(Of String, Type), cancellationToken As CancellationToken, isParameterObject As Boolean) As Task(Of TResult)
Paramètres de type
- TResult
Type de retour de méthode RPC.
Paramètres
- id
- RequestId
Identificateur établi par le client. Si la valeur par défaut est donnée, elle est supposée être une notification.
- targetName
- String
Nom de la méthode à appeler. Ne doit pas être vide ou avoir la valeur null.
- arguments
- IReadOnlyList<Object>
Arguments à passer à la méthode appelée. Ils doivent être sérialisables à l’aide de l’élément sélectionné IJsonRpcMessageFormatter. Si null
, aucun argument n’est passé.
- positionalArgumentDeclaredTypes
- IReadOnlyList<Type>
Liste d’objets Type qui décrivent comment chaque élément est arguments
attendu par le serveur à taper.
Si spécifié, cela doit avoir exactement la même longueur que arguments
et ne contenir aucun null
élément.
Cette valeur est ignorée quand isParameterObject
elle est true.
- namedArgumentDeclaredTypes
- IReadOnlyDictionary<String,Type>
Dictionnaire d’objets Type qui décrivent comment chaque entrée dans l’élément IReadOnlyDictionary<TKey,TValue> fourni dans le seul élément attendu arguments
par le serveur doit être typée.
Si spécifié, cela doit avoir exactement le même jeu de clés que le dictionnaire contenu dans le premier élément de arguments
, et ne contenir aucune null
valeur.
- cancellationToken
- CancellationToken
Jeton dont l’annulation doit signaler au serveur d’arrêter de traiter cette demande.
- isParameterObject
- Boolean
Valeur qui indique si le paramètre doit être transmis en tant qu’objet.
Retours
Tâche qui se termine avec la réponse du serveur JSON-RPC.
Exceptions
Levée après cancellationToken
l’annulation.
Si la demande a déjà été transmise, l’exception est levée uniquement une fois que le serveur a reçu la notification d’annulation et y a répondu.
Si le serveur termine la demande au lieu de l’annuler, cette exception n’est pas levée.
Lorsque la connexion tombe avant de recevoir une réponse, cette exception est levée si cancellationToken
elle a été annulée.
Classe de base commune pour diverses exceptions RPC qui peuvent être levées. Certains types dérivés courants sont répertoriés individuellement.
Levée lorsqu’une erreur est retournée par le serveur en conséquence de l’exécution de la méthode demandée.
Levée lorsque le serveur signale qu’aucune méthode correspondante n’a été trouvée pour appeler.
Si targetName
la valeur est Null.
Levée lorsqu’elle targetName
est vide.
Si cette instance a JsonRpc déjà été supprimée avant cet appel.
Levée lorsque la connexion est terminée (de l’un ou l’autre côté) avant la demande ou pendant que la demande est en cours, sauf si cancellationToken
elle est déjà signalée.
Toute exception levée par le IJsonRpcMessageFormatter (généralement en raison d’échecs de sérialisation). Lors de l’utilisation JsonMessageFormatter de ce fichier doit être Newtonsoft.Json.JsonSerializationException. Lors de l’utilisation MessagePackFormatter de ce fichier doit être MessagePack.MessagePackSerializationException.