File.Create Yöntem

Tanım

Belirtilen yolda bir dosya oluşturur veya üzerine yazar.Creates or overwrites a file in the specified path.

Aşırı Yüklemeler

Create(String)

Belirtilen yolda bir dosya oluşturur veya üzerine yazar.Creates or overwrites a file in the specified path.

Create(String, Int32)

Belirtilen yolda bir arabellek boyutu belirterek bir dosya oluşturur veya üzerine yazar.Creates or overwrites a file in the specified path, specifying a buffer size.

Create(String, Int32, FileOptions)

Belirtilen yolda bir dosya oluşturur veya üzerine yazar ve dosyanın nasıl oluşturulacağını veya üzerine yazıldığını tanımlayan bir arabellek boyutu ve seçenekleri belirtin.Creates or overwrites a file in the specified path, specifying a buffer size and options that describe how to create or overwrite the file.

Create(String, Int32, FileOptions, FileSecurity)

Belirtilen yolda bir dosya oluşturur veya üzerine yazar, bir arabellek boyutu, dosyanın nasıl oluşturulacağını veya üzerine yazıldığını betimleyen seçenekler ve dosya için erişim denetimi ve denetim güvenliğini belirleyen bir değer.Creates or overwrites a file in the specified path, specifying a buffer size, options that describe how to create or overwrite the file, and a value that determines the access control and audit security for the file.

Create(String)

Belirtilen yolda bir dosya oluşturur veya üzerine yazar.Creates or overwrites a file in the specified path.

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ı.The path and name of the file to create.

Döndürülenler

FileStream

FileStream' De belirtilen dosyaya okuma/yazma erişimi sağlayan bir path .A FileStream that provides read/write access to the file specified in path.

Özel durumlar

Çağıranın gerekli izni yok.The caller does not have the required permission.

-veya--or- path salt okunan bir dosya belirtildi.path specified a file that is read-only.

-veya--or- path gizli olan bir dosya belirtildi.path specified a file that is hidden.

path sıfır uzunluklu bir dize, yalnızca boşluk içeriyor veya tarafından tanımlanan bir veya daha fazla geçersiz karakter içeriyor InvalidPathChars .path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path, null değeridir.path is null.

Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.The specified path, file name, or both exceed the system-defined maximum length.

Belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).The specified path is invalid (for example, it is on an unmapped drive).

Dosya oluşturulurken bir g/ç hatası oluştu.An I/O error occurred while creating the file.

path geçersiz bir biçimde.path is in an invalid format.

Örnekler

Aşağıdaki örnek, belirtilen yolda bir dosya oluşturur, dosyaya bazı bilgiler yazar ve dosyadan okur.The following example creates a file in the specified path, writes some information to the file, and reads from the file.

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());
        }
    }
}
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

FileStreamBu yöntem tarafından oluşturulan nesne varsayılan bir değere sahiptir FileShare None ; özgün dosya tanıtıcısı kapatılana kadar başka hiçbir işlem veya kod oluşturulan dosyaya erişemez.The FileStream object created by this method has a default FileShare value of None; no other process or code can access the created file until the original file handle is closed.

Bu yöntem, Create(String, Int32) 4.096 baytlık varsayılan arabellek boyutunu kullanarak yöntem aşırı yüküne eşdeğerdir.This method is equivalent to the Create(String, Int32) method overload using the default buffer size of 4,096 bytes.

pathParametrenin göreli veya mutlak yol bilgilerini belirtmeye izin verilir.The path parameter is permitted to specify relative or absolute path information. Göreli yol bilgisi, geçerli çalışma dizinine göre yorumlanır.Relative path information is interpreted as relative to the current working directory. Geçerli çalışma dizinini almak için bkz GetCurrentDirectory ..To obtain the current working directory, see GetCurrentDirectory.

Belirtilen dosya yoksa, oluşturulur; varsa ve salt okunurdur, içeriğin üzerine yazılır.If the specified file does not exist, it is created; if it does exist and it is not read-only, the contents are overwritten.

Varsayılan olarak, yeni dosyalara tam okuma/yazma erişimi tüm kullanıcılara verilir.By default, full read/write access to new files is granted to all users. Dosya okuma/yazma erişimiyle açılır ve başka bir uygulama tarafından açılabilmesi için önce kapatılmalıdır.The file is opened with read/write access and must be closed before it can be opened by another application.

Ortak g/ç görevlerinin listesi için bkz. ortak g/ç görevleri.For a list of common I/O tasks, see Common I/O Tasks.

Ayrıca bkz.

Create(String, Int32)

Belirtilen yolda bir arabellek boyutu belirterek bir dosya oluşturur veya üzerine yazar.Creates or overwrites a file in the specified path, specifying a buffer size.

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ı.The path and name of the file to create.

bufferSize
Int32

Dosyaya okuma ve yazma için arabelleğe alınan bayt sayısı.The number of bytes buffered for reads and writes to the file.

Döndürülenler

FileStream

FileStream' De belirtilen dosyaya okuma/yazma erişimi sağlayan belirtilen arabellek boyutuyla bir path .A FileStream with the specified buffer size that provides read/write access to the file specified in path.

Özel durumlar

Çağıranın gerekli izni yok.The caller does not have the required permission.

-veya--or- path salt okunan bir dosya belirtildi.path specified a file that is read-only.

-veya--or- path gizli olan bir dosya belirtildi.path specified a file that is hidden.

path sıfır uzunluklu bir dize, yalnızca boşluk içeriyor veya tarafından tanımlanan bir veya daha fazla geçersiz karakter içeriyor InvalidPathChars .path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path, null değeridir.path is null.

Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.The specified path, file name, or both exceed the system-defined maximum length.

Belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).The specified path is invalid (for example, it is on an unmapped drive).

Dosya oluşturulurken bir g/ç hatası oluştu.An I/O error occurred while creating the file.

path geçersiz bir biçimde.path is in an invalid format.

Örnekler

Aşağıdaki örnek, belirtilen arabellek boyutuyla bir dosya oluşturur.The following example creates a file with the specified buffer size.

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);
            }
        }
    }
}
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

FileStreamBu yöntem tarafından oluşturulan nesne varsayılan bir değere sahiptir FileShare None ; özgün dosya tanıtıcısı kapatılana kadar başka hiçbir işlem veya kod oluşturulan dosyaya erişemez.The FileStream object created by this method has a default FileShare value of None; no other process or code can access the created file until the original file handle is closed.

pathParametrenin göreli veya mutlak yol bilgilerini belirtmeye izin verilir.The path parameter is permitted to specify relative or absolute path information. Göreli yol bilgisi, geçerli çalışma dizinine göre yorumlanır.Relative path information is interpreted as relative to the current working directory. Geçerli çalışma dizinini almak için bkz GetCurrentDirectory ..To obtain the current working directory, see GetCurrentDirectory.

Bu yöntem, FileStream(String, FileMode, FileAccess, FileShare, Int32) Oluşturucu aşırı yüküne eşdeğerdir.This method is equivalent to the FileStream(String, FileMode, FileAccess, FileShare, Int32) constructor overload. Belirtilen dosya yoksa, oluşturulur; varsa ve salt okunurdur, içeriğin üzerine yazılır.If the specified file does not exist, it is created; if it does exist and it is not read-only, the contents are overwritten.

Varsayılan olarak, yeni dosyalara tam okuma/yazma erişimi tüm kullanıcılara verilir.By default, full read/write access to new files is granted to all users. Dosya okuma/yazma erişimiyle açılır ve başka bir uygulama tarafından açılabilmesi için önce kapatılmalıdır.The file is opened with read/write access and must be closed before it can be opened by another application.

Ortak g/ç görevlerinin listesi için bkz. ortak g/ç görevleri.For a list of common I/O tasks, see Common I/O Tasks.

Ayrıca bkz.

Create(String, Int32, FileOptions)

Belirtilen yolda bir dosya oluşturur veya üzerine yazar ve dosyanın nasıl oluşturulacağını veya üzerine yazıldığını tanımlayan bir arabellek boyutu ve seçenekleri belirtin.Creates or overwrites a file in the specified path, specifying a buffer size and options that describe how to create or overwrite the file.

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ı.The path and name of the file to create.

bufferSize
Int32

Dosyaya okuma ve yazma için arabelleğe alınan bayt sayısı.The number of bytes buffered for reads and writes to the file.

options
FileOptions

FileOptionsDosya oluşturmayı veya dosyanın üzerine yazmayı açıklayan değerlerden biri.One of the FileOptions values that describes how to create or overwrite the file.

Döndürülenler

FileStream

Belirtilen arabellek boyutuyla yeni bir dosya.A new file with the specified buffer size.

Özel durumlar

Çağıranın gerekli izni yok.The caller does not have the required permission.

-veya--or- path salt okunan bir dosya belirtildi.path specified a file that is read-only.

-veya--or- path gizli olan bir dosya belirtildi.path specified a file that is hidden.

path sıfır uzunluklu bir dize, yalnızca boşluk içeriyor veya tarafından tanımlanan bir veya daha fazla geçersiz karakter içeriyor InvalidPathChars .path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path, null değeridir.path is null.

Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.The specified path, file name, or both exceed the system-defined maximum length.

Belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücü üzerindedir.The specified path is invalid (for example, it is on an unmapped drive.

Dosya oluşturulurken bir g/ç hatası oluştu.An I/O error occurred while creating the file.

path geçersiz bir biçimde.path is in an invalid format.

Açıklamalar

pathParametrenin göreli veya mutlak yol bilgilerini belirtmeye izin verilir.The path parameter is permitted to specify relative or absolute path information. Göreli yol bilgisi, geçerli çalışma dizinine göre yorumlanır.Relative path information is interpreted as relative to the current working directory. Geçerli çalışma dizinini almak için bkz GetCurrentDirectory ..To obtain the current working directory, see GetCurrentDirectory.

Bu yöntem, FileStream(String, FileMode, FileAccess, FileShare, Int32) Oluşturucu aşırı yüküne eşdeğerdir.This method is equivalent to the FileStream(String, FileMode, FileAccess, FileShare, Int32) constructor overload. Belirtilen dosya yoksa, oluşturulur; varsa ve salt okunurdur, içeriğin üzerine yazılır.If the specified file does not exist, it is created; if it does exist and it is not read-only, the contents are overwritten.

Varsayılan olarak, yeni dosyalara tam okuma/yazma erişimi tüm kullanıcılara verilir.By default, full read/write access to new files is granted to all users. Dosya okuma/yazma erişimiyle açılır ve başka bir uygulama tarafından açılabilmesi için önce kapatılmalıdır.The file is opened with read/write access and must be closed before it can be opened by another application.

Ortak g/ç görevlerinin listesi için bkz. ortak g/ç görevleri.For a list of common I/O tasks, see Common I/O Tasks.

Create(String, Int32, FileOptions, FileSecurity)

Belirtilen yolda bir dosya oluşturur veya üzerine yazar, bir arabellek boyutu, dosyanın nasıl oluşturulacağını veya üzerine yazıldığını betimleyen seçenekler ve dosya için erişim denetimi ve denetim güvenliğini belirleyen bir değer.Creates or overwrites a file in the specified path, specifying a buffer size, options that describe how to create or overwrite the file, and a value that determines the access control and audit security for the file.

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ı.The path and name of the file to create.

bufferSize
Int32

Dosyaya okuma ve yazma için arabelleğe alınan bayt sayısı.The number of bytes buffered for reads and writes to the file.

options
FileOptions

FileOptionsDosya oluşturmayı veya dosyanın üzerine yazmayı açıklayan değerlerden biri.One of the FileOptions values that describes how to create or overwrite the file.

fileSecurity
FileSecurity

FileSecurityDosya için erişim denetimi ve denetim güvenliğini belirleyen bir nesne.A FileSecurity object that determines the access control and audit security for the file.

Döndürülenler

FileStream

Belirtilen arabellek boyutu, dosya seçenekleri ve dosya güvenliğine sahip yeni bir dosya.A new file with the specified buffer size, file options, and file security.

Özel durumlar

Çağıranın gerekli izni yok.The caller does not have the required permission.

-veya--or- path salt okunan bir dosya belirtildi.path specified a file that is read-only.

-veya--or- path gizli olan bir dosya belirtildi.path specified a file that is hidden.

path sıfır uzunluklu bir dize, yalnızca boşluk içeriyor veya tarafından tanımlanan bir veya daha fazla geçersiz karakter içeriyor InvalidPathChars .path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path, null değeridir.path is null.

Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.The specified path, file name, or both exceed the system-defined maximum length.

Belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).The specified path is invalid (for example, it is on an unmapped drive).

Dosya oluşturulurken bir g/ç hatası oluştu.An I/O error occurred while creating the file.

path geçersiz bir biçimde.path is in an invalid format.

Açıklamalar

pathParametrenin göreli veya mutlak yol bilgilerini belirtmeye izin verilir.The path parameter is permitted to specify relative or absolute path information. Göreli yol bilgisi, geçerli çalışma dizinine göre yorumlanır.Relative path information is interpreted as relative to the current working directory. Geçerli çalışma dizinini almak için bkz GetCurrentDirectory ..To obtain the current working directory, see GetCurrentDirectory.

Bu yöntem, FileStream(String, FileMode, FileAccess, FileShare, Int32) Oluşturucu aşırı yüküne eşdeğerdir.This method is equivalent to the FileStream(String, FileMode, FileAccess, FileShare, Int32) constructor overload. Belirtilen dosya yoksa, oluşturulur; varsa ve salt okunurdur, içeriğin üzerine yazılır.If the specified file does not exist, it is created; if it does exist and it is not read-only, the contents are overwritten.

Varsayılan olarak, yeni dosyalara tam okuma/yazma erişimi tüm kullanıcılara verilir.By default, full read/write access to new files is granted to all users. Dosya okuma/yazma erişimiyle açılır ve başka bir uygulama tarafından açılabilmesi için önce kapatılmalıdır.The file is opened with read/write access and must be closed before it can be opened by another application.

Ortak g/ç görevlerinin listesi için bkz. ortak g/ç görevleri.For a list of common I/O tasks, see Common I/O Tasks.

Önemli

Bu yöntem, aşağıdaki biçimde .NET Core 3,1 'e alındı: Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity) .This method was ported to .NET Core 3.1 in the following form: Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity).

Şunlara uygulanır