StreamUpgradeProvider Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Implementa um fornecedor de atualização personalizado, herdado desta abstract classe base.
public ref class StreamUpgradeProvider abstract : System::ServiceModel::Channels::CommunicationObjectpublic abstract class StreamUpgradeProvider : System.ServiceModel.Channels.CommunicationObjecttype StreamUpgradeProvider = class
inherit CommunicationObjectPublic MustInherit Class StreamUpgradeProvider
Inherits CommunicationObject- Herança
- Derivado
Observações
Um exemplo de melhoria de curso de água é construir um fluxo de compressão diretamente sobre o fluxo de transporte. Para adicionar uma atualização de segurança, implementa ainda uma classe que deriva de StreamSecurityUpgradeProvider. Podes implementar múltiplas melhorias, cada uma a envolver a anterior.
O processo de atualização tem os seguintes passos:
Implementar uma classe que deriva de StreamUpgradeProvider.
Registe-o. Faz-se isto criando um elemento de ligação para ele e registando o fornecedor numa ligação personalizada.
A classe derivada que implementas cria uma instância de StreamUpgradeInitiator, que em tempo de execução inicia um pedido para a outra extremidade da sua ligação para atualizar a camada de transporte do canal.
A classe derivada que implementas cria uma instância de StreamUpgradeAcceptor, que em tempo de execução recebe o pedido de atualização do passo anterior e, se possível, aceita a atualização e devolve o fluxo atualizado para o outro lado da sua ligação.
Se houver pedidos adicionais de atualização, estes são processados sequencialmente, conforme descrito nos dois passos anteriores.
Construtores
| Name | Description |
|---|---|
| StreamUpgradeProvider() |
Inicializa uma nova instância da StreamUpgradeProvider classe. |
| StreamUpgradeProvider(IDefaultCommunicationTimeouts) |
Inicializa uma nova instância da StreamUpgradeProvider classe. |
Propriedades
| Name | Description |
|---|---|
| DefaultCloseTimeout |
Recebe o DefaultCloseTimeout. |
| DefaultOpenTimeout |
Recebe o OpenTimeout por defeito. |
| IsDisposed |
Obtém um valor que indica se o objeto de comunicação foi eliminado. (Herdado de CommunicationObject) |
| State |
Obtém um valor que indica o estado atual do objeto de comunicação. (Herdado de CommunicationObject) |
| ThisLock |
Obtém o bloqueio mutuamente exclusivo que protege a instância de classe durante uma transição de estado. (Herdado de CommunicationObject) |
Métodos
| Name | Description |
|---|---|
| Abort() |
Faz com que um objeto de comunicação transite imediatamente do seu estado atual para o estado de fecho. (Herdado de CommunicationObject) |
| BeginClose(AsyncCallback, Object) |
Inicia uma operação assíncrona para fechar um objeto de comunicação. (Herdado de CommunicationObject) |
| BeginClose(TimeSpan, AsyncCallback, Object) |
Inicia uma operação assíncrona para fechar um objeto de comunicação com um timeout especificado. (Herdado de CommunicationObject) |
| BeginOpen(AsyncCallback, Object) |
Inicia uma operação assíncrona para abrir um objeto de comunicação. (Herdado de CommunicationObject) |
| BeginOpen(TimeSpan, AsyncCallback, Object) |
Inicia uma operação assíncrona para abrir um objeto de comunicação dentro de um intervalo de tempo especificado. (Herdado de CommunicationObject) |
| Close() |
Faz com que um objeto de comunicação faça a transição do seu estado atual para o estado fechado. (Herdado de CommunicationObject) |
| Close(TimeSpan) |
Faz com que um objeto de comunicação transite do seu estado atual para o estado fechado dentro de um intervalo de tempo especificado. (Herdado de CommunicationObject) |
| CreateUpgradeAcceptor() |
Cria uma instância de StreamUpgradeAcceptor. |
| CreateUpgradeInitiator(EndpointAddress, Uri) |
Cria uma instância de StreamUpgradeInitiator. |
| EndClose(IAsyncResult) |
Completa uma operação assíncrona para fechar um objeto de comunicação. (Herdado de CommunicationObject) |
| EndOpen(IAsyncResult) |
Completa uma operação assíncrona para abrir um objeto de comunicação. (Herdado de CommunicationObject) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| Fault() |
Faz com que um objeto de comunicação faça a transição do seu estado atual para o estado defeituoso. (Herdado de CommunicationObject) |
| GetCommunicationObjectType() |
Obtém o tipo de objeto de comunicação. (Herdado de CommunicationObject) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetProperty<T>() |
Quando implementado numa classe derivada, obtém uma propriedade do fluxo atual que representa um iniciador de uma atualização do fluxo. |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnAbort() |
Insere processamento num objeto de comunicação após esta transitar para o estado de encerramento devido à invocação de uma operação de aborto síncrona. (Herdado de CommunicationObject) |
| OnBeginClose(TimeSpan, AsyncCallback, Object) |
Insere o processamento após a transição de um objeto de comunicação para o estado de fecho devido à invocação de uma operação de fecho assíncrona. (Herdado de CommunicationObject) |
| OnBeginOpen(TimeSpan, AsyncCallback, Object) |
Insere processamento num objeto de comunicação após esta transitar para o estado de abertura devido à invocação de uma operação aberta assíncrona. (Herdado de CommunicationObject) |
| OnClose(TimeSpan) |
Insere processamento num objeto de comunicação após esta transitar para o estado de fecho devido à invocação de uma operação síncrona de fecho. (Herdado de CommunicationObject) |
| OnClosed() |
Invocado durante a transição de um objeto de comunicação para o estado de fecho. (Herdado de CommunicationObject) |
| OnClosing() |
Invocado durante a transição de um objeto de comunicação para o estado de fecho. (Herdado de CommunicationObject) |
| OnEndClose(IAsyncResult) |
Conclui uma operação assíncrona no fecho de um objeto de comunicação. (Herdado de CommunicationObject) |
| OnEndOpen(IAsyncResult) |
Completa uma operação assíncrona na abertura de um objeto de comunicação. (Herdado de CommunicationObject) |
| OnFaulted() |
Insere processamento num objeto de comunicação após esta transitar para o estado de falha devido à invocação de uma operação de falha síncrona. (Herdado de CommunicationObject) |
| OnOpen(TimeSpan) |
Insere o processamento num objeto de comunicação após esta transitar para o estado de abertura, que deve ser concluído dentro de um intervalo de tempo especificado. (Herdado de CommunicationObject) |
| OnOpened() |
Invocado durante a transição de um objeto de comunicação para o estado aberto. (Herdado de CommunicationObject) |
| OnOpening() |
Invocado durante a transição de um objeto de comunicação para o estado de abertura. (Herdado de CommunicationObject) |
| Open() |
Faz com que um objeto de comunicação faça a transição do estado criado para o estado aberto. (Herdado de CommunicationObject) |
| Open(TimeSpan) |
Faz com que um objeto de comunicação faça a transição do estado criado para o estado aberto dentro de um intervalo de tempo especificado. (Herdado de CommunicationObject) |
| ThrowIfDisposed() |
Lança uma exceção se o objeto de comunicação for eliminado. (Herdado de CommunicationObject) |
| ThrowIfDisposedOrImmutable() |
Lança uma exceção se a propriedade do objeto State de comunicação não estiver definida para o Created estado. (Herdado de CommunicationObject) |
| ThrowIfDisposedOrNotOpen() |
Lança uma exceção se o objeto de comunicação não estiver nesse Opened estado. (Herdado de CommunicationObject) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
evento
| Name | Description |
|---|---|
| Closed |
Ocorre quando um objeto de comunicação transita para o estado fechado. (Herdado de CommunicationObject) |
| Closing |
Ocorre quando um objeto de comunicação transita para o estado de fecho. (Herdado de CommunicationObject) |
| Faulted |
Ocorre quando um objeto de comunicação transita para o estado falhado. (Herdado de CommunicationObject) |
| Opened |
Ocorre quando um objeto de comunicação transita para o estado aberto. (Herdado de CommunicationObject) |
| Opening |
Ocorre quando um objeto de comunicação transita para o estado de abertura. (Herdado de CommunicationObject) |
