A használathoz tegyünk egy OpenFileDialog komponenst a Form-ra. Ennek megjelenítése igen egyszerű: csak meg kell hívnunk a ShowDialog függvényét, melynek visszatérési értékéből tudjuk meg, hogy a felhasználó a Megnyitás vagy a Mégsem gombbal zárta-e le az ablakot. A választott állomány neve teljes elérési útvonallal együtt a FileName property-ből olvasható ki.
private void button1_Click (object sender, System.EventArgs e)
{
if (openFileDialog1.ShowDialog() == DialogResult.OK)
{
label1.Text = openFileDialog1.FileName;
}
}
Mindezt úgy is lekezelhettük volna, hogy felhasználjuk a komponens FileOK eseményét, mely a dialóg ablak Megnyitás gombjának kiválasztásakor jön létre.
További beállítási lehetősége az OpenFileDialog komponensnek még a Title property, ahol a megjelenő ablak fejlécének szövegét adhatjuk meg.
Ha korlátozni szeretnénk a kiválasztható állományok típusát, akkor a Filter property-ben kell megadnunk egy speciális sztringet. Ez úgy néz ki, hogy egy szövegesen olvasható sztring, majd egy | elválasztó jellel egy állomány kiterjesztés. Például: TXT állomány (*.txt)|*.txt. Ebben az esetben a felhasználó számára a TXT állomány (*.txt) felirat jelenik meg, míg az ablak számra a *.txt fogja megmondani, hogy milyen típusú állomány jelenhet meg az ablakban.
Ha szűrésként egynél több lehetőséget szeretnénk megadni, akkor ezt megtehetjük egy újabb | elválasztó jel után.
A FilterIndex property-ben választhatjuk ki, hogy hányadik szűrő feltétel legyen az aktív a Filter-ben megadottak közül.
Ha a MultiSelect property-t igazra állítjuk, akkor egyszerre több állományt is kiválaszthat a felhasználó. Ekkor a választott állományok listáját a FileNames property-ből tudhatjuk meg, mely sztringeket tartalmazó tömb típusú.
Ha a ShowReadOnly property-t igazra állítjuk, akkor az állomány megnyitó ablakban megjelenik egy Megnyitás csak olvasásra CheckBox is. Ezzel a felhasználó jelezheti alkalmazásunk felé, hogy az adott állomány csak olvasásra szeretné megnyitni. Hogy a felhasználó kiválasztotta-e ezt a lehetőséget, azt a ReadOnlyChecked property vizsgálatával dönthetjük el.
Ha a komponens InitialDirectory property-ébe megadunk egy tetszőleges alkönyvtárat, akkor a dialóg megjelenésekor ez lesz az aktuális.
A ShowHelp property igazra állításával egy Súgó gomb megjelenítését írhatjuk elő a dialóg ablakban. Ha a felhasználó erre kattint, akkor jön létre a komponens OnHelpRequested eseménye. Ezt felhasználva tetszőleges súgót jeleníthetünk meg az ablakhoz.
Ha a CheckFileExists igaz, akkor a dialóg ellenőrzi, hogy a megadott állomány létezik-e. Ha a CheckPathExists igaz, akkor pedig a megadott alkönyvtár létezőségét ellenőriztethetjük.