JsonRpc.NotifyAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
NotifyAsync(String, Object) |
Вызывает заданный метод на сервере JSON-RPC без ожидания ответа. |
NotifyAsync(String, Object[]) |
Вызовите метод на сервере и не подождите, пока он не будет завершен, стиль fire-and-forget. |
NotifyAsync(String, Object[], IReadOnlyList<Type>) |
Вызывает заданный метод на сервере JSON-RPC без ожидания ответа. |
NotifyAsync(String, Object)
Вызывает заданный метод на сервере JSON-RPC без ожидания ответа.
public System.Threading.Tasks.Task NotifyAsync (string targetName, object argument);
public System.Threading.Tasks.Task NotifyAsync (string targetName, object? argument);
member this.NotifyAsync : string * obj -> System.Threading.Tasks.Task
Public Function NotifyAsync (targetName As String, argument As Object) As Task
Параметры
- targetName
- String
Имя вызываемого метода. Не должен иметь значение NULL или быть пустым.
- argument
- Object
Аргумент метода должен быть сериализуемым с помощью выбранного параметра IJsonRpcMessageFormatter.
Возвращаемое значение
Задача, которая завершается после отправки запроса уведомления на сервер.
Исключения
Если targetName
значение равно NULL.
Возникает, когда targetName
пусто.
Если этот экземпляр JsonRpc уже удален до этого вызова.
Возникает при завершении подключения (по обе стороны) во время передачи запроса.
Любое исключение, вызванное IJsonRpcMessageFormatter (как правило, из-за сбоев сериализации). При использовании JsonMessageFormatter этого параметра должно быть Newtonsoft.Json.JsonSerializationException. При использовании MessagePackFormatter этого параметра должно быть MessagePack.MessagePackSerializationException.
Комментарии
Любая ошибка, возникающая на стороне сервера, игнорируется.
Применяется к
NotifyAsync(String, Object[])
Вызовите метод на сервере и не подождите, пока он не будет завершен, стиль fire-and-forget.
public System.Threading.Tasks.Task NotifyAsync (string targetName, params object[] arguments);
public System.Threading.Tasks.Task NotifyAsync (string targetName, params object?[]? arguments);
member this.NotifyAsync : string * obj[] -> System.Threading.Tasks.Task
Public Function NotifyAsync (targetName As String, ParamArray arguments As Object()) As Task
Параметры
- targetName
- String
Имя метода, вызываемого на сервере. Не должно быть пустой или пустой строкой.
- arguments
- Object[]
Аргументы метода должны быть сериализуемыми в JSON.
Возвращаемое значение
Задача, которая завершается после отправки запроса уведомления на сервер.
Исключения
Если targetName
значение равно NULL.
Если этот экземпляр JsonRpc удален.
Комментарии
Любая ошибка, возникающая на стороне сервера, игнорируется.
Применяется к
NotifyAsync(String, Object[], IReadOnlyList<Type>)
Вызывает заданный метод на сервере JSON-RPC без ожидания ответа.
public System.Threading.Tasks.Task NotifyAsync (string targetName, object?[]? arguments, System.Collections.Generic.IReadOnlyList<Type>? argumentDeclaredTypes);
member this.NotifyAsync : string * obj[] * System.Collections.Generic.IReadOnlyList<Type> -> System.Threading.Tasks.Task
Public Function NotifyAsync (targetName As String, arguments As Object(), argumentDeclaredTypes As IReadOnlyList(Of Type)) As Task
Параметры
- targetName
- String
Имя вызываемого метода. Не должен иметь значение NULL или быть пустым.
- arguments
- Object[]
Аргументы для передачи в вызываемый метод. Они должны быть сериализуемыми с помощью выбранного параметра IJsonRpcMessageFormatter. Если null
аргументы не передаются.
- argumentDeclaredTypes
- IReadOnlyList<Type>
Список Type объектов, описывающих, как каждый элемент arguments
должен быть введен сервером.
Если этот параметр указан, он должен иметь точно ту же длину, что arguments
и не null
содержать элементов.
Это значение игнорируется, если isParameterObject
значение равно true.
Возвращаемое значение
Задача, которая завершается после отправки запроса уведомления на сервер.
Комментарии
Любая ошибка, возникающая на стороне сервера, игнорируется.