File.Create メソッド

リファレンス

定義

名前空間:: System.IO

アセンブリ:: mscorlib.dll, System.IO.FileSystem.dll

アセンブリ:: System.IO.FileSystem.dll

アセンブリ:: System.Runtime.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

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

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 タスクを参照してください。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

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

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

例外

UnauthorizedAccessException

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

- または -

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

- または -

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

ArgumentException

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

注釈

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

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

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

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

戻り値

FileStream

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

例外

UnauthorizedAccessException

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

- または -

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

- または -

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

ArgumentException

ArgumentNullException

path が nullです。

PathTooLongException

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

DirectoryNotFoundException

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

IOException

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

NotSupportedException

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

注釈

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

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

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 オブジェクト。

戻り値

FileStream

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

例外

UnauthorizedAccessException

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

- または -

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

- または -

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

ArgumentException

ArgumentNullException

path が nullです。

PathTooLongException

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

DirectoryNotFoundException

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

IOException

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

NotSupportedException

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

注釈

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

重要

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

適用対象

.NET Framework 4.8.1 およびその他のバージョン

製品	バージョン
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

The future is yours

次の方法で共有

File.Create メソッド

定義

オーバーロード

Create(String)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

Create(String, Int32)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

Create(String, Int32, FileOptions)

パラメーター

戻り値

例外

注釈

適用対象

Create(String, Int32, FileOptions, FileSecurity)

パラメーター

戻り値

例外

注釈

適用対象

その他のリソース