Ezt a segítséget a File osztálytól kapjuk meg, mely számos statikus függvénnyel rendelkezik, így használatuk igen egyszerű:
AppendText
Osztály: System.IO.File
Public Shared Function AppendText( _
ByVal path As String _
) As StreamWriter
Egy szöveges állományt nyithatunk meg olyan célból, hogy adatokat írjunk az állományhoz.
Paraméterek
ByVal path As String
A megnyitandó állomány nevét, szükség esetén elérési útvonalát kell a path paraméterben megadnunk.
Visszatérési érték
Kapunk egy StreamWriter osztály példányt, melynek segítségével elvégezhetünk állományba történő írási műveleteket.
Copy
Osztály: System.IO.File
Overloads Public Shared Sub Copy( _
ByVal sourceFileName As String, _
ByVal destFileName As String
)
Egy már meglévő állományt másolhatunk egy másik helyre.
Paraméterek
ByVal sourceFileName As String
A másolandó állomány nevét, elérési útját adjuk meg a sourceFileName paraméterben.
ByVal destFileName As String
Az új állomány nevét és új elérési útját adjuk meg a destFileName paraméterben.
Megjegyzés
Ha a destFileName-ben megadott állomány már létezik, akkor hiba keletkezik.
Copy
Osztály: System.IO.File
Overloads Public Shared Sub Copy( _
ByVal sourceFileName As String, _
ByVal destFileName As String, _
ByVal overwrite As Boolean _
)
Egy már meglévő állományt másolhatunk egy másik helyre.
Paraméterek
ByVal sourceFileName As String
A másolandó állomány nevét, elérési útját adjuk meg a sourceFileName paraméterben.
ByVal destFileName As String
Az új állomány nevét és új elérési útját adjuk meg a destFileName paraméterben.
ByVal overwrite As Boolean
Ha az overwrite paraméter igaz és a destFileName paraméterben megadott állomány már létezik, akkor az figyelmeztetés nélkül felül lesz írva a sourceFileName paraméterben megadott állománnyal.
Create
Osztály: System.IO.File
public static FileStream Create(
string path
);
Új állományt hozhatunk létre a Create függvény hívásával.
Paraméterek
string path
A létrehozandó állomány elérési útvonalát és nevét adhatjuk meg.
Visszatérési érték
Egy FileStream osztály példányát kapjuk, melyen keresztül elvégezhetjük a szükséges műveleteket az állományunkkal.
Create
Osztály: System.IO.File
public static FileStream Create(
string path,
int bufferSize
);
Új állományt hozhatunk létre a Create függvény hívásával.
Paraméterek
string path
A létrehozandó állomány elérési útvonalát és nevét adhatjuk meg.
int bufferSize
A bufferSize paraméterben megadhatjuk, hogy mekkora kezdeti memóriaterület legyen lefoglalva az állomány kezeléséhez.
Visszatérési érték
Egy FileStream osztály példányát kapjuk, melyen keresztül elvégezhetjük a szükséges műveleteket az állományunkkal.
CreateText
Osztály: System.IO.File
Overloads Public Shared Function Create( _
ByVal path As String
) As FileStream
Új szöveges állományt hozhatunk létre a Create függvény hívásával.
Paraméterek
ByVal path As String
A létrehozandó állomány elérési útvonalát és nevét adhatjuk meg.
Visszatérési érték
Egy StreamWriter osztály példányát kapjuk, melyen keresztül elvégezhetjük a szükséges műveleteket az állományunkkal.
Delete
Osztály: System.IO.File
Public Shared Sub Delete( _
ByVal path As String _
)
Egy meglévő állomány törlését végezhetjük el a Delete függvénnyel.
Paraméterek
ByVal path As String
A törlendő állomány elérési útvonalát és nevét adhatjuk meg.
Exists
Osztály: System.IO.File
Public Shared Function Exists( _
ByVal path As String _
) As Boolean
Egy állomány meglétét ellenőrizhetjük az Exists függvénnyel.
Paraméterek
ByVal path As String
Az ellenőrizendő állomány elérési útvonalát és nevét adhatjuk meg.
Visszatérési érték
Igaz, ha a path paraméterben megadott állomány létezik.
GetAttributes
Osztály: System.IO.File
Public Shared Function GetAttributes( _
ByVal path As String _
) As FileAttributes
Egy állomány attribútumait kérdezhetjük le a GetAttributes függvénnyel.
Paraméterek
ByVal path As String
A szükséges állomány elérési útvonalát és nevét adhatjuk meg.
Visszatérési érték
Az állomány attribútumait kapjuk meg FileAttributes típusban, melynek a lehetséges értékei az alábbiak:
- Archive
- Compressed
- Device
- Directory
- Encrypted
- Hidden
- Normal
- NotContentIndexed
- Offline
- ReadOnly
- ReparsePoint
- SparseFile
- System
- Temporary
GetCreationTime
Osztály: System.IO.File
Public Shared Function GetCreationTime( _
ByVal path As String _
) As DateTime
Egy állomány létrehozásának időpontját kérdezhetjük le a GetCreationTime függvénnyel.
Paraméterek
ByVal path As String
A szükséges állomány elérési útvonalát és nevét adhatjuk meg.
Visszatérési érték
DateTime típusban megkapjuk a path paraméterben megadott állomány létrehozásának időpontját.
GetLastAccessTime
Osztály: System.IO.File
Public Shared Function GetLastAccessTime( _
ByVal path As String _
) As DateTime
Egy állomány utolsó hozzáférésének időpontját kérdezhetjük le a GetLastAccessTime függvénnyel.
Paraméterek
ByVal path As String
A szükséges állomány elérési útvonalát és nevét adhatjuk meg.
Visszatérési érték
DateTime típusban megkapjuk a path paraméterben megadott állomány utolsó hozzáférésének időpontját.
GetLastWriteTime
Osztály: System.IO.File
Public Shared Function GetLastWriteTime( _
ByVal path As String _
) As DateTime
Egy állomány módosításának időpontját kérdezhetjük le a GetLastWriteTime függvénnyel.
Paraméterek
ByVal path As String
A szükséges állomány elérési útvonalát és nevét adhatjuk meg.
Visszatérési érték
DateTime típusban megkapjuk a path paraméterben megadott állomány módosításának időpontját.
Move
Osztály: System.IO.File
Public Shared Sub Move( _
ByVal sourceFileName As String, _
ByVal destFileName As String _
)
Egy állományt új helyre mozgathatunk, vagy átnevezhetünk a Move függvény hívásával.
Paraméterek
ByVal sourceFileName As String
A mozgatandó állomány elérési útvonala és neve.
ByVal destFileName As String
Az új állomány elérési útvonala és neve.
Open
Osztály: System.IO.File
Overloads Public Shared Function Open( _
ByVal path As String, _
ByVal mode As FileMode _
) As FileStream
Egy állomány megnyitására, létrehozására használhatjuk az Open függvényt.
Paraméterek
ByVal path As String
A megnyitandó állomány elérési útvonalát és nevét adhatjuk meg.
ByVal mode As FileMode
| Megnevezés |
Leírás |
| Append |
Már létező állomány kerül megnyitásra, hozzáírásra. Megnyitás után az állomány mutatója annak végére mutat, így egy írási művelet rögtön az állomány végére ír. |
| Create |
Új állomány kerül létrehozásra és megnyitásra. Ha már létezett, akkor az felülírásra kerül. |
| CreateNew |
Új állomány kerül létrehozásra. Ha már létezett, akkor hiba keletkezik. |
| Open |
Már létező állomány kerül megnyitásra, olvasásra. |
| OpenOrCreate |
Ha létezik a megadott állomány, akkor meg lesz nyitva, ha még nem, akkor létre lesz hozva. |
| Truncate |
Meglévő állomány kerül megnyitásra, de annak tartalma törölve lesz, így megnyitás után egy nulla bájt hosszú állománnyal dolgozhatunk. |
Visszatérési érték
Kapunk egy FileStream osztály példányt, melyen keresztül elvégezhetjük a szükséges állományműveleteket.
Open
Osztály: System.IO.File
Overloads Public Shared Function Open( _
ByVal path As String, _
ByVal mode As FileMode, _
ByVal access As FileAccess
) As FileStream
Egy állomány megnyitására, létrehozására használhatjuk az Open függvényt.
Paraméterek
ByVal path As String
A megnyitandó állomány elérési útvonalát és nevét adhatjuk meg.
ByVal mode As FileMode
| Megnevezés |
Leírás |
| Append |
Már létező állomány kerül megnyitásra, hozzáírásra. Megnyitás után az állomány mutatója annak végére mutat, így egy írási művelet rögtön az állomány végére ír. |
| Create |
Új állomány kerül létrehozásra és megnyitásra. Ha már létezett, akkor az felülírásra kerül. |
| CreateNew |
Új állomány kerül létrehozásra. Ha már létezett, akkor hiba keletkezik. |
| Open |
Már létező állomány kerül megnyitásra, olvasásra. |
| OpenOrCreate |
Ha létezik a megadott állomány, akkor meg lesz nyitva, ha még nem, akkor létre lesz hozva. |
| Truncate |
Meglévő állomány kerül megnyitásra, de annak tartalma törölve lesz, így megnyitás után egy nulla bájt hosszú állománnyal dolgozhatunk. |
ByVal access As FileAccess
| Megnevezés |
Leírás |
| Read |
Csak olvasható lesz az állomány. |
| ReadWrite |
Olvasható, írható lesz az állomány. |
| Write |
Csak írható lesz az állomány. |
Visszatérési érték
Kapunk egy FileStream osztály példányt, melyen keresztül elvégezhetjük a szükséges állományműveleteket.
Open
Osztály: System.IO.File
Overloads Public Shared Function Open( _
ByVal path As String, _
ByVal mode As FileMode, _
ByVal access As FileAccess, _
ByVal share As FileShare _
) As FileStream
Egy állomány megnyitására, létrehozására használhatjuk az Open függvényt.
Paraméterek
ByVal path As String
A megnyitandó állomány elérési útvonalát és nevét adhatjuk meg.
ByVal mode As FileMode
| Megnevezés |
Leírás |
| Append |
Már létező állomány kerül megnyitásra, hozzáírásra. Megnyitás után az állomány mutatója annak végére mutat, így egy írási művelet rögtön az állomány végére ír. |
| Create |
Új állomány kerül létrehozásra és megnyitásra. Ha már létezett, akkor az felülírásra kerül. |
| CreateNew |
Új állomány kerül létrehozásra. Ha már létezett, akkor hiba keletkezik. |
| Open |
Már létező állomány kerül megnyitásra, olvasásra. |
| OpenOrCreate |
Ha létezik a megadott állomány, akkor meg lesz nyitva, ha még nem, akkor létre lesz hozva. |
| Truncate |
Meglévő állomány kerül megnyitásra, de annak tartalma törölve lesz, így megnyitás után egy nulla bájt hosszú állománnyal dolgozhatunk. |
ByVal access As FileAccess
| Megnevezés |
Leírás |
| Read |
Csak olvasható lesz az állomány. |
| ReadWrite |
Olvasható, írható lesz az állomány. |
| Write |
Csak írható lesz az állomány. |
ByVal share As FileShare
| Megnevezés |
Leírás |
| None |
Nem kerül megosztásra az állomány, sem a saját, sem más folyamat nem férhet hozzá annak lezárásáig. |
| Read |
Más folyamat is megnyithatja az állományt, de csak olvashat belőle. |
| ReadWrite |
Más folyamat is olvashat, írhat az állományba. |
| Write |
Más folyamat is megnyithatja az állományt, de csak írhat abba. |
Visszatérési érték
Kapunk egy FileStream osztály példányt, melyen keresztül elvégezhetjük a szükséges állományműveleteket.
OpenRead
Osztály: System.IO.File
Public Shared Function OpenRead( _
ByVal path As String _
) As FileStream
Megnyithatunk egy állományt csak olvasásra az OpenRead függvénnyel.
Paraméterek
ByVal path As String
A megnyitandó állomány elérési útvonalát és nevét adhatjuk meg.
Visszatérési érték
Kapunk egy FileStream osztály példányt, melyen keresztül elvégezhetjük a szükséges állományműveleteket.
Megjegyzés
Ez a megnyitás egyezik a következő paraméterekkel történő Open hívásával: FileMode.Open, FileAccess.Read, FileShare.Read.
OpenText
Osztály: System.IO.File
Public Shared Function OpenText( _
ByVal path As String _
) As StreamReader
Megnyithatunk egy UTF-8 kódolású szöveges állományt csak olvasásra.
Paraméterek
ByVal path As String
A megnyitandó állomány elérési útvonalát és nevét adhatjuk meg.
Visszatérési érték
Kapunk egy StreamReader osztály példányt, melyen keresztül elvégezhetjük a szükséges állományműveleteket.
OpenWrite
Osztály: System.IO.File
Public Shared Function OpenWrite( _
ByVal path As String _
) As FileStream
Megnyithatunk egy állományt csak írásra az OpenWrite függvénnyel.
Paraméterek
ByVal path As String
A megnyitandó állomány elérési útvonalát és nevét adhatjuk meg.
Visszatérési érték
Kapunk egy FileStream osztály példányt, melyen keresztül elvégezhetjük a szükséges állományműveleteket.
Megjegyzés
Ez a megnyitás egyezik a következő paraméterekkel történő Open hívásával: FileMode.OpenOrCreate, FileAccess.Write, FileShare.None.
SetAttributes
Osztály: System.IO.File
Public Shared Sub SetAttributes( _
ByVal path As String, _
ByVal fileAttributes As FileAttributes _
)
Egy állomány attribútumait beállíthatjuk a SetAttributes függvény hívásával.
Paraméterek
ByVal path As String
A szükséges állomány elérési útvonalát és nevét adhatjuk meg.
ByVal fileAttributes As FileAttributes
- Archive
- Compressed
- Device
- Directory
- Encrypted
- Hidden
- Normal
- NotContentIndexed
- Offline
- ReadOnly
- ReparsePoint
- SparseFile
- System
- Temporary
Megjegyzés
Több attribútum egyidejűleg is beállítható azok kombinációjával:
File.SetAttributes(label2.Text + "a.txt", FileAttributes.ReadOnly Or FileAttributes.Hidden)
SetCreationTime
Osztály: System.IO.File
Public Shared Sub SetCreationTime( _
ByVal path As String, _
ByVal creationTime As DateTime _
)
Egy állomány létrehozási időpontja beállítható a SetCreationTime függvénnyel.
Paraméterek
ByVal path As String
A szükséges állomány elérési útvonalát és nevét adhatjuk meg.
ByVal creationTime As DateTime
A beállítandó időpontot adjuk meg a creationTime paraméterben.
SetLastAccessTime
Osztály: System.IO.File
Public Shared Sub SetLastAccessTime( _
ByVal path As String, _
ByVal lastAccessTime As DateTime _
)
Egy állomány utolsó hozzáférési időpontja beállítható a SetLastAccessTime függvénnyel.
Paraméterek
ByVal path As String
A szükséges állomány elérési útvonalát és nevét adhatjuk meg.
ByVal lastAccessTime As DateTime
A beállítandó időpontot adjuk meg a lastAccessTime paraméterben.
SetLastWriteTime
Osztály: System.IO.File
Public Shared Sub SetLastWriteTime( _
ByVal path As String, _
ByVal lastWriteTime As DateTime _
)
Egy állomány módosítási időpontja beállítható a SetLastAccessTime függvénnyel.
Paraméterek
ByVal path As String
A szükséges állomány elérési útvonalát és nevét adhatjuk meg.
ByVal lastWriteTime As DateTime
A beállítandó időpontot adjuk meg a lastWriteTime paraméterben.
A példaprogram
Térjünk át most a gyakorlatra és nézzük meg, hogy miként is használható fel a File osztály nyújtotta lehetőségek. Mellékelt példában létrehozunk egy A és B nevű mappát. Az A-ban létrehozunk egy szöveges állományt, melyet másolunk a B-be és különféle műveleteket hajtunk végre a létrejött állományokon.
1. gomb
Létrehozunk egy 1.txt nevű állományt az A mappába.
Private Sub button1_Click(sender As Object, e As System.EventArgs) Handles button1.Click
sw = File.CreateText((label1.Text + "1.txt"))
listBox1.Items.Add("CreateText 1.txt")
End Sub 'button1_Click
2. gomb
Az imént létrehozott 1.txt-be írunk a StreamWriter osztály segítségével, majd lezárjuk azt.
Private Sub button2_Click(sender As Object, e As System.EventArgs) Handles button2.Click
sw.WriteLine("http://www.SoftwareOnline.hu")
sw.Close()
listBox1.Items.Add("StreamWriter.WriteLine")
End Sub 'button2_Click
3. gomb
Az 1.txt-t másoljuk át a B mappába a.txt és b.txt állományokba.
Private Sub button3_Click(sender As Object, e As System.EventArgs) Handles button3.Click
File.Copy(label1.Text + "1.txt", label2.Text + "a.txt")
File.Copy(label1.Text + "1.txt", label2.Text + "b.txt")
listBox1.Items.Add("Copy a.txt, b.txt")
End Sub 'button3_Click
4. gomb
Ellenőrizzük, hogy létezik-e a b.txt és ha igen töröljük azt.
Private Sub button4_Click(sender As Object, e As System.EventArgs) Handles button4.Click
If File.Exists((label2.Text + "b.txt")) Then
File.Delete((label2.Text + "b.txt"))
listBox1.Items.Add("Delete b.txt")
End If
End Sub 'button4_Click
5. gomb
Az AppendText hívásával megnyitjuk az 1.txt és hozzáírunk még egy sornyi szöveget.
Private Sub button5_Click(sender As Object, e As System.EventArgs) Handles button5.Click
Dim writer As StreamWriter = File.AppendText((label1.Text + "1.txt"))
writer.WriteLine("http://www.HardwareOnline.hu")
writer.Close()
listBox1.Items.Add("AppendText 1.txt")
End Sub 'button5_Click
6. gomb
Az a.txt-re beállítjuk a csak olvasható és rejtett attribútumokat.
Private Sub button6_Click(sender As Object, e As System.EventArgs) Handles button6.Click
File.SetAttributes(label2.Text + "a.txt", FileAttributes.ReadOnly Or FileAttributes.Hidden)
listBox1.Items.Add("SetAttributes a.txt")
End Sub 'button6_Click
7. gomb
Ellenőrzésképpen le is kérdezzük, hogy az a.txt milyen attribútumokkal rendelkezik.
Private Sub button7_Click(sender As Object, e As System.EventArgs) Handles button7.Click
Dim fa As FileAttributes = File.GetAttributes((label2.Text + "a.txt"))
listBox1.Items.Add(("GetAttributes a.txt: " + fa.ToString()))
End Sub 'button7_Click
8. gomb
Végül az 1.txt-nek megváltozhatjuk a létrehozási időpontját egy általunk kiválasztott dátumra. (A Windows Intézőjében az utolsó módosítás időpontja látható alapértelmezett helyzetben, így ha ellenőrizni akarjuk a létrehozás időpontját, akkor ennek láthatóságát külön kell engedélyeznünk az Intézőben.)
Private Sub button8_Click(sender As Object, e As System.EventArgs) Handles button8.Click
Dim dt As New DateTime(2001, 6, 29, 16, 30, 0)
File.SetCreationTime(label1.Text + "1.txt", dt)
listBox1.Items.Add("SetCreationTime 1.txt")
End Sub 'button8_Click