UserControl.Load Událost

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Nastane před prvním zobrazením ovládacího prvku.

public:
 event EventHandler ^ Load;
public event EventHandler Load;
public event EventHandler? Load;
member this.Load : EventHandler 
Public Custom Event Load As EventHandler

Event Type

EventHandler

Příklady

Následující příklad kódu ukazuje použití tohoto člena. V příkladu obslužná rutina události hlásí výskyt Load události. Tato sestava vám pomůže zjistit, kdy k události dojde, a může vám pomoct s laděním. Pokud chcete hlásit více událostí nebo událostí, ke kterým dochází často, zvažte nahrazení MessageBox.ShowConsole.WriteLine nebo připojení zprávy k víceřádkovému TextBoxobjektu .

Pokud chcete spustit ukázkový kód, vložte ho do projektu, který obsahuje instanci typu UserControl s názvem UserControl1. Pak se ujistěte, že je obslužná rutina události přidružená k Load události.

private void UserControl1_Load(Object sender, EventArgs e) {

   MessageBox.Show("You are in the UserControl.Load event.");
}

Private Sub UserControl1_Load(sender as Object, e as EventArgs) _ 
     Handles UserControl1.Load

   MessageBox.Show("You are in the UserControl.Load event.")

End Sub

Poznámky

Tuto událost můžete použít k provádění úloh, jako je přidělování prostředků používaných ovládacím prvky.

Poznámka

UserControl Pokud je součástí podřízeného formuláře MDI, Load dojde k události při každém zobrazení podřízeného formuláře. V tomto případě byste měli do obslužné Load rutiny události vložit jakýkoli jednorázový inicializační kódUserControl.

Upozornění

Událost Load nastane při vytvoření popisovače pro UserControl objekt. V některých případech to může způsobit Load , že k události dojde vícekrát. Například k Load události dochází při UserControl načtení a znovu, pokud je popisovač znovu vytvořena. (Jedním ze způsobů, jak se popisovač znovu vytvoří, je volání RecreateHandle metody.) Chcete-li zohlednit Load událost, ke které dochází více než jednou, měli byste vložit libovolný inicializační kód do konstruktoru UserControl místo obslužné Load rutiny události. Kromě toho byste neměli přidávat datové vazby do obslužné UserControlLoad rutiny události.

Další informace o zpracování událostí najdete v tématu Zpracování a vyvolávání událostí.

Platí pro

Viz také