UserControl.Load Událost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Nastane před tím, než se ovládací prvek poprvé zobrazí.
public:
event EventHandler ^ Load;public event EventHandler Load;public event EventHandler? Load;member this.Load : EventHandler Public Custom Event Load As EventHandler Event Type
Příklady
Následující příklad kódu ukazuje použití tohoto člena. V tomto 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 při ladění. Chcete-li 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 do víceřádkového řetězce TextBox.
Pokud chcete spustit ukázkový kód, vložte ho do projektu, který obsahuje instanci typu UserControl s názvem UserControl1. Potom 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 prvku.
Note
UserControl Pokud je součástí podřízeného formuláře MDI, dojde k Load události při každém zobrazení podřízeného formuláře. V tomto případě byste měli místo obslužné rutiny události vložit jakýkoli jednorázový inicializační kód UserControlLoad .
Caution
K Load události dochází při vytvoření popisovače UserControl . Za některých okolností to může způsobit Load , že událost nastane vícekrát. Například událost Load nastane, když je načtena UserControl , a znovu, pokud je úchyt znovu vytvořena. (Jedním ze způsobů, jak se úchyt znovu vytvoří, je voláním RecreateHandle metody.) Pokud chcete počítat s Load událostí, ke které dochází vícekrát, měli byste do konstruktoru UserControl místo obslužné rutiny události vložit jakýkoli kód inicializace Load času. Kromě toho byste do obslužné rutiny události neměli přidávat UserControlLoad datové vazby.
Další informace o zpracování událostí naleznete v tématu Zpracování a vyvolávání událostí.
