JsonRpc.InvokeCoreAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
InvokeCoreAsync<TResult>(RequestId, String, IReadOnlyList<Object>, CancellationToken) |
Vyvolá zadanou metodu RPC. |
InvokeCoreAsync<TResult>(Nullable<Int32>, String, IReadOnlyList<Object>, CancellationToken) |
Vyvolá zadanou metodu RPC. |
InvokeCoreAsync<TResult>(Nullable<Int64>, String, IReadOnlyList<Object>, CancellationToken) |
Zastaralé.
Vyvolá zadanou metodu RPC. |
InvokeCoreAsync<TResult>(RequestId, String, IReadOnlyList<Object>, CancellationToken, Boolean) |
Vyvolá zadanou metodu RPC. |
InvokeCoreAsync<TResult>(Nullable<Int32>, String, IReadOnlyList<Object>, CancellationToken, Boolean) |
Vyvolá zadanou metodu RPC. |
InvokeCoreAsync<TResult>(Nullable<Int64>, String, IReadOnlyList<Object>, CancellationToken, Boolean) |
Zastaralé.
Vyvolá danou metodu na serveru JSON-RPC. |
InvokeCoreAsync<TResult>(RequestId, String, IReadOnlyList<Object>, IReadOnlyList<Type>, IReadOnlyDictionary<String,Type>, CancellationToken, Boolean) |
Vyvolá danou metodu na serveru JSON-RPC. |
InvokeCoreAsync<TResult>(RequestId, String, IReadOnlyList<Object>, CancellationToken)
Vyvolá zadanou metodu RPC.
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)
Parametry typu
- TResult
Návratový typ metody RPC
Parametry
- id
- RequestId
Identifikátor vytvořený klientem, který musí obsahovat hodnotu String, Number nebo NULL, pokud je zahrnuta. Pokud není součástí, předpokládá se, že se jedná o oznámení.
- targetName
- String
Název metody, která se má vyvolat. Nesmí být null ani prázdný.
- arguments
- IReadOnlyList<Object>
Argumenty, které se předávají do vyvolané metody. Musí být serializovatelné pomocí vybrané IJsonRpcMessageFormatter. Pokud null
nejsou předány žádné argumenty.
- cancellationToken
- CancellationToken
Token, jehož zrušení by mělo signalizovat server, aby tento požadavek přestal zpracovávat.
Návraty
Úloha, jejíž výsledkem je deserializovaná odpověď ze serveru JSON-RPC.
Platí pro
InvokeCoreAsync<TResult>(Nullable<Int32>, String, IReadOnlyList<Object>, CancellationToken)
Vyvolá zadanou metodu RPC.
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)
Parametry typu
- TResult
Návratový typ metody RPC
Parametry
Identifikátor vytvořený klientem, který musí obsahovat hodnotu String, Number nebo NULL, pokud je zahrnuta. Pokud není součástí, předpokládá se, že se jedná o oznámení.
- targetName
- String
Název metody, která se má vyvolat.
- arguments
- IReadOnlyList<Object>
Argumenty, které se předávají do vyvolané metody. Pokud je hodnota null, nepředá se žádné argumenty.
- cancellationToken
- CancellationToken
Token, jehož zrušení by mělo signalizovat server, aby tento požadavek přestal zpracovávat.
Návraty
Úloha, jejíž výsledkem je deserializovaná odpověď ze serveru JSON-RPC.
Platí pro
InvokeCoreAsync<TResult>(Nullable<Int64>, String, IReadOnlyList<Object>, CancellationToken)
Upozornění
Use the InvokeCoreAsync(RequestId, ...) overload instead.
Vyvolá zadanou metodu RPC.
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)
Parametry typu
- TResult
Návratový typ metody RPC
Parametry
Identifikátor vytvořený klientem, který musí obsahovat hodnotu String, Number nebo NULL, pokud je zahrnuta. Pokud není součástí, předpokládá se, že se jedná o oznámení.
- targetName
- String
Název metody, která se má vyvolat. Nesmí být null ani prázdný.
- arguments
- IReadOnlyList<Object>
Argumenty, které se předávají do vyvolané metody. Musí být serializovatelné pomocí vybrané IJsonRpcMessageFormatter. Pokud null
nejsou předány žádné argumenty.
- cancellationToken
- CancellationToken
Token, jehož zrušení by mělo signalizovat server, aby tento požadavek přestal zpracovávat.
Návraty
Úloha, jejíž výsledkem je deserializovaná odpověď ze serveru JSON-RPC.
- Atributy
Platí pro
InvokeCoreAsync<TResult>(RequestId, String, IReadOnlyList<Object>, CancellationToken, Boolean)
Vyvolá zadanou metodu RPC.
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)
Parametry typu
- TResult
Návratový typ metody RPC
Parametry
- id
- RequestId
Identifikátor vytvořený klientem. Pokud je zadána výchozí hodnota, předpokládá se, že se jedná o oznámení.
- targetName
- String
Název metody, která se má vyvolat.
- arguments
- IReadOnlyList<Object>
Argumenty, které se předávají do vyvolané metody. Pokud je hodnota null, nepředá se žádné argumenty.
- cancellationToken
- CancellationToken
Token, jehož zrušení by mělo signalizovat server, aby tento požadavek přestal zpracovávat.
- isParameterObject
- Boolean
Hodnota, která označuje, jestli má být parametr předán jako objekt.
Návraty
Úloha, jejíž výsledkem je deserializovaná odpověď ze serveru JSON-RPC.
Platí pro
InvokeCoreAsync<TResult>(Nullable<Int32>, String, IReadOnlyList<Object>, CancellationToken, Boolean)
Vyvolá zadanou metodu RPC.
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)
Parametry typu
- TResult
Návratový typ metody RPC
Parametry
Identifikátor vytvořený klientem, který musí obsahovat hodnotu String, Number nebo NULL, pokud je zahrnuta. Pokud není součástí, předpokládá se, že se jedná o oznámení.
- targetName
- String
Název metody, která se má vyvolat.
- arguments
- IReadOnlyList<Object>
Argumenty, které se předávají do vyvolané metody. Pokud je hodnota null, nepředá se žádné argumenty.
- cancellationToken
- CancellationToken
Token, jehož zrušení by mělo signalizovat server, aby tento požadavek přestal zpracovávat.
- isParameterObject
- Boolean
Hodnota, která označuje, jestli má být parametr předán jako objekt.
Návraty
Úloha, jejíž výsledkem je deserializovaná odpověď ze serveru JSON-RPC.
Platí pro
InvokeCoreAsync<TResult>(Nullable<Int64>, String, IReadOnlyList<Object>, CancellationToken, Boolean)
Upozornění
Use the InvokeCoreAsync(RequestId, ...) overload instead.
Vyvolá danou metodu na serveru 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)
Parametry typu
- TResult
Návratový typ metody RPC
Parametry
Identifikátor vytvořený klientem. Pokud je zadána výchozí hodnota, předpokládá se, že se jedná o oznámení.
- targetName
- String
Název metody, která se má vyvolat. Nesmí být null ani prázdný.
- arguments
- IReadOnlyList<Object>
Argumenty, které se předávají do vyvolané metody. Musí být serializovatelné pomocí vybrané IJsonRpcMessageFormatter. Pokud null
nejsou předány žádné argumenty.
- cancellationToken
- CancellationToken
Token, jehož zrušení by mělo signalizovat server, aby tento požadavek přestal zpracovávat.
- isParameterObject
- Boolean
Hodnota, která označuje, jestli má být parametr předán jako objekt.
Návraty
Úloha, jejíž výsledkem je deserializovaná odpověď ze serveru JSON-RPC.
- Atributy
Platí pro
InvokeCoreAsync<TResult>(RequestId, String, IReadOnlyList<Object>, IReadOnlyList<Type>, IReadOnlyDictionary<String,Type>, CancellationToken, Boolean)
Vyvolá danou metodu na serveru 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)
Parametry typu
- TResult
Návratový typ metody RPC
Parametry
- id
- RequestId
Identifikátor vytvořený klientem. Pokud je zadána výchozí hodnota, předpokládá se, že se jedná o oznámení.
- targetName
- String
Název metody, která se má vyvolat. Nesmí být null ani prázdný.
- arguments
- IReadOnlyList<Object>
Argumenty, které se předávají do vyvolané metody. Musí být serializovatelné pomocí vybrané IJsonRpcMessageFormatter. Pokud null
se nepředá žádné argumenty.
- positionalArgumentDeclaredTypes
- IReadOnlyList<Type>
Seznam Type objektů, které popisují, jak každý prvek očekává arguments
, že server zadá.
Pokud je zadáno, musí mít přesně stejnou délku jako arguments
a neobsahuje žádné null
prvky.
Tato hodnota je ignorována, pokud isParameterObject
je true.
- namedArgumentDeclaredTypes
- IReadOnlyDictionary<String,Type>
Slovník Type objektů, které popisují, jak každá položka v IReadOnlyDictionary<TKey,TValue> zadaném prvku arguments
je očekáváno serverem.
Pokud je zadáno, musí mít přesně stejnou sadu klíčů jako slovník obsažený v prvním prvku a arguments
neobsahuje žádné null
hodnoty.
- cancellationToken
- CancellationToken
Token, jehož zrušení by mělo signalizovat, že server přestane zpracovávat tento požadavek.
- isParameterObject
- Boolean
Hodnota, která označuje, jestli má být parametr předán jako objekt.
Návraty
Úkol, který se dokončí s odpovědí ze serveru JSON-RPC.
Výjimky
Vyvoláno po cancellationToken
zrušení.
Pokud se žádost již odeslala, výjimka se vyvolá pouze poté, co server přijal oznámení o zrušení a odpověděl na něj.
Pokud server dokončí požadavek místo zrušení, tato výjimka se nevyvolá.
Když se připojení před přijetím odpovědi ukončí, vyvolá se tato výjimka, pokud cancellationToken
byla zrušena.
Běžná základní třída pro různé výjimky RPC, které mohou být vyvolán. Některé běžné odvozené typy jsou uvedeny jednotlivě.
Vyvolá se při vrácení chyby ze serveru v důsledku spuštění požadované metody.
Vyvolá se, když server hlásí, že nebyla nalezena žádná odpovídající metoda pro vyvolání.
Pokud targetName
má hodnotu null.
Vyvolá se, když targetName
je prázdný.
Pokud již byla tato instance JsonRpc vyřazena před tímto voláním.
Vyvolá se, když je připojení ukončeno (na obou stranách) před požadavkem nebo během probíhajícího požadavku, pokud cancellationToken
není již signalizovat.
Jakákoli výjimka vyvolaná chybou IJsonRpcMessageFormatter serializace (obvykle kvůli selhání serializace). Při použití JsonMessageFormatter by to mělo být Newtonsoft.Json.JsonSerializationException. Při použití MessagePackFormatter by to mělo být MessagePack.MessagePackSerializationException.