WebPartManager.BeginWebPartConnecting(WebPart) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
webPart
é null
.
O modo de exibição atual na página não é ConnectDisplayMode.
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.