WebPartConnectionsEventArgs 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.
Fornece os dados de eventos para os WebPartsConnected eventos e WebPartsDisconnected do WebPartManager controlo.
public ref class WebPartConnectionsEventArgs : EventArgspublic class WebPartConnectionsEventArgs : EventArgstype WebPartConnectionsEventArgs = class
inherit EventArgsPublic Class WebPartConnectionsEventArgs
Inherits EventArgs- Herança
Observações
Utilizando as capacidades do conjunto de controlos Web Parts, é possível criar uma ligação entre dois WebPart ou outros controlos de servidor, com um controlo a atuar como fornecedor e o outro a servir como consumidor de dados. Para formar uma ligação, os dois controlos devem residir numa zona que herde da WebPartZoneBase classe (como o WebPartZone controlo), e devem ser desenhados corretamente para partilhar dados através de uma interface comum. Para detalhes sobre ligações Web Parts, consulte WebPartConnectionResumo das Conexões Web Parts.
A WebPartConnectionsEventArgs classe passa dados de eventos para métodos que utilizam o WebPartConnectionsEventHandler delegado para gerir eventos. Existem dois métodos relacionados com ligações que geram eventos e usam a WebPartConnectionsEventArgs classe para fornecer dados de eventos. Ambos são membros do WebPartManager controlo. O OnWebPartsConnected método levanta o WebPartsConnected evento depois de dois controlos de servidor terem sido conectados com sucesso, e o OnWebPartsDisconnected método gera o WebPartsDisconnected evento depois de dois controlos de servidor terem sido desconectados.
Os programadores podem criar métodos personalizados de gestores de eventos para os WebPartsConnected eventos e WebPartsDisconnected e, nesses métodos, podem usar a WebPartConnectionsEventArgs classe para aceder aos detalhes de uma ligação. Por exemplo, um programador pode declarar o OnWebPartsConnected atributo no <asp:webpartmanager> elemento e atribuir-lhe um nome de método personalizado que irá tratar do evento. No método handler personalizado, os programadores podem aceder aos detalhes de uma ligação usando o WebPartConnectionsEventArgs objeto que é passado ao método como parâmetro.
A WebPartConnectionsEventArgs classe tem duas sobrecargas do construtor. O WebPartConnectionsEventArgs.WebPartConnectionsEventArgs(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint) construtor é o padrão; inicializa os valores das propriedades da classe. O WebPartConnectionsEventArgs.WebPartConnectionsEventArgs(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartConnection) construtor chama o construtor sem parâmetro e depois também inicializa a Connection propriedade.
A WebPartConnectionsEventArgs classe tem várias propriedades, todas referindo-se aos aspetos essenciais de uma ligação a Web Parts. A Connection propriedade refere-se ao objeto associado WebPartConnection que representa toda a ligação. A Provider propriedade refere-se a um WebPart ou outro controlo de servidor a atuar como fornecedor na ligação, e a Consumer propriedade refere-se a um WebPart ou controlo de servidor a atuar como consumidor. A ProviderConnectionPoint propriedade faz referência ao objeto da ProviderConnectionPoint ligação, enquanto a ConsumerConnectionPoint propriedade faz referência ao ConsumerConnectionPoint objeto.
Construtores
| Name | Description |
|---|---|
| WebPartConnectionsEventArgs(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartConnection) |
Inicializa uma nova instância da classe usando o objeto especificado WebPartConnection . |
| WebPartConnectionsEventArgs(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint) |
Inicializa uma nova instância da WebPartConnectionsEventArgs classe sem precisar de um WebPartConnection objeto. |
Propriedades
| Name | Description |
|---|---|
| Connection |
Obtém o WebPartConnection objeto da ligação atual. |
| Consumer |
Fica com o WebPart controlo que atua como consumidor na ligação. |
| ConsumerConnectionPoint |
Obtém o ConsumerConnectionPoint objeto da ligação atual. |
| Provider |
Fica com o WebPart controlo que atua como fornecedor na ligação. |
| ProviderConnectionPoint |
Obtém o ProviderConnectionPoint objeto da ligação atual. |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
