JsonRpc.InvokeCoreAsync Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
InvokeCoreAsync<TResult>(RequestId, String, IReadOnlyList<Object>, CancellationToken) |
Invokes the specified RPC method. |
InvokeCoreAsync<TResult>(Nullable<Int32>, String, IReadOnlyList<Object>, CancellationToken) |
Invokes the specified RPC method |
InvokeCoreAsync<TResult>(Nullable<Int64>, String, IReadOnlyList<Object>, CancellationToken) |
Obsolete.
Invokes the specified RPC method. |
InvokeCoreAsync<TResult>(RequestId, String, IReadOnlyList<Object>, CancellationToken, Boolean) |
Invokes the specified RPC method. |
InvokeCoreAsync<TResult>(Nullable<Int32>, String, IReadOnlyList<Object>, CancellationToken, Boolean) |
Invokes the specified RPC method |
InvokeCoreAsync<TResult>(Nullable<Int64>, String, IReadOnlyList<Object>, CancellationToken, Boolean) |
Obsolete.
Invokes a given method on a JSON-RPC server. |
InvokeCoreAsync<TResult>(RequestId, String, IReadOnlyList<Object>, IReadOnlyList<Type>, IReadOnlyDictionary<String,Type>, CancellationToken, Boolean) |
Invokes a given method on a JSON-RPC server. |
InvokeCoreAsync<TResult>(RequestId, String, IReadOnlyList<Object>, CancellationToken)
Invokes the specified RPC method.
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)
Type Parameters
- TResult
RPC method return type.
Parameters
- id
- RequestId
An identifier established by the Client that MUST contain a String, Number, or NULL value if included. If it is not included it is assumed to be a notification.
- targetName
- String
Name of the method to invoke. Must not be null or empty.
- arguments
- IReadOnlyList<Object>
Arguments to pass to the invoked method. They must be serializable using the selected IJsonRpcMessageFormatter. If null
, no arguments are passed.
- cancellationToken
- CancellationToken
The token whose cancellation should signal the server to stop processing this request.
Returns
A task whose result is the deserialized response from the JSON-RPC server.
Applies to
InvokeCoreAsync<TResult>(Nullable<Int32>, String, IReadOnlyList<Object>, CancellationToken)
Invokes the specified RPC method
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)
Type Parameters
- TResult
RPC method return type
Parameters
An identifier established by the Client that MUST contain a String, Number, or NULL value if included. If it is not included it is assumed to be a notification.
- targetName
- String
Name of the method to invoke.
- arguments
- IReadOnlyList<Object>
Arguments to pass to the invoked method. If null, no arguments are passed.
- cancellationToken
- CancellationToken
The token whose cancellation should signal the server to stop processing this request.
Returns
A task whose result is the deserialized response from the JSON-RPC server.
Applies to
InvokeCoreAsync<TResult>(Nullable<Int64>, String, IReadOnlyList<Object>, CancellationToken)
Caution
Use the InvokeCoreAsync(RequestId, ...) overload instead.
Invokes the specified RPC method.
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)
Type Parameters
- TResult
RPC method return type.
Parameters
An identifier established by the Client that MUST contain a String, Number, or NULL value if included. If it is not included it is assumed to be a notification.
- targetName
- String
Name of the method to invoke. Must not be null or empty.
- arguments
- IReadOnlyList<Object>
Arguments to pass to the invoked method. They must be serializable using the selected IJsonRpcMessageFormatter. If null
, no arguments are passed.
- cancellationToken
- CancellationToken
The token whose cancellation should signal the server to stop processing this request.
Returns
A task whose result is the deserialized response from the JSON-RPC server.
- Attributes
Applies to
InvokeCoreAsync<TResult>(RequestId, String, IReadOnlyList<Object>, CancellationToken, Boolean)
Invokes the specified RPC method.
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)
Type Parameters
- TResult
RPC method return type.
Parameters
- id
- RequestId
An identifier established by the Client. If the default value is given, it is assumed to be a notification.
- targetName
- String
Name of the method to invoke.
- arguments
- IReadOnlyList<Object>
Arguments to pass to the invoked method. If null, no arguments are passed.
- cancellationToken
- CancellationToken
The token whose cancellation should signal the server to stop processing this request.
- isParameterObject
- Boolean
Value which indicates if parameter should be passed as an object.
Returns
A task whose result is the deserialized response from the JSON-RPC server.
Applies to
InvokeCoreAsync<TResult>(Nullable<Int32>, String, IReadOnlyList<Object>, CancellationToken, Boolean)
Invokes the specified RPC method
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)
Type Parameters
- TResult
RPC method return type
Parameters
An identifier established by the Client that MUST contain a String, Number, or NULL value if included. If it is not included it is assumed to be a notification.
- targetName
- String
Name of the method to invoke.
- arguments
- IReadOnlyList<Object>
Arguments to pass to the invoked method. If null, no arguments are passed.
- cancellationToken
- CancellationToken
The token whose cancellation should signal the server to stop processing this request.
- isParameterObject
- Boolean
Value which indicates if parameter should be passed as an object.
Returns
A task whose result is the deserialized response from the JSON-RPC server.
Applies to
InvokeCoreAsync<TResult>(Nullable<Int64>, String, IReadOnlyList<Object>, CancellationToken, Boolean)
Caution
Use the InvokeCoreAsync(RequestId, ...) overload instead.
Invokes a given method on a JSON-RPC server.
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)
Type Parameters
- TResult
RPC method return type.
Parameters
An identifier established by the Client. If the default value is given, it is assumed to be a notification.
- targetName
- String
Name of the method to invoke. Must not be null or empty.
- arguments
- IReadOnlyList<Object>
Arguments to pass to the invoked method. They must be serializable using the selected IJsonRpcMessageFormatter. If null
, no arguments are passed.
- cancellationToken
- CancellationToken
The token whose cancellation should signal the server to stop processing this request.
- isParameterObject
- Boolean
Value which indicates if parameter should be passed as an object.
Returns
A task whose result is the deserialized response from the JSON-RPC server.
- Attributes
Applies to
InvokeCoreAsync<TResult>(RequestId, String, IReadOnlyList<Object>, IReadOnlyList<Type>, IReadOnlyDictionary<String,Type>, CancellationToken, Boolean)
Invokes a given method on a JSON-RPC server.
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)
Type Parameters
- TResult
RPC method return type.
Parameters
- id
- RequestId
An identifier established by the Client. If the default value is given, it is assumed to be a notification.
- targetName
- String
Name of the method to invoke. Must not be null or empty.
- arguments
- IReadOnlyList<Object>
Arguments to pass to the invoked method. They must be serializable using the selected IJsonRpcMessageFormatter. If null
, no arguments are passed.
- positionalArgumentDeclaredTypes
- IReadOnlyList<Type>
A list of Type objects that describe how each element in arguments
is expected by the server to be typed.
If specified, this must have exactly the same length as arguments
and contain no null
elements.
This value is ignored when isParameterObject
is true.
- namedArgumentDeclaredTypes
- IReadOnlyDictionary<String,Type>
A dictionary of Type objects that describe how each entry in the IReadOnlyDictionary<TKey,TValue> provided in the only element of arguments
is expected by the server to be typed.
If specified, this must have exactly the same set of keys as the dictionary contained in the first element of arguments
, and contain no null
values.
- cancellationToken
- CancellationToken
The token whose cancellation should signal the server to stop processing this request.
- isParameterObject
- Boolean
Value which indicates if parameter should be passed as an object.
Returns
A task that completes with the response from the JSON-RPC server.
Exceptions
Thrown after cancellationToken
is canceled.
If the request has already been transmitted, the exception is only thrown after the server has received the cancellation notification and responded to it.
If the server completes the request instead of cancelling, this exception will not be thrown.
When the connection drops before receiving a response, this exception is thrown if cancellationToken
has been canceled.
A common base class for a variety of RPC exceptions that may be thrown. Some common derived types are listed individually.
Thrown when an error is returned from the server in consequence of executing the requested method.
Thrown when the server reports that no matching method was found to invoke.
If targetName
is null.
Thrown when targetName
is empty.
If this instance of JsonRpc has already been disposed prior to this call.
Thrown when the connection is terminated (by either side) before the request or while the request is in progress,
unless cancellationToken
is already signaled.
Any exception thrown by the IJsonRpcMessageFormatter (typically due to serialization failures). When using JsonMessageFormatter this should be Newtonsoft.Json.JsonSerializationException. When using MessagePackFormatter this should be MessagePack.MessagePackSerializationException.