File.Create Metod

Definition

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 FileShareNone; 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

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 FileShareNone; 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

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).

Gäller för