File.Create メソッド

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

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

オーバーロード

Create(String)	指定したパス内のファイルを作成または切り捨てて上書きします。
Create(String, Int32)	指定したパス内のファイルを作成または切り捨てて上書きし、バッファー サイズを指定します。
Create(String, Int32, FileOptions)	バッファー サイズとファイルの作成または上書き方法を示すオプションを指定して、指定したパスのファイルを作成または上書きします。

Create(String)

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

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

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

例外

UnauthorizedAccessException

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

- または -

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

- または -

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

ArgumentException

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

ArgumentNullException

path が nullです。

PathTooLongException

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

DirectoryNotFoundException

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

IOException

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

NotSupportedException

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

注釈

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

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

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

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

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

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

こちらもご覧ください

• ファイルおよびストリーム入出力
• ファイルからのテキストの読み取り
• 方法: テキストのファイルへの書き込み
• 方法: 新しく作成されたデータ ファイルに対して読み書きする

Create(String, Int32)

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

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

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

例外

UnauthorizedAccessException

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

- または -

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

- または -

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

ArgumentException

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

ArgumentNullException

path が nullです。

PathTooLongException

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

DirectoryNotFoundException

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

IOException

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

NotSupportedException

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

注釈

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

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

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

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

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

こちらもご覧ください

• ファイルおよびストリーム入出力
• ファイルからのテキストの読み取り
• 方法: テキストのファイルへの書き込み
• 方法: 新しく作成されたデータ ファイルに対して読み書きする

Create(String, Int32, FileOptions)

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

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 値のいずれか。

戻り値

FileStream

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

例外

UnauthorizedAccessException

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

- または -

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

- または -

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

ArgumentException

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

ArgumentNullException

path が nullです。

PathTooLongException

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

DirectoryNotFoundException

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

IOException

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

NotSupportedException

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

注釈

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

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

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

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