File.Create Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Skapar, eller trunkerar och skriver över, en fil i den angivna sökvägen.
Överlagringar
| Name | Description |
|---|---|
| Create(String) |
Skapar, eller trunkerar och skriver över, en fil i den angivna sökvägen. |
| Create(String, Int32) |
Skapar eller trunkerar och skriver över en fil i den angivna sökvägen och anger en buffertstorlek. |
| Create(String, Int32, FileOptions) |
Skapar eller skriver över en fil i den angivna sökvägen och anger en buffertstorlek och alternativ som beskriver hur du skapar eller skriver över filen. |
| Create(String, Int32, FileOptions, FileSecurity) |
Skapar eller skriver över en fil i den angivna sökvägen, anger en buffertstorlek, alternativ som beskriver hur du skapar eller skriver över filen och ett värde som avgör åtkomstkontroll och granskningssäkerhet för filen. |
Create(String)
Skapar, eller trunkerar och skriver över, en fil i den angivna sökvägen.
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
Parametrar
- path
- String
Sökvägen och namnet på filen som ska skapas.
Returer
En FileStream som ger läs-/skrivåtkomst till filen som anges i path.
Undantag
Anroparen har inte den behörighet som krävs.
-eller-
path har angett en fil som är skrivskyddad.
-eller-
path har angett en fil som är dold.
.NET Framework- och .NET Core-versioner som är äldre än 2.1: path är en sträng med noll längd, innehåller endast tomt utrymme eller innehåller ett eller flera ogiltiga tecken. Du kan fråga efter ogiltiga tecken med hjälp GetInvalidPathChars() av metoden .
path är null.
Den angivna sökvägen, filnamnet eller båda överskrider den systemdefinierade maximala längden.
Den angivna sökvägen är ogiltig (den finns till exempel på en ommappad enhet).
Ett I/O-fel uppstod när filen skapades.
path är i ett ogiltigt format.
Exempel
I följande exempel skapas en fil i den angivna sökvägen, skriver viss information till filen och läser från filen.
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
Kommentarer
Objektet FileStream som skapas med den här metoden har ett standardvärde FileShare på None; ingen annan process eller kod kan komma åt den skapade filen förrän det ursprungliga filhandtaget har stängts.
Den här metoden motsvarar Create(String, Int32) metodens överlagring med standardbuffertstorleken 4 096 byte.
Parametern path tillåts ange relativ eller absolut sökvägsinformation. Relativ sökvägsinformation tolkas som relativ till den aktuella arbetskatalogen. Information om hur du hämtar den aktuella arbetskatalogen finns i GetCurrentDirectory.
Om den angivna filen inte finns skapas den. Om den finns och den inte är skrivskyddad tas innehållet bort och skrivs över.
Som standard beviljas fullständig läs-/skrivåtkomst till nya filer till alla användare. Filen öppnas med läs-/skrivåtkomst och måste stängas innan den kan öppnas av ett annat program.
En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.
Se även
- Fil- och ström-I/O
- Läsa text från en fil
- Anvisningar: Skriva text till en fil
- Anvisningar: Läsa och skriva till en nyligen skapad datafil
Gäller för
Create(String, Int32)
Skapar eller trunkerar och skriver över en fil i den angivna sökvägen och anger en buffertstorlek.
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
Parametrar
- path
- String
Sökvägen och namnet på filen som ska skapas.
- bufferSize
- Int32
Antalet byte som buffrats för läsningar och skrivningar till filen.
Returer
A FileStream med den angivna buffertstorleken som ger läs-/skrivåtkomst till filen som anges i path.
Undantag
Anroparen har inte den behörighet som krävs.
-eller-
path har angett en fil som är skrivskyddad.
-eller-
path har angett en fil som är dold.
.NET Framework- och .NET Core-versioner som är äldre än 2.1: path är en sträng med noll längd, innehåller endast tomt utrymme eller innehåller ett eller flera ogiltiga tecken. Du kan fråga efter ogiltiga tecken med hjälp GetInvalidPathChars() av metoden .
path är null.
Den angivna sökvägen, filnamnet eller båda överskrider den systemdefinierade maximala längden.
Den angivna sökvägen är ogiltig (den finns till exempel på en ommappad enhet).
Ett I/O-fel uppstod när filen skapades.
path är i ett ogiltigt format.
Exempel
I följande exempel skapas en fil med den angivna buffertstorleken.
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
Kommentarer
Objektet FileStream som skapas med den här metoden har ett standardvärde FileShare på None; ingen annan process eller kod kan komma åt den skapade filen förrän det ursprungliga filhandtaget har stängts.
Parametern path tillåts ange relativ eller absolut sökvägsinformation. Relativ sökvägsinformation tolkas som relativ till den aktuella arbetskatalogen. Information om hur du hämtar den aktuella arbetskatalogen finns i GetCurrentDirectory.
Den här metoden motsvarar konstruktorns FileStream(String, FileMode, FileAccess, FileShare, Int32) överlagring. Om den angivna filen inte finns skapas den. Om den finns och den inte är skrivskyddad ersätts innehållet.
Som standard beviljas fullständig läs-/skrivåtkomst till nya filer till alla användare. Filen öppnas med läs-/skrivåtkomst och måste stängas innan den kan öppnas av ett annat program.
En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.
Se även
- Fil- och ström-I/O
- Läsa text från en fil
- Anvisningar: Skriva text till en fil
- Anvisningar: Läsa och skriva till en nyligen skapad datafil
Gäller för
Create(String, Int32, FileOptions)
Skapar eller skriver över en fil i den angivna sökvägen och anger en buffertstorlek och alternativ som beskriver hur du skapar eller skriver över filen.
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
Parametrar
- path
- String
Sökvägen och namnet på filen som ska skapas.
- bufferSize
- Int32
Antalet byte som buffrats för läsningar och skrivningar till filen.
- options
- FileOptions
Ett av de FileOptions värden som beskriver hur du skapar eller skriver över filen.
Returer
En ny fil med den angivna buffertstorleken.
Undantag
Anroparen har inte den behörighet som krävs.
-eller-
path har angett en fil som är skrivskyddad.
-eller-
path har angett en fil som är dold.
.NET Framework- och .NET Core-versioner som är äldre än 2.1: path är en sträng med noll längd, innehåller endast tomt utrymme eller innehåller ett eller flera ogiltiga tecken. Du kan fråga efter ogiltiga tecken med hjälp GetInvalidPathChars() av metoden .
path är null.
Den angivna sökvägen, filnamnet eller båda överskrider den systemdefinierade maximala längden.
Den angivna sökvägen är ogiltig (den finns till exempel på en ommappad enhet.
Ett I/O-fel uppstod när filen skapades.
path är i ett ogiltigt format.
Kommentarer
Parametern path tillåts ange relativ eller absolut sökvägsinformation. Relativ sökvägsinformation tolkas som relativ till den aktuella arbetskatalogen. Information om hur du hämtar den aktuella arbetskatalogen finns i GetCurrentDirectory.
Den här metoden motsvarar konstruktorns FileStream(String, FileMode, FileAccess, FileShare, Int32) överlagring. Om den angivna filen inte finns skapas den. Om den finns och den inte är skrivskyddad ersätts innehållet.
Som standard beviljas fullständig läs-/skrivåtkomst till nya filer till alla användare. Filen öppnas med läs-/skrivåtkomst och måste stängas innan den kan öppnas av ett annat program.
En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.
Gäller för
Create(String, Int32, FileOptions, FileSecurity)
Skapar eller skriver över en fil i den angivna sökvägen, anger en buffertstorlek, alternativ som beskriver hur du skapar eller skriver över filen och ett värde som avgör åtkomstkontroll och granskningssäkerhet för filen.
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
Parametrar
- path
- String
Sökvägen och namnet på filen som ska skapas.
- bufferSize
- Int32
Antalet byte som buffrats för läsningar och skrivningar till filen.
- options
- FileOptions
Ett av de FileOptions värden som beskriver hur du skapar eller skriver över filen.
- fileSecurity
- FileSecurity
Ett FileSecurity objekt som avgör åtkomstkontroll och granskningssäkerhet för filen.
Returer
En ny fil med angiven buffertstorlek, filalternativ och filsäkerhet.
Undantag
Anroparen har inte den behörighet som krävs.
-eller-
path har angett en fil som är skrivskyddad.
-eller-
path har angett en fil som är dold.
.NET Framework- och .NET Core-versioner som är äldre än 2.1: path är en sträng med noll längd, innehåller endast tomt utrymme eller innehåller ett eller flera ogiltiga tecken. Du kan fråga efter ogiltiga tecken med hjälp GetInvalidPathChars() av metoden .
path är null.
Den angivna sökvägen, filnamnet eller båda överskrider den systemdefinierade maximala längden.
Den angivna sökvägen är ogiltig (den finns till exempel på en ommappad enhet).
Ett I/O-fel uppstod när filen skapades.
path är i ett ogiltigt format.
Kommentarer
Parametern path tillåts ange relativ eller absolut sökvägsinformation. Relativ sökvägsinformation tolkas som relativ till den aktuella arbetskatalogen. Information om hur du hämtar den aktuella arbetskatalogen finns i GetCurrentDirectory.
Den här metoden motsvarar konstruktorns FileStream(String, FileMode, FileAccess, FileShare, Int32) överlagring. Om den angivna filen inte finns skapas den. Om den finns och den inte är skrivskyddad ersätts innehållet.
Som standard beviljas fullständig läs-/skrivåtkomst till nya filer till alla användare. Filen öppnas med läs-/skrivåtkomst och måste stängas innan den kan öppnas av ett annat program.
En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.
Important
Den här metoden portades till .NET Core 3.1 i följande form: Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity).