ProviderConnectionPoint.GetObject(Control) Método

Definição

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Invoca o método de retorno de chamada em um controle do provedor que obtém uma instância da interface para retornar a consumidores.

public:
 virtual System::Object ^ GetObject(System::Web::UI::Control ^ control);

public virtual object GetObject (System.Web.UI.Control control);

abstract member GetObject : System.Web.UI.Control -> obj
override this.GetObject : System.Web.UI.Control -> obj

Public Overridable Function GetObject (control As Control) As Object

Parâmetros

control

Control

O controle que age como o provedor em uma conexão de Web Parts.

Retornos

Object

Um Object que é uma instância da interface que um provedor retorna para os consumidores para estabelecer uma conexão.

Exceções

ArgumentNullException

control é null.

Comentários

Esse método retorna um objeto do controle do provedor que é uma instância da interface usada para estabelecer uma conexão. O tipo do objeto será o tipo da interface implementada. Por exemplo, duas interfaces implementadas para conexões no conjunto de controle Web Parts são IWebPartField e IWebPartRow. Quando o GetObject método é chamado em um ProviderConnectionPoint objeto, se o provedor associado implementar uma dessas interfaces, o objeto retornado será do mesmo tipo.

O GetObject método é chamado por WebPartConnection objetos quando uma conexão está sendo ativada. Essa é uma etapa crítica que realmente inicia uma conexão e inicia o processo que permite que dois controles compartilhem dados.

O controle do consumidor em uma conexão deve ser capaz de trabalhar com o mesmo tipo de interface que o provedor. Se isso não acontecer, os controles serão incompatíveis e um WebPartTransformer objeto deverá ser usado para estabelecer uma conexão.