IInteractiveChannelInitializer Interface

Definição

public interface class IInteractiveChannelInitializer

public interface IInteractiveChannelInitializer

type IInteractiveChannelInitializer = interface

Public Interface IInteractiveChannelInitializer

Derivado

System.ServiceModel.Security.InfocardInteractiveChannelInitializer

Observações

Implemente a IInteractiveChannelInitializer interface para permitir que uma aplicação cliente mostre uma interface de utilizador que permita ao utilizador da aplicação criar ou selecionar as credenciais antes de abrir um canal.

Para implementar IInteractiveChannelInitializer, execute os seguintes passos em IInteractiveChannelInitializer.BeginDisplayInitializationUI:

1. Solicite ao utilizador e obtenha uma resposta adequada System.Net.NetworkCredential.

2. Adicione um objeto de parâmetro de canal personalizado à coleção devolvida pelo IChannel.GetProperty método no IClientChannel objeto com um parâmetro de tipo de System.ServiceModel.Channels.ChannelParameterCollection. Este objeto de parâmetro de canal é usado pelo costume System.ServiceModel.ClientCredentialsSecurityTokenManager para estabelecer os tokens de segurança do canal.

3. Volta.

Para inserir IInteractiveChannelInitializer:

1. Anule o IEndpointBehavior.ApplyClientBehavior método da System.ServiceModel.Description.ClientCredentials turma.

2. Nesse método, determina se o endpoint requer um IInteractiveChannelInitializer e, se sim, adiciona o IInteractiveChannelInitializer à ClientRuntime.InteractiveChannelInitializers coleção.

Existem duas formas de os programadores de aplicações utilizarem um .IInteractiveChannelInitializer A aplicação cliente pode chamar ou ClientBase<TChannel>.DisplayInitializationUIIClientChannel.DisplayInitializationUI (ou uma versão assíncrona) antes de abrir o canal (a abordagem explícita ) ou simplesmente chamar a primeira operação (a abordagem implícita ).

Se usar a abordagem implícita, a aplicação deve chamar a primeira operação numa ClientBase<TChannel> extensão ou IClientChannel . Se for chamada qualquer operação diferente da primeira, uma exceção será lançada.

Se estiver usando a abordagem explícita, o aplicativo deve executar as seguintes etapas na ordem:

1. Chame ClientBase<TChannel>.DisplayInitializationUI ou IClientChannel.DisplayInitializationUI (ou uma versão assíncrona).

2. Quando os inicializadores retornarem, chame ou o método Open no objeto IClientChannel ou no objeto IClientChannel retornado da propriedade ClientBase<TChannel>.InnerChannel.

3. Operações de chamada.

Recomenda-se que as aplicações de qualidade de produção controlem o processo da interface de utilizador adotando a abordagem explícita.

Os aplicativos que usam a abordagem implícita invocam os inicializadores da interface do usuário, mas se o usuário do aplicativo não responder dentro do período de tempo limite de envio da ligação, uma exceção será lançada quando a interface do usuário retornar.