ServiceBrokerClient.GetProxyAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| GetProxyAsync<T>(ServiceRpcDescriptor, CancellationToken) |
Запрашивает доступ к определенной службе через прокси-сервер клиента. Один и тот же прокси-сервер клиента возвращается для определенной службы и прокси-сервера, пока он не будет признан недействительным. |
| GetProxyAsync<T>(ServiceRpcDescriptor, ServiceActivationOptions, CancellationToken) |
Запрашивает доступ к определенной службе через прокси-сервер клиента. Один и тот же прокси-сервер клиента возвращается для определенной службы и прокси-сервера, пока он не будет признан недействительным. |
GetProxyAsync<T>(ServiceRpcDescriptor, CancellationToken)
Запрашивает доступ к определенной службе через прокси-сервер клиента. Один и тот же прокси-сервер клиента возвращается для определенной службы и прокси-сервера, пока он не будет признан недействительным.
public:
generic <typename T>
where T : class System::Threading::Tasks::ValueTask<Microsoft::ServiceHub::Framework::ServiceBrokerClient::Rental<T>> GetProxyAsync(Microsoft::ServiceHub::Framework::ServiceRpcDescriptor ^ serviceRpcDescriptor, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.ValueTask<Microsoft.ServiceHub.Framework.ServiceBrokerClient.Rental<T>> GetProxyAsync<T> (Microsoft.ServiceHub.Framework.ServiceRpcDescriptor serviceRpcDescriptor, System.Threading.CancellationToken cancellationToken) where T : class;member this.GetProxyAsync : Microsoft.ServiceHub.Framework.ServiceRpcDescriptor * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.ServiceHub.Framework.ServiceBrokerClient.Rental<'T>> (requires 'T : null)Public Function GetProxyAsync(Of T As Class) (serviceRpcDescriptor As ServiceRpcDescriptor, cancellationToken As CancellationToken) As ValueTask(Of ServiceBrokerClient.Rental(Of T))Параметры типа
- T
Тип создаваемого прокси-сервера клиента.
Параметры
- serviceRpcDescriptor
- ServiceRpcDescriptor
Дескриптор службы.
- cancellationToken
- CancellationToken
Токен отмены.
Возвращаемое значение
Аренда прокси-сервера клиента, который может использоваться для взаимодействия со службой; или null , если соответствующая служба не найдена.
Прокси-серверы сохраняются в живых в то время как "арендованы", и могут быть сохранены в живых после аренды, пока они не будут признаны недействительными.
Структуру аренды следует удалить сразу после того, как вызывающий объект будет использовать ее (так, чтобы при следующем использовании вызов снова вызывался GetProxyAsync<T>(ServiceRpcDescriptor, CancellationToken) и можно было бы получить прокси-сервер клиента к другому экземпляру службы).
Сам прокси-сервер клиента в структуре аренды не должен удаляться напрямую, так как он может быть совместно использоваться в вызовах этого метода.
Исключения
Возникает при возникновении ошибки обнаружения или активации службы.
Применяется к
GetProxyAsync<T>(ServiceRpcDescriptor, ServiceActivationOptions, CancellationToken)
Запрашивает доступ к определенной службе через прокси-сервер клиента. Один и тот же прокси-сервер клиента возвращается для определенной службы и прокси-сервера, пока он не будет признан недействительным.
public System.Threading.Tasks.ValueTask<Microsoft.ServiceHub.Framework.ServiceBrokerClient.Rental<T>> GetProxyAsync<T> (Microsoft.ServiceHub.Framework.ServiceRpcDescriptor serviceRpcDescriptor, Microsoft.ServiceHub.Framework.ServiceActivationOptions options = default, System.Threading.CancellationToken cancellationToken = default) where T : class;member this.GetProxyAsync : Microsoft.ServiceHub.Framework.ServiceRpcDescriptor * Microsoft.ServiceHub.Framework.ServiceActivationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.ServiceHub.Framework.ServiceBrokerClient.Rental<'T>> (requires 'T : null)Public Function GetProxyAsync(Of T As Class) (serviceRpcDescriptor As ServiceRpcDescriptor, Optional options As ServiceActivationOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of ServiceBrokerClient.Rental(Of T))Параметры типа
- T
Тип создаваемого прокси-сервера клиента.
Параметры
- serviceRpcDescriptor
- ServiceRpcDescriptor
Дескриптор службы.
- options
- ServiceActivationOptions
Дополнительные параметры, которые изменяют способ активации службы или предоставляют дополнительные данные конструктору службы. Используется только в том случае, если служба еще не была кэширована.
- cancellationToken
- CancellationToken
Токен отмены.
Возвращаемое значение
Аренда прокси-сервера клиента, который может использоваться для взаимодействия со службой; или null , если соответствующая служба не найдена.
Прокси-серверы сохраняются в живых в то время как "арендованы", и могут быть сохранены в живых после аренды, пока они не будут признаны недействительными.
Структуру аренды следует удалить сразу после того, как вызывающий объект будет использовать ее (так, чтобы при следующем использовании вызов снова вызывался GetProxyAsync<T>(ServiceRpcDescriptor, CancellationToken) и можно было бы получить прокси-сервер клиента к другому экземпляру службы).
Сам прокси-сервер клиента в структуре аренды не должен удаляться напрямую, так как он может быть совместно использоваться в вызовах этого метода.
Исключения
Возникает при возникновении ошибки обнаружения или активации службы.