File.Create Yöntem

Tanım

Belirtilen yolda bir dosya oluşturur veya kırpıp üzerine yazar.

Aşırı Yüklemeler

Create(String)

Belirtilen yolda bir dosya oluşturur veya kırpıp üzerine yazar.

Create(String, Int32)

Belirtilen yolda arabellek boyutunu belirten bir dosya oluşturur veya kesir ve üzerine yazar.

Create(String, Int32, FileOptions)

Belirtilen yolda bir dosya oluşturur veya üzerine yazar, bir arabellek boyutu ve dosyanın nasıl oluşturulacağını veya üzerine yazılacağını açıklayan seçenekleri belirtir.

Create(String, Int32, FileOptions, FileSecurity)

Belirtilen yolda bir dosya oluşturur veya üzerine yazar, arabellek boyutunu, dosyanın nasıl oluşturulacağını veya üzerine yazılacağını açıklayan seçenekleri ve dosyanın erişim denetimini ve denetim güvenliğini belirleyen bir değeri belirtir.

Create(String)

Kaynak:
File.cs
Kaynak:
File.cs
Kaynak:
File.cs

Belirtilen yolda bir dosya oluşturur veya kırpıp üzerine yazar.

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

Parametreler

path
String

Oluşturulacak dosyanın yolu ve adı.

Döndürülenler

FileStream içinde pathbelirtilen dosyaya okuma/yazma erişimi sağlayan bir.

Özel durumlar

Çağıranın gerekli izni yok.

-veya-

path salt okunur bir dosya belirtti.

-veya-

path gizli bir dosya belirtti.

2.1'den eski .NET Framework ve .NET Core sürümleri: path sıfır uzunlukta bir dizedir, yalnızca boşluk içerir veya bir veya daha fazla geçersiz karakter içerir. yöntemini kullanarak GetInvalidPathChars() geçersiz karakterleri sorgulayabilirsiniz.

path, null değeridir.

Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.

Belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).

Dosya oluşturulurken G/Ç hatası oluştu.

path geçersiz bir biçimde.

Örnekler

Aşağıdaki örnek, belirtilen yolda bir dosya oluşturur, dosyaya bazı bilgiler yazar ve dosyadan okur.

using namespace System;
using namespace System::IO;
using namespace System::Text;

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Create the file, or overwrite if the file exists.
   FileStream^ fs = File::Create( path );
   try
   {
      array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( "This is some text in the file." );
      
      // Add some information to the file.
      fs->Write( info, 0, info->Length );
   }
   finally
   {
      if ( fs )
            delete (IDisposable^)fs;
   }

   // Open the stream and read it back.
   StreamReader^ sr = File::OpenText( path );
   try
   {
      String^ s = "";
      while ( s = sr->ReadLine() )
      {
         Console::WriteLine( s );
      }
   }
   finally
   {
      if ( sr )
            delete (IDisposable^)sr;
   }
}
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

Açıklamalar

FileStream Bu yöntem tarafından oluşturulan nesnenin varsayılan FileShare değeri Nonevardır; özgün dosya tanıtıcısı kapatılana kadar oluşturulan dosyaya başka hiçbir işlem veya kod erişemez.

Bu yöntem, 4.096 baytlık varsayılan arabellek boyutunu kullanan yöntem aşırı yüklemesine eşdeğerdir Create(String, Int32) .

parametresinin path göreli veya mutlak yol bilgilerini belirtmesine izin verilir. Göreli yol bilgisi, geçerli çalışma dizinine göre yorumlanır. Geçerli çalışma dizinini edinmek için bkz GetCurrentDirectory. .

Belirtilen dosya yoksa oluşturulur; varsa ve salt okunur değilse, içerik silinir ve üzerine yazılır.

Varsayılan olarak, tüm kullanıcılara yeni dosyalara tam okuma/yazma erişimi verilir. Dosya okuma/yazma erişimiyle açılır ve başka bir uygulama tarafından açılmadan önce kapatılmalıdır.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Ayrıca bkz.

Şunlara uygulanır

Create(String, Int32)

Kaynak:
File.cs
Kaynak:
File.cs
Kaynak:
File.cs

Belirtilen yolda arabellek boyutunu belirten bir dosya oluşturur veya kesir ve üzerine yazar.

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

Parametreler

path
String

Oluşturulacak dosyanın yolu ve adı.

bufferSize
Int32

Dosyaya okuma ve yazma işlemleri için arabelleğe alınan bayt sayısı.

Döndürülenler

FileStream içinde belirtilen dosyaya okuma/yazma erişimi sağlayan belirtilen patharabellek boyutuna sahip bir.

Özel durumlar

Çağıranın gerekli izni yok.

-veya-

path salt okunur bir dosya belirtti.

-veya-

path gizli bir dosya belirtti.

2.1'den eski .NET Framework ve .NET Core sürümleri: path sıfır uzunlukta bir dizedir, yalnızca boşluk içerir veya bir veya daha fazla geçersiz karakter içerir. yöntemini kullanarak GetInvalidPathChars() geçersiz karakterleri sorgulayabilirsiniz.

path, null değeridir.

Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.

Belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).

Dosya oluşturulurken G/Ç hatası oluştu.

path geçersiz bir biçimde.

Örnekler

Aşağıdaki örnek, belirtilen arabellek boyutuna sahip bir dosya oluşturur.

using namespace System;
using namespace System::IO;
using namespace System::Text;

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Create the file, or overwrite if the file exists.
   FileStream^ fs = File::Create( path, 1024 );
   try
   {
      array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( "This is some text in the file." );
      
      // Add some information to the file.
      fs->Write( info, 0, info->Length );
   }
   finally
   {
      if ( fs )
            delete (IDisposable^)fs;
   }

   // Open the stream and read it back.
   StreamReader^ sr = File::OpenText( path );
   try
   {
      String^ s = "";
      while ( s = sr->ReadLine() )
      {
         Console::WriteLine( s );
      }
   }
   finally
   {
      if ( sr )
            delete (IDisposable^)sr;
   }
}
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

Açıklamalar

FileStream Bu yöntem tarafından oluşturulan nesnenin varsayılan FileShare değeri Nonevardır; özgün dosya tanıtıcısı kapatılana kadar oluşturulan dosyaya başka hiçbir işlem veya kod erişemez.

parametresinin path göreli veya mutlak yol bilgilerini belirtmesine izin verilir. Göreli yol bilgisi, geçerli çalışma dizinine göre yorumlanır. Geçerli çalışma dizinini edinmek için bkz GetCurrentDirectory. .

Bu yöntem, oluşturucu aşırı yüklemesine FileStream(String, FileMode, FileAccess, FileShare, Int32) eşdeğerdir. Belirtilen dosya yoksa oluşturulur; varsa ve salt okunur değilse, içerik değiştirilir.

Varsayılan olarak, tüm kullanıcılara yeni dosyalara tam okuma/yazma erişimi verilir. Dosya okuma/yazma erişimiyle açılır ve başka bir uygulama tarafından açılmadan önce kapatılmalıdır.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Ayrıca bkz.

Şunlara uygulanır

Create(String, Int32, FileOptions)

Kaynak:
File.cs
Kaynak:
File.cs
Kaynak:
File.cs

Belirtilen yolda bir dosya oluşturur veya üzerine yazar, bir arabellek boyutu ve dosyanın nasıl oluşturulacağını veya üzerine yazılacağını açıklayan seçenekleri belirtir.

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

Parametreler

path
String

Oluşturulacak dosyanın yolu ve adı.

bufferSize
Int32

Dosyaya okuma ve yazma işlemleri için arabelleğe alınan bayt sayısı.

options
FileOptions

FileOptions Dosyanın nasıl oluşturulacağını veya üzerine yazıldığını açıklayan değerlerden biri.

Döndürülenler

Belirtilen arabellek boyutuna sahip yeni bir dosya.

Özel durumlar

Çağıranın gerekli izni yok.

-veya-

path salt okunur bir dosya belirtti.

-veya-

path gizli bir dosya belirtti.

2.1'den eski .NET Framework ve .NET Core sürümleri: path sıfır uzunlukta bir dizedir, yalnızca boşluk içerir veya bir veya daha fazla geçersiz karakter içerir. yöntemini kullanarak GetInvalidPathChars() geçersiz karakterleri sorgulayabilirsiniz.

path, null değeridir.

Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.

Belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde.

Dosya oluşturulurken G/Ç hatası oluştu.

path geçersiz bir biçimde.

Açıklamalar

parametresinin path göreli veya mutlak yol bilgilerini belirtmesine izin verilir. Göreli yol bilgisi, geçerli çalışma dizinine göre yorumlanır. Geçerli çalışma dizinini edinmek için bkz GetCurrentDirectory. .

Bu yöntem, oluşturucu aşırı yüklemesine FileStream(String, FileMode, FileAccess, FileShare, Int32) eşdeğerdir. Belirtilen dosya yoksa oluşturulur; varsa ve salt okunur değilse, içerik değiştirilir.

Varsayılan olarak, tüm kullanıcılara yeni dosyalara tam okuma/yazma erişimi verilir. Dosya okuma/yazma erişimiyle açılır ve başka bir uygulama tarafından açılmadan önce kapatılmalıdır.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Şunlara uygulanır

Create(String, Int32, FileOptions, FileSecurity)

Belirtilen yolda bir dosya oluşturur veya üzerine yazar, arabellek boyutunu, dosyanın nasıl oluşturulacağını veya üzerine yazılacağını açıklayan seçenekleri ve dosyanın erişim denetimini ve denetim güvenliğini belirleyen bir değeri belirtir.

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

Parametreler

path
String

Oluşturulacak dosyanın yolu ve adı.

bufferSize
Int32

Dosyaya okuma ve yazma işlemleri için arabelleğe alınan bayt sayısı.

options
FileOptions

FileOptions Dosyanın nasıl oluşturulacağını veya üzerine yazıldığını açıklayan değerlerden biri.

fileSecurity
FileSecurity

FileSecurity Dosya için erişim denetimini ve denetim güvenliğini belirleyen bir nesne.

Döndürülenler

Belirtilen arabellek boyutuna, dosya seçeneklerine ve dosya güvenliğine sahip yeni bir dosya.

Özel durumlar

Çağıranın gerekli izni yok.

-veya-

path salt okunur bir dosya belirtti.

-veya-

path gizli bir dosya belirtti.

2.1'den eski .NET Framework ve .NET Core sürümleri: path sıfır uzunlukta bir dizedir, yalnızca boşluk içerir veya bir veya daha fazla geçersiz karakter içerir. yöntemini kullanarak GetInvalidPathChars() geçersiz karakterleri sorgulayabilirsiniz.

path, null değeridir.

Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.

Belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).

Dosya oluşturulurken G/Ç hatası oluştu.

path geçersiz bir biçimde.

Açıklamalar

parametresinin path göreli veya mutlak yol bilgilerini belirtmesine izin verilir. Göreli yol bilgisi, geçerli çalışma dizinine göre yorumlanır. Geçerli çalışma dizinini edinmek için bkz GetCurrentDirectory. .

Bu yöntem, oluşturucu aşırı yüklemesine FileStream(String, FileMode, FileAccess, FileShare, Int32) eşdeğerdir. Belirtilen dosya yoksa oluşturulur; varsa ve salt okunur değilse, içerik değiştirilir.

Varsayılan olarak, tüm kullanıcılara yeni dosyalara tam okuma/yazma erişimi verilir. Dosya okuma/yazma erişimiyle açılır ve başka bir uygulama tarafından açılmadan önce kapatılmalıdır.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Önemli

Bu yöntem şu biçimde .NET Core 3.1'e taşınabilir: Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity).

Şunlara uygulanır