WebPartManager.BeginWebPartConnecting(WebPart) Método

Definição

Inicia o processo de ligação de dois WebPart controlos.

public:
 virtual void BeginWebPartConnecting(System::Web::UI::WebControls::WebParts::WebPart ^ webPart);
public virtual void BeginWebPartConnecting(System.Web.UI.WebControls.WebParts.WebPart webPart);
abstract member BeginWebPartConnecting : System.Web.UI.WebControls.WebParts.WebPart -> unit
override this.BeginWebPartConnecting : System.Web.UI.WebControls.WebParts.WebPart -> unit
Public Overridable Sub BeginWebPartConnecting (webPart As WebPart)

Parâmetros

webPart
WebPart

O controlo para o qual a ligação está a ser formada.

Exceções

webPart é null.

O modo de exibição atual na página não ConnectDisplayModeé .

webPart está fechado.

-ou-

webPart não faz parte da Controls coleção.

-ou -

webPart é igual ao SelectedWebPart controlo.

Observações

O BeginWebPartConnecting método existe para que o processo de formação de ligações entre controlos possa ser feito em fases distintas, dando aos programadores mais controlo sobre o processo de ligação. O método realiza um conjunto de verificações iniciais para garantir que webPart está num estado onde uma ligação pode legitimamente ser formada. Se webPart passar todas as verificações, é então definido como o controlo atualmente selecionado (ver a SelectedWebPart propriedade), e o processo de ligação pode continuar.

Notas para Herdeiros

Os programadores que precisam de estender o WebPartManager controlo podem querer sobrepor este método numa classe derivada. Uma abordagem seria chamar o método base e depois adicionar alguma manipulação personalizada adicional; Ou talvez queiras personalizar completamente o processo de iniciar uma ligação entre controlos. Por exemplo, pode querer verificar se certos dados estão disponíveis antes de criar a ligação.

Aplica-se a

Ver também