WebPartManager.BeginWebPartConnecting(WebPart) Método

  • Referência

Definição

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Inicia o processo de conexão de dois controles WebPart.

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 controle para o qual a conexão está sendo formada.

Exceções

ArgumentNullException

webPart é null.

InvalidOperationException

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

ArgumentException

webPart está fechado.

- ou -

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

-ou-

webPart é igual ao controle SelectedWebPart.

Comentários

O BeginWebPartConnecting método existe para que o processo de formação de conexões entre controles possa ser feito em estágios distintos, dando aos desenvolvedores mais controle sobre o processo de conexão. O método executa um conjunto de verificações iniciais para garantir que esteja em um estado em que webPart uma conexão possa ser formada legitimamente. Se webPart passar por todas as verificações, ela será definida como o controle selecionado no momento (consulte a SelectedWebPart propriedade) e o processo de conexão poderá continuar.

Notas aos Herdeiros

Os desenvolvedores que precisam estender o WebPartManager controle podem querer substituir esse método em uma classe derivada. Uma abordagem seria chamar o método base e, em seguida, adicionar algum tratamento personalizado adicional; ou talvez você queira personalizar completamente o processo de iniciar uma conexão entre controles. Por exemplo, talvez você queira verificar se determinados dados estão disponíveis antes de criar a conexão.

Aplica-se a

Confira também