File Klas

Definitie

Naamruimte:: System.IO

Assembly's:: mscorlib.dll, System.IO.FileSystem.dll

Assembly:: mscorlib.dll

Assembly:: System.IO.FileSystem.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Biedt statische methoden voor het maken, kopiëren, verwijderen, verplaatsen en openen van één bestand en helpt bij het maken van FileStream objecten.

public ref class File abstract sealed

public ref class File sealed

public static class File

public sealed class File

[System.Runtime.InteropServices.ComVisible(true)]
public static class File

type File = class

[<System.Runtime.InteropServices.ComVisible(true)>]
type File = class

Public Class File

Public NotInheritable Class File

Overname: Object
File

Kenmerken: ComVisibleAttribute

Voorbeelden

In het volgende voorbeeld ziet u hoe u de File klasse gebruikt om te controleren of er een bestand bestaat, en afhankelijk van het resultaat, een nieuw bestand maken en ernaar schrijven, of het bestaande bestand openen en ermee lezen. Voordat u de code uitvoert, maakt u een c:\temp map.

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";
        if (!File.Exists(path))
        {
            // Create a file to write to.
            using (StreamWriter sw = File.CreateText(path))
            {
                sw.WriteLine("Hello");
                sw.WriteLine("And");
                sw.WriteLine("Welcome");
            }
        }

        // Open the file to read from.
        using (StreamReader sr = File.OpenText(path))
        {
            string s;
            while ((s = sr.ReadLine()) != null)
            {
                Console.WriteLine(s);
            }
        }
    }
}

open System.IO

let path = @"c:\temp\MyTest.txt"

if File.Exists path |> not then
    // Create a file to write to.
    use sw = File.CreateText path
    sw.WriteLine "Hello"
    sw.WriteLine "And"
    sw.WriteLine "Welcome"

// Open the file to read from.
do
    use sr = File.OpenText path
    let mutable s = sr.ReadLine()

    while isNull s |> not do
        printfn $"{s}"
        s <- sr.ReadLine()

Imports System.IO

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        If File.Exists(path) = False Then
            ' Create a file to write to.
            Using sw As StreamWriter = File.CreateText(path)
                sw.WriteLine("Hello")
                sw.WriteLine("And")
                sw.WriteLine("Welcome")
           End Using
        End If

        ' Open the file to read from.
        Using sr As StreamReader = File.OpenText(path)
            Do While sr.Peek() >= 0
                Console.WriteLine(sr.ReadLine())
            Loop
        End Using
    End Sub
End Class

Opmerkingen

Gebruik de File klasse voor typische bewerkingen, zoals kopiëren, verplaatsen, hernoemen, maken, openen, verwijderen en toevoegen aan één bestand tegelijk. U kunt de File klasse ook gebruiken om bestandskenmerken of informatie op te halen en DateTime in te stellen met betrekking tot het maken, openen en schrijven van een bestand. Als u bewerkingen op meerdere bestanden wilt uitvoeren, raadpleegt Directory.GetFiles u of DirectoryInfo.GetFiles.

Veel van de File methoden retourneren andere I/O-typen wanneer u bestanden maakt of opent. U kunt deze andere typen gebruiken om een bestand verder te bewerken. Zie voor meer informatie specifieke File leden zoals OpenText, CreateTextof Create.

Omdat alle File methoden statisch zijn, kan het efficiënter zijn om een File methode te gebruiken dan een bijbehorende FileInfo instantiemethode als u slechts één actie wilt uitvoeren. Alle File methoden vereisen het pad naar het bestand dat u bewerkt.

De statische methoden van de File klasse voeren beveiligingscontroles uit op alle methoden. Als u een object meerdere keren opnieuw wilt gebruiken, kunt u overwegen om in plaats daarvan FileInfo de bijbehorende exemplaarmethode te gebruiken, omdat de beveiligingscontrole niet altijd nodig is.

Standaard wordt volledige lees-/schrijftoegang tot nieuwe bestanden verleend aan alle gebruikers.

In de volgende tabel worden de opsommingen beschreven die worden gebruikt om het gedrag van verschillende File methoden aan te passen.

Enumeration	Description
FileAccess	Hiermee geeft u lees- en schrijftoegang tot een bestand.
FileShare	Hiermee geeft u het toegangsniveau op dat is toegestaan voor een bestand dat al in gebruik is.
FileMode	Hiermee geeft u op of de inhoud van een bestaand bestand behouden of overschreven wordt en of aanvragen voor het maken van een bestaand bestand een uitzondering veroorzaken.

Note

In leden die een pad als invoertekenreeks accepteren, moet dat pad goed zijn gevormd of wordt er een uitzondering gegenereerd. Als een pad bijvoorbeeld volledig is gekwalificeerd, maar begint met een spatie, wordt het pad niet ingekort in methoden van de klasse. Het pad is daarom ongeldig en er wordt een uitzondering gegenereerd. Op dezelfde manier kan een pad of een combinatie van paden niet twee keer volledig worden gekwalificeerd. Met 'c:\temp c:\windows' wordt in de meeste gevallen ook een uitzondering gegenereerd. Zorg ervoor dat uw paden goed zijn opgemaakt wanneer u methoden gebruikt die een padtekenreeks accepteren.

In leden die een pad accepteren, kan het pad verwijzen naar een bestand of alleen een map. Het opgegeven pad kan ook verwijzen naar een relatief pad of een UNC-pad (Universal Naming Convention) voor een server en sharenaam. Zo zijn alle volgende acceptabele paden:

"c:\\\MyDir\\\MyFile.txt" in C# of "c:\MyDir\MyFile.txt" in Visual Basic.
"c:\\\MyDir" in C# of "c:\MyDir" in Visual Basic.
"MyDir\\\MySubdir" in C# of "MyDir\MySubDir" in Visual Basic.
"\\\\\\\MyServer\\\MyShare" in C# of "\\\MyServer\MyShare" in Visual Basic.

Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.

Methoden

Name	Description
AppendAllLines(String, IEnumerable<String>, Encoding)	Voegt regels toe aan een bestand met behulp van een opgegeven codering en sluit het bestand. Als het opgegeven bestand niet bestaat, maakt deze methode een bestand, schrijft de opgegeven regels naar het bestand en sluit het bestand.
AppendAllLines(String, IEnumerable<String>)	Voegt regels toe aan een bestand en sluit het bestand. Als het opgegeven bestand niet bestaat, maakt deze methode een bestand, schrijft de opgegeven regels naar het bestand en sluit het bestand.
AppendAllLinesAsync(String, IEnumerable<String>, CancellationToken)	Asynchroon voegt regels toe aan een bestand en sluit het bestand. Als het opgegeven bestand niet bestaat, maakt deze methode een bestand, schrijft de opgegeven regels naar het bestand en sluit het bestand.
AppendAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)	Asynchroon voegt lijnen toe aan een bestand met behulp van een opgegeven codering en sluit het bestand vervolgens. Als het opgegeven bestand niet bestaat, maakt deze methode een bestand, schrijft de opgegeven regels naar het bestand en sluit het bestand.
AppendAllText(String, String, Encoding)	Hiermee voegt u de opgegeven tekenreeks toe aan het bestand met behulp van de opgegeven codering, waardoor het bestand wordt gemaakt als het nog niet bestaat.
AppendAllText(String, String)	Hiermee opent u een bestand, voegt u de opgegeven tekenreeks toe aan het bestand en sluit u het bestand. Als het bestand niet bestaat, maakt deze methode een bestand, schrijft de opgegeven tekenreeks naar het bestand en sluit het bestand.
AppendAllTextAsync(String, String, CancellationToken)	Hiermee opent u asynchroon een bestand of maakt u een bestand als dit nog niet bestaat, voegt u de opgegeven tekenreeks toe aan het bestand en sluit u het bestand.
AppendAllTextAsync(String, String, Encoding, CancellationToken)	Hiermee opent u asynchroon een bestand of maakt u het bestand als het nog niet bestaat, voegt u de opgegeven tekenreeks toe aan het bestand met behulp van de opgegeven codering en sluit u het bestand.
AppendText(String)	Hiermee maakt u een StreamWriter tekst die UTF-8-gecodeerde tekst toevoegt aan een bestaand bestand of aan een nieuw bestand als het opgegeven bestand niet bestaat.
Copy(String, String, Boolean)	Hiermee kopieert u een bestaand bestand naar een nieuw bestand. Het overschrijven van een bestand met dezelfde naam is toegestaan.
Copy(String, String)	Hiermee kopieert u een bestaand bestand naar een nieuw bestand. Het overschrijven van een bestand met dezelfde naam is niet toegestaan.
Create(String, Int32, FileOptions, FileSecurity)	Hiermee maakt of overschrijft u een bestand in het opgegeven pad, geeft u een buffergrootte op, opties die beschrijven hoe u het bestand maakt of overschrijft, en een waarde die de beveiliging van toegangsbeheer en controle voor het bestand bepaalt.
Create(String, Int32, FileOptions)	Hiermee maakt of overschrijft u een bestand in het opgegeven pad, waarbij u een buffergrootte en opties opgeeft waarin wordt beschreven hoe u het bestand maakt of overschrijft.
Create(String, Int32)	Hiermee wordt een bestand in het opgegeven pad gemaakt of afgekapt en overschreven, waarbij een buffergrootte wordt opgegeven.
Create(String)	Hiermee wordt een bestand in het opgegeven pad gemaakt of afgekapt en overschreven.
CreateText(String)	Hiermee maakt of opent u een bestand voor het schrijven van gecodeerde UTF-8-tekst. Als het bestand al bestaat, wordt de inhoud ervan vervangen.
Decrypt(String)	Ontsleutelt een bestand dat is versleuteld door het huidige account met behulp van de Encrypt(String) methode.
Delete(String)	Hiermee verwijdert u het opgegeven bestand.
Encrypt(String)	Hiermee versleutelt u een bestand zodat alleen het account dat wordt gebruikt om het bestand te versleutelen, het kan ontsleutelen.
Exists(String)	Bepaalt of het opgegeven bestand bestaat.
GetAccessControl(String, AccessControlSections)	Hiermee wordt een FileSecurity object opgehaald dat het opgegeven type ACL-vermeldingen (Access Control List) voor een bepaald bestand inkapselt.
GetAccessControl(String)	Hiermee haalt u een FileSecurity object op dat de ACL-vermeldingen (Access Control List) voor een opgegeven bestand inkapselt.
GetAttributes(String)	Hiermee haalt u het FileAttributes bestand op het pad op.
GetCreationTime(String)	Retourneert de aanmaakdatum en -tijd van het opgegeven bestand of de opgegeven map.
GetCreationTimeUtc(String)	Retourneert de aanmaakdatum en -tijd, in Coordinated Universal Time (UTC), van het opgegeven bestand of de opgegeven map.
GetLastAccessTime(String)	Retourneert de datum en tijd waarop het opgegeven bestand of de opgegeven map voor het laatst is geopend.
GetLastAccessTimeUtc(String)	Retourneert de datum en tijd, in Coordinated Universal Time (UTC), dat het opgegeven bestand of de opgegeven map voor het laatst is geopend.
GetLastWriteTime(String)	Retourneert de datum en tijd waarop het opgegeven bestand of de opgegeven map voor het laatst naar is geschreven.
GetLastWriteTimeUtc(String)	Retourneert de datum en tijd, in Coordinated Universal Time (UTC), waarnaar het opgegeven bestand of de opgegeven map voor het laatst is geschreven.
Move(String, String)	Hiermee verplaatst u een opgegeven bestand naar een nieuwe locatie, met de optie om een nieuwe bestandsnaam op te geven.
Open(String, FileMode, FileAccess, FileShare)	Hiermee opent u een FileStream op het opgegeven pad met de opgegeven modus met lees-, schrijf- of lees-/schrijftoegang en de opgegeven optie voor delen.
Open(String, FileMode, FileAccess)	Hiermee opent u een FileStream op het opgegeven pad, met de opgegeven modus en toegang zonder delen.
Open(String, FileMode)	Hiermee opent u een FileStream op het opgegeven pad met lees-/schrijftoegang zonder delen.
OpenRead(String)	Hiermee opent u een bestaand bestand om te lezen.
OpenText(String)	Hiermee opent u een bestaand met UTF-8 gecodeerd tekstbestand voor lezen.
OpenWrite(String)	Hiermee opent u een bestaand bestand of maakt u een nieuw bestand voor schrijven.
ReadAllBytes(String)	Hiermee opent u een binair bestand, leest u de inhoud van het bestand in een bytematrix en sluit u het bestand.
ReadAllBytesAsync(String, CancellationToken)	Asynchroon opent u een binair bestand, leest de inhoud van het bestand in een bytematrix en sluit het bestand.
ReadAllLines(String, Encoding)	Hiermee opent u een bestand, leest u alle regels van het bestand met de opgegeven codering en sluit u het bestand.
ReadAllLines(String)	Hiermee opent u een tekstbestand, leest u alle regels van het bestand en sluit u het bestand.
ReadAllLinesAsync(String, CancellationToken)	Er wordt asynchroon een tekstbestand geopend, alle regels van het bestand gelezen en vervolgens het bestand gesloten.
ReadAllLinesAsync(String, Encoding, CancellationToken)	Hiermee opent u asynchroon een tekstbestand, leest u alle regels van het bestand met de opgegeven codering en sluit u het bestand.
ReadAllText(String, Encoding)	Hiermee opent u een bestand, leest u alle tekst in het bestand met de opgegeven codering en sluit u het bestand.
ReadAllText(String)	Hiermee opent u een tekstbestand, leest u alle tekst in het bestand en sluit u het bestand.
ReadAllTextAsync(String, CancellationToken)	Er wordt asynchroon een tekstbestand geopend, alle tekst in het bestand gelezen en vervolgens het bestand gesloten.
ReadAllTextAsync(String, Encoding, CancellationToken)	Asynchroon opent u een tekstbestand, leest alle tekst in het bestand met de opgegeven codering en sluit het bestand.
ReadLines(String, Encoding)	Lees de regels van een bestand met een opgegeven codering.
ReadLines(String)	Leest de regels van een bestand.
Replace(String, String, String, Boolean)	Hiermee vervangt u de inhoud van een opgegeven bestand door de inhoud van een ander bestand, verwijdert u het oorspronkelijke bestand en maakt u een back-up van het vervangen bestand en negeert u eventueel samenvoegfouten.
Replace(String, String, String)	Hiermee vervangt u de inhoud van een opgegeven bestand door de inhoud van een ander bestand, verwijdert u het oorspronkelijke bestand en maakt u een back-up van het vervangen bestand.
SetAccessControl(String, FileSecurity)	Hiermee past u ACL-vermeldingen (Access Control List) toe die worden beschreven door een FileSecurity object op het opgegeven bestand.
SetAttributes(String, FileAttributes)	Hiermee stelt u de opgegeven FileAttributes van het bestand op het opgegeven pad in.
SetCreationTime(String, DateTime)	Hiermee stelt u de datum en tijd in waarop het bestand is gemaakt.
SetCreationTimeUtc(String, DateTime)	Hiermee stelt u de datum en tijd in Coordinated Universal Time (UTC) in dat het bestand is gemaakt.
SetLastAccessTime(String, DateTime)	Hiermee stelt u de datum en tijd in waarop het opgegeven bestand voor het laatst is geopend.
SetLastAccessTimeUtc(String, DateTime)	Hiermee stelt u de datum en tijd in Coordinated Universal Time (UTC) in dat het opgegeven bestand voor het laatst is geopend.
SetLastWriteTime(String, DateTime)	Hiermee stelt u de datum en tijd in waarnaar het opgegeven bestand het laatst is geschreven.
SetLastWriteTimeUtc(String, DateTime)	Hiermee stelt u de datum en tijd in Coordinated Universal Time (UTC) in waarnaar het opgegeven bestand het laatst is geschreven.
WriteAllBytes(String, Byte[])	Hiermee maakt u een nieuw bestand, schrijft u de opgegeven bytematrix naar het bestand en sluit u het bestand. Als het doelbestand al bestaat, wordt het afgekapt en overschreven.
WriteAllBytesAsync(String, Byte[], CancellationToken)	Er wordt asynchroon een nieuw bestand gemaakt, de opgegeven bytematrix naar het bestand geschreven en vervolgens het bestand gesloten. Als het doelbestand al bestaat, wordt het afgekapt en overschreven.
WriteAllLines(String, IEnumerable<String>, Encoding)	Hiermee maakt u een nieuw bestand met behulp van de opgegeven codering, schrijft u een verzameling tekenreeksen naar het bestand en sluit u het bestand.
WriteAllLines(String, IEnumerable<String>)	Hiermee maakt u een nieuw bestand, schrijft u een verzameling tekenreeksen naar het bestand en sluit u het bestand.
WriteAllLines(String, String[], Encoding)	Hiermee maakt u een nieuw bestand, schrijft u de opgegeven tekenreeksmatrix naar het bestand met behulp van de opgegeven codering en sluit u het bestand.
WriteAllLines(String, String[])	Hiermee maakt u een nieuw bestand, schrijft u de opgegeven tekenreeksmatrix naar het bestand en sluit u het bestand.
WriteAllLinesAsync(String, IEnumerable<String>, CancellationToken)	Asynchroon maakt u een nieuw bestand, schrijft u de opgegeven regels naar het bestand en sluit u het bestand.
WriteAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)	Asynchroon maakt u een nieuw bestand, schrijft u de opgegeven regels naar het bestand met behulp van de opgegeven codering en sluit u het bestand.
WriteAllText(String, String, Encoding)	Hiermee maakt u een nieuw bestand, schrijft u de opgegeven tekenreeks naar het bestand met behulp van de opgegeven codering en sluit u het bestand. Als het doelbestand al bestaat, wordt het afgekapt en overschreven.
WriteAllText(String, String)	Hiermee maakt u een nieuw bestand, schrijft u de opgegeven tekenreeks naar het bestand en sluit u het bestand. Als het doelbestand al bestaat, wordt het afgekapt en overschreven.
WriteAllTextAsync(String, String, CancellationToken)	Er wordt asynchroon een nieuw bestand gemaakt, de opgegeven tekenreeks naar het bestand geschreven en vervolgens het bestand gesloten. Als het doelbestand al bestaat, wordt het afgekapt en overschreven.
WriteAllTextAsync(String, String, Encoding, CancellationToken)	Asynchroon maakt een nieuw bestand, schrijft de opgegeven tekenreeks naar het bestand met behulp van de opgegeven codering en sluit het bestand. Als het doelbestand al bestaat, wordt het afgekapt en overschreven.

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?