File.Create Methode
Definitie
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.
Hiermee wordt een bestand in het opgegeven pad gemaakt of afgekapt en overschreven.
Overloads
| Name | Description |
|---|---|
| Create(String) |
Hiermee wordt een bestand in het opgegeven pad gemaakt of afgekapt en overschreven. |
| Create(String, Int32) |
Hiermee wordt een bestand in het opgegeven pad gemaakt of afgekapt en overschreven, waarbij een buffergrootte wordt opgegeven. |
| 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, 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)
Hiermee wordt een bestand in het opgegeven pad gemaakt of afgekapt en overschreven.
public:
static System::IO::FileStream ^ Create(System::String ^ path);
public static System.IO.FileStream Create(string path);
static member Create : string -> System.IO.FileStream
Public Shared Function Create (path As String) As FileStream
Parameters
- path
- String
Het pad en de naam van het bestand dat u wilt maken.
Retouren
Een FileStream die lees-/schrijftoegang biedt tot het bestand dat is opgegeven in path.
Uitzonderingen
De beller heeft niet de vereiste machtiging.
– of –
path een bestand opgegeven dat het kenmerk Alleen-lezen heeft.
– of –
path een bestand opgegeven dat verborgen is.
.NET Framework en .NET Core-versies ouder dan 2.1: path is een tekenreeks met lengte nul, bevat alleen witruimte of bevat een of meer ongeldige tekens. U kunt een query uitvoeren op ongeldige tekens met behulp van de GetInvalidPathChars() methode.
path is null.
Het opgegeven pad, de bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximumlengte.
Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).
Er is een I/O-fout opgetreden tijdens het maken van het bestand.
path heeft een ongeldige indeling.
Voorbeelden
In het volgende voorbeeld wordt een bestand in het opgegeven pad gemaakt, worden enkele gegevens naar het bestand geschreven en wordt gelezen uit het bestand.
using System;
using System.IO;
using System.Text;
class Test
{
public static void Main()
{
string path = @"c:\temp\MyTest.txt";
try
{
// Create the file, or overwrite if the file exists.
using (FileStream fs = File.Create(path))
{
byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
// Add some information to the file.
fs.Write(info, 0, info.Length);
}
// Open the stream and read it back.
using (StreamReader sr = File.OpenText(path))
{
string s = "";
while ((s = sr.ReadLine()) != null)
{
Console.WriteLine(s);
}
}
}
catch (Exception ex)
{
Console.WriteLine(ex.ToString());
}
}
}
open System.IO
open System.Text
let path = @"c:\temp\MyTest.txt"
// Create the file, or overwrite if the file exists.
do
use fs = File.Create path
let info =
UTF8Encoding(true)
.GetBytes "This is some text in the file."
// Add some information to the file.
fs.Write(info, 0, info.Length)
// Open the stream and read it back.
do
use sr = File.OpenText path
let mutable s = sr.ReadLine()
while isNull s |> not do
printfn $"{s}"
s <- sr.ReadLine()
Imports System.IO
Imports System.Text
Public Class Test
Public Shared Sub Main()
Dim path As String = "c:\temp\MyTest.txt"
Try
' Create the file, or overwrite if the file exists.
Using fs As FileStream = File.Create(path)
Dim info As Byte() = New UTF8Encoding(True).GetBytes("This is some text in the file.")
' Add some information to the file.
fs.Write(info, 0, info.Length)
End Using
' Open the stream and read it back.
Using sr As StreamReader = File.OpenText(path)
Do While sr.Peek() >= 0
Console.WriteLine(sr.ReadLine())
Loop
End Using
Catch ex As Exception
Console.WriteLine(ex.ToString())
End Try
End Sub
End Class
Opmerkingen
Het FileStream object dat door deze methode is gemaakt, heeft een standaardwaarde FileShare ; Noneer is geen ander proces of code die toegang heeft tot het gemaakte bestand totdat de oorspronkelijke bestandsingang is gesloten.
Deze methode is gelijk aan de overbelasting van de Create(String, Int32) methode met behulp van de standaardbuffergrootte van 4096 bytes.
De path parameter mag relatieve of absolute padgegevens opgeven. Relatieve padinformatie wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap. Als u de huidige werkmap wilt ophalen, raadpleegt GetCurrentDirectoryu .
Als het opgegeven bestand niet bestaat, wordt het gemaakt; als deze bestaat en niet alleen-lezen is, wordt de inhoud verwijderd en overschreven.
Standaard wordt volledige lees-/schrijftoegang tot nieuwe bestanden verleend aan alle gebruikers. Het bestand wordt geopend met lees-/schrijftoegang en moet worden gesloten voordat het kan worden geopend door een andere toepassing.
Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.
Zie ook
- Bestands- en Stream-I/O
- Tekst lezen uit een bestand
- Procedure: Tekst naar een bestand schrijven
- Procedure: lezen en schrijven naar een nieuw gegevensbestand
Van toepassing op
Create(String, Int32)
Hiermee wordt een bestand in het opgegeven pad gemaakt of afgekapt en overschreven, waarbij een buffergrootte wordt opgegeven.
public:
static System::IO::FileStream ^ Create(System::String ^ path, int bufferSize);
public static System.IO.FileStream Create(string path, int bufferSize);
static member Create : string * int -> System.IO.FileStream
Public Shared Function Create (path As String, bufferSize As Integer) As FileStream
Parameters
- path
- String
Het pad en de naam van het bestand dat u wilt maken.
- bufferSize
- Int32
Het aantal bytes dat wordt gebufferd voor lees- en schrijfbewerkingen naar het bestand.
Retouren
Een FileStream met de opgegeven buffergrootte die lees-/schrijftoegang biedt tot het bestand dat is opgegeven in path.
Uitzonderingen
De beller heeft niet de vereiste machtiging.
– of –
path een bestand opgegeven dat het kenmerk Alleen-lezen heeft.
– of –
path een bestand opgegeven dat verborgen is.
.NET Framework en .NET Core-versies ouder dan 2.1: path is een tekenreeks met lengte nul, bevat alleen witruimte of bevat een of meer ongeldige tekens. U kunt een query uitvoeren op ongeldige tekens met behulp van de GetInvalidPathChars() methode.
path is null.
Het opgegeven pad, de bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximumlengte.
Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).
Er is een I/O-fout opgetreden tijdens het maken van het bestand.
path heeft een ongeldige indeling.
Voorbeelden
In het volgende voorbeeld wordt een bestand gemaakt met de opgegeven buffergrootte.
using System;
using System.IO;
using System.Text;
class Test
{
public static void Main()
{
string path = @"c:\temp\MyTest.txt";
// Create the file, or overwrite if the file exists.
using (FileStream fs = File.Create(path, 1024))
{
byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
// Add some information to the file.
fs.Write(info, 0, info.Length);
}
// Open the stream and read it back.
using (StreamReader sr = File.OpenText(path))
{
string s = "";
while ((s = sr.ReadLine()) != null)
{
Console.WriteLine(s);
}
}
}
}
open System.IO
open System.Text
let path = @"c:\temp\MyTest.txt"
// Create the file, or overwrite if the file exists.
do
use fs = File.Create(path, 1024)
let info =
UTF8Encoding(true)
.GetBytes "This is some text in the file."
// Add some information to the file.
fs.Write(info, 0, info.Length)
// Open the stream and read it back.
do
use sr = File.OpenText path
let mutable s = sr.ReadLine()
while isNull s |> not do
printfn $"{s}"
s <- sr.ReadLine()
Imports System.IO
Imports System.Text
Public Class Test
Public Shared Sub Main()
Dim path As String = "c:\temp\MyTest.txt"
Try
' Create the file, or overwrite if the file exists.
Using fs As FileStream = File.Create(path, 1024)
Dim info As Byte() = New UTF8Encoding(True).GetBytes("This is some text in the file.")
' Add some information to the file.
fs.Write(info, 0, info.Length)
End Using
' Open the stream and read it back.
Using sr As StreamReader = File.OpenText(path)
Do While sr.Peek() >= 0
Console.WriteLine(sr.ReadLine())
Loop
End Using
Catch ex As Exception
Console.WriteLine(ex.ToString())
End Try
End Sub
End Class
Opmerkingen
Het FileStream object dat door deze methode is gemaakt, heeft een standaardwaarde FileShare ; Noneer is geen ander proces of code die toegang heeft tot het gemaakte bestand totdat de oorspronkelijke bestandsingang is gesloten.
De path parameter mag relatieve of absolute padgegevens opgeven. Relatieve padinformatie wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap. Als u de huidige werkmap wilt ophalen, raadpleegt GetCurrentDirectoryu .
Deze methode is gelijk aan de overbelasting van de FileStream(String, FileMode, FileAccess, FileShare, Int32) constructor. Als het opgegeven bestand niet bestaat, wordt het gemaakt; als deze bestaat en niet alleen-lezen is, wordt de inhoud vervangen.
Standaard wordt volledige lees-/schrijftoegang tot nieuwe bestanden verleend aan alle gebruikers. Het bestand wordt geopend met lees-/schrijftoegang en moet worden gesloten voordat het kan worden geopend door een andere toepassing.
Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.
Zie ook
- Bestands- en Stream-I/O
- Tekst lezen uit een bestand
- Procedure: Tekst naar een bestand schrijven
- Procedure: lezen en schrijven naar een nieuw gegevensbestand
Van toepassing op
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.
public:
static System::IO::FileStream ^ Create(System::String ^ path, int bufferSize, System::IO::FileOptions options);
public static System.IO.FileStream Create(string path, int bufferSize, System.IO.FileOptions options);
static member Create : string * int * System.IO.FileOptions -> System.IO.FileStream
Public Shared Function Create (path As String, bufferSize As Integer, options As FileOptions) As FileStream
Parameters
- path
- String
Het pad en de naam van het bestand dat u wilt maken.
- bufferSize
- Int32
Het aantal bytes dat wordt gebufferd voor lees- en schrijfbewerkingen naar het bestand.
- options
- FileOptions
Een van de FileOptions waarden waarin wordt beschreven hoe u het bestand maakt of overschrijft.
Retouren
Een nieuw bestand met de opgegeven buffergrootte.
Uitzonderingen
De beller heeft niet de vereiste machtiging.
– of –
path een bestand opgegeven dat het kenmerk Alleen-lezen heeft.
– of –
path een bestand opgegeven dat verborgen is.
.NET Framework en .NET Core-versies ouder dan 2.1: path is een tekenreeks met lengte nul, bevat alleen witruimte of bevat een of meer ongeldige tekens. U kunt een query uitvoeren op ongeldige tekens met behulp van de GetInvalidPathChars() methode.
path is null.
Het opgegeven pad, de bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximumlengte.
Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station.
Er is een I/O-fout opgetreden tijdens het maken van het bestand.
path heeft een ongeldige indeling.
Opmerkingen
De path parameter mag relatieve of absolute padgegevens opgeven. Relatieve padinformatie wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap. Als u de huidige werkmap wilt ophalen, raadpleegt GetCurrentDirectoryu .
Deze methode is gelijk aan de overbelasting van de FileStream(String, FileMode, FileAccess, FileShare, Int32) constructor. Als het opgegeven bestand niet bestaat, wordt het gemaakt; als deze bestaat en niet alleen-lezen is, wordt de inhoud vervangen.
Standaard wordt volledige lees-/schrijftoegang tot nieuwe bestanden verleend aan alle gebruikers. Het bestand wordt geopend met lees-/schrijftoegang en moet worden gesloten voordat het kan worden geopend door een andere toepassing.
Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.
Van toepassing op
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.
public:
static System::IO::FileStream ^ Create(System::String ^ path, int bufferSize, System::IO::FileOptions options, System::Security::AccessControl::FileSecurity ^ fileSecurity);
public static System.IO.FileStream Create(string path, int bufferSize, System.IO.FileOptions options, System.Security.AccessControl.FileSecurity fileSecurity);
static member Create : string * int * System.IO.FileOptions * System.Security.AccessControl.FileSecurity -> System.IO.FileStream
Public Shared Function Create (path As String, bufferSize As Integer, options As FileOptions, fileSecurity As FileSecurity) As FileStream
Parameters
- path
- String
Het pad en de naam van het bestand dat u wilt maken.
- bufferSize
- Int32
Het aantal bytes dat wordt gebufferd voor lees- en schrijfbewerkingen naar het bestand.
- options
- FileOptions
Een van de FileOptions waarden waarin wordt beschreven hoe u het bestand maakt of overschrijft.
- fileSecurity
- FileSecurity
Een FileSecurity object dat de beveiliging van toegangsbeheer en controle voor het bestand bepaalt.
Retouren
Een nieuw bestand met de opgegeven buffergrootte, bestandsopties en bestandsbeveiliging.
Uitzonderingen
De beller heeft niet de vereiste machtiging.
– of –
path een bestand opgegeven dat het kenmerk Alleen-lezen heeft.
– of –
path een bestand opgegeven dat verborgen is.
.NET Framework en .NET Core-versies ouder dan 2.1: path is een tekenreeks met lengte nul, bevat alleen witruimte of bevat een of meer ongeldige tekens. U kunt een query uitvoeren op ongeldige tekens met behulp van de GetInvalidPathChars() methode.
path is null.
Het opgegeven pad, de bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximumlengte.
Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).
Er is een I/O-fout opgetreden tijdens het maken van het bestand.
path heeft een ongeldige indeling.
Opmerkingen
De path parameter mag relatieve of absolute padgegevens opgeven. Relatieve padinformatie wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap. Als u de huidige werkmap wilt ophalen, raadpleegt GetCurrentDirectoryu .
Deze methode is gelijk aan de overbelasting van de FileStream(String, FileMode, FileAccess, FileShare, Int32) constructor. Als het opgegeven bestand niet bestaat, wordt het gemaakt; als deze bestaat en niet alleen-lezen is, wordt de inhoud vervangen.
Standaard wordt volledige lees-/schrijftoegang tot nieuwe bestanden verleend aan alle gebruikers. Het bestand wordt geopend met lees-/schrijftoegang en moet worden gesloten voordat het kan worden geopend door een andere toepassing.
Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.
Important
Deze methode is in de volgende vorm overgezet naar .NET Core 3.1: Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity).