英語で読む

次の方法で共有


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 (string path);

パラメーター

path
String

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

戻り値

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

例外

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

- または -

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

- または -

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

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

pathnullです。

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

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

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

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

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

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

注釈

このメソッドによって作成されたオブジェクトの既定値FileShareFileStream です。元の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 (string path, int bufferSize);

パラメーター

path
String

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

bufferSize
Int32

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

戻り値

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

例外

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

- または -

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

- または -

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

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

pathnullです。

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

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

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

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

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

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

注釈

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

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

このメソッドは、コンストラクターのオーバーロードと 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 (string path, int bufferSize, System.IO.FileOptions options);

パラメーター

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

適用対象

.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 (string path, int bufferSize, System.IO.FileOptions options, System.Security.AccessControl.FileSecurity fileSecurity);

パラメーター

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)

適用対象

.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