File.Create メソッド

定義

指定したパス内のファイルを作成または切り捨てて上書きします。

オーバーロード

Create(String)

指定したパス内のファイルを作成または切り捨てて上書きします。

Create(String, Int32)

指定したパス内のファイルを作成または切り捨てて上書きし、バッファー サイズを指定します。

Create(String, Int32, FileOptions)

バッファー サイズとファイルの作成または上書き方法を示すオプションを指定して、指定したパスのファイルを作成または上書きします。

Create(String, Int32, FileOptions, FileSecurity)

バッファー サイズ、ファイルの作成または上書き方法を示すオプション、ファイルのアクセスの制御および監査セキュリティを決定する値を指定して、指定したパスのファイルを作成または上書きします。

Create(String)

ソース:
File.cs
ソース:
File.cs
ソース:
File.cs

指定したパス内のファイルを作成または切り捨てて上書きします。

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

パラメーター

path
String

作成するファイルのパスと名前。

戻り値

FileStream で指定したファイルへの読み取り/書き込みアクセスを提供する path

例外

呼び出し元に、必要なアクセス許可がありません。

- または -

path が読み取り専用のファイルを指定しました。

- または -

path によって、非表示のファイルが指定されました。

.NET Framework バージョンと .NET Core バージョンが 2.1 より前の場合: path は長さ 0 の文字列、空白のみを含む、または無効な文字が 1 つ以上含まれています。 正しくない文字を照会するには、GetInvalidPathChars() メソッドを使用します。

pathnullです。

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。

指定されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。

ファイルの作成中に I/O エラーが発生しました。

path の形式が正しくありません。

次の例では、指定したパスにファイルを作成し、ファイルに情報を書き込み、ファイルから読み取ります。

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

注釈

このメソッドによって作成されたオブジェクトの既定値FileShareFileStream です。元のNoneファイル ハンドルが閉じられるまで、他のプロセスやコードは作成されたファイルにアクセスできません。

このメソッドは、4,096 バイトの既定のバッファー サイズを使用するメソッド オーバーロードと同じです Create(String, Int32)

パラメーターは path 、相対パス情報または絶対パス情報を指定できます。 相対パス情報は、現在の作業ディレクトリに対する相対パスとして解釈されます。 現在の作業ディレクトリを取得するには、「」を参照してください GetCurrentDirectory

指定したファイルが存在しない場合は、作成されます。存在し、読み取り専用でない場合は、内容が削除されて上書きされます。

既定では、新しいファイルへの完全な読み取り/書き込みアクセス権はすべてのユーザーに付与されます。 ファイルは読み取り/書き込みアクセス権で開かれるので、別のアプリケーションで開く前に閉じる必要があります。

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

こちらもご覧ください

適用対象

Create(String, Int32)

ソース:
File.cs
ソース:
File.cs
ソース:
File.cs

指定したパス内のファイルを作成または切り捨てて上書きし、バッファー サイズを指定します。

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

パラメーター

path
String

作成するファイルのパスと名前。

bufferSize
Int32

ファイルの読み取りおよび書き込み用にバッファリングされるバイト数。

戻り値

指定された大きさのバッファーを持ち、FileStream で指定されたファイルへの読み取り/書き込みアクセスを提供する path

例外

呼び出し元に、必要なアクセス許可がありません。

- または -

path が読み取り専用のファイルを指定しました。

- または -

path によって、非表示のファイルが指定されました。

.NET Framework バージョンと .NET Core バージョンが 2.1 より前の場合: path は長さ 0 の文字列、空白のみを含む、または無効な文字が 1 つ以上含まれています。 正しくない文字を照会するには、GetInvalidPathChars() メソッドを使用します。

pathnullです。

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。

指定されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。

ファイルの作成中に I/O エラーが発生しました。

path の形式が正しくありません。

次の例では、指定したバッファー サイズのファイルを作成します。

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

注釈

このメソッドによって作成されたオブジェクトの既定値FileShareFileStream です。元のNoneファイル ハンドルが閉じられるまで、他のプロセスやコードは作成されたファイルにアクセスできません。

パラメーターは path 、相対パス情報または絶対パス情報を指定できます。 相対パス情報は、現在の作業ディレクトリに対する相対パスとして解釈されます。 現在の作業ディレクトリを取得するには、「」を参照してください GetCurrentDirectory

このメソッドは、コンストラクターのオーバーロードと FileStream(String, FileMode, FileAccess, FileShare, Int32) 同じです。 指定したファイルが存在しない場合は、作成されます。存在し、読み取り専用でない場合は、内容が置き換えられます。

既定では、新しいファイルへの完全な読み取り/書き込みアクセス権はすべてのユーザーに付与されます。 ファイルは読み取り/書き込みアクセス権で開かれるので、別のアプリケーションで開く前に閉じる必要があります。

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

こちらもご覧ください

適用対象

Create(String, Int32, FileOptions)

ソース:
File.cs
ソース:
File.cs
ソース:
File.cs

バッファー サイズとファイルの作成または上書き方法を示すオプションを指定して、指定したパスのファイルを作成または上書きします。

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

パラメーター

path
String

作成するファイルのパスと名前。

bufferSize
Int32

ファイルの読み取りおよび書き込み用にバッファリングされるバイト数。

options
FileOptions

ファイルを作成または上書きする方法を示す FileOptions 値のいずれか。

戻り値

指定したバッファー サイズの新規ファイル。

例外

呼び出し元に、必要なアクセス許可がありません。

- または -

path が読み取り専用のファイルを指定しました。

- または -

path によって、非表示のファイルが指定されました。

.NET Framework バージョンと .NET Core バージョンが 2.1 より前の場合: path は長さ 0 の文字列、空白のみを含む、または無効な文字が 1 つ以上含まれています。 正しくない文字を照会するには、GetInvalidPathChars() メソッドを使用します。

pathnullです。

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。

指定されたパスが正しくありません (たとえば、マップされていないドライブにあるなど。

ファイルの作成中に I/O エラーが発生しました。

path の形式が正しくありません。

注釈

パラメーターは path 、相対パス情報または絶対パス情報を指定できます。 相対パス情報は、現在の作業ディレクトリに対する相対パスとして解釈されます。 現在の作業ディレクトリを取得するには、「」を参照してください GetCurrentDirectory

このメソッドは、コンストラクターのオーバーロードと FileStream(String, FileMode, FileAccess, FileShare, Int32) 同じです。 指定したファイルが存在しない場合は、作成されます。存在し、読み取り専用でない場合は、内容が置き換えられます。

既定では、新しいファイルへの完全な読み取り/書き込みアクセス権はすべてのユーザーに付与されます。 ファイルは読み取り/書き込みアクセス権で開かれるので、別のアプリケーションで開く前に閉じる必要があります。

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

適用対象

Create(String, Int32, FileOptions, FileSecurity)

バッファー サイズ、ファイルの作成または上書き方法を示すオプション、ファイルのアクセスの制御および監査セキュリティを決定する値を指定して、指定したパスのファイルを作成または上書きします。

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

パラメーター

path
String

作成するファイルのパスと名前。

bufferSize
Int32

ファイルの読み取りおよび書き込み用にバッファリングされるバイト数。

options
FileOptions

ファイルを作成または上書きする方法を示す FileOptions 値のいずれか。

fileSecurity
FileSecurity

ファイルのアクセス制御と監査セキュリティを決定する FileSecurity オブジェクト。

戻り値

指定したバッファー サイズ、ファイル オプション、ファイル セキュリティが設定された新しいファイル。

例外

呼び出し元に、必要なアクセス許可がありません。

- または -

path が読み取り専用のファイルを指定しました。

- または -

path によって、非表示のファイルが指定されました。

.NET Framework バージョンと .NET Core バージョンが 2.1 より前の場合: path は長さ 0 の文字列、空白のみを含む、または無効な文字が 1 つ以上含まれています。 正しくない文字を照会するには、GetInvalidPathChars() メソッドを使用します。

pathnullです。

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。

指定されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。

ファイルの作成中に I/O エラーが発生しました。

path の形式が正しくありません。

注釈

パラメーターは path 、相対パス情報または絶対パス情報を指定できます。 相対パス情報は、現在の作業ディレクトリに対する相対パスとして解釈されます。 現在の作業ディレクトリを取得するには、「」を参照してください GetCurrentDirectory

このメソッドは、コンストラクターのオーバーロードと FileStream(String, FileMode, FileAccess, FileShare, Int32) 同じです。 指定したファイルが存在しない場合は、作成されます。存在し、読み取り専用でない場合は、内容が置き換えられます。

既定では、新しいファイルへの完全な読み取り/書き込みアクセス権はすべてのユーザーに付与されます。 ファイルは読み取り/書き込みアクセス権で開かれるので、別のアプリケーションで開く前に閉じる必要があります。

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

重要

このメソッドは、次の形式で .NET Core 3.1 に移植されました。 Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity)

適用対象