File.Create メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したパス内のファイルを作成または切り捨てて上書きします。
オーバーロード
| 名前 | 説明 |
|---|---|
| Create(String) |
指定したパス内のファイルを作成または切り捨てて上書きします。 |
| Create(String, Int32) |
バッファー サイズを指定して、指定したパス内のファイルを作成または切り捨てて上書きします。 |
| Create(String, Int32, FileOptions) |
ファイルを作成または上書きする方法を記述するバッファー サイズとオプションを指定して、指定したパス内のファイルを作成または上書きします。 |
| Create(String, Int32, FileOptions, FileSecurity) |
指定したパス内のファイルを作成または上書きし、バッファー サイズ、ファイルを作成または上書きする方法を説明するオプション、およびファイルのアクセス制御と監査セキュリティを決定する値を指定します。 |
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
作成するファイルのパスと名前。
返品
pathで指定されたファイルへの読み取り/書き込みアクセスを提供するFileStream。
例外
呼び出し元に必要なアクセス許可がありません。
-または-
path は、読み取り専用のファイルを指定しました。
-または-
path は、非表示のファイルを指定しました。
2.1 より前のバージョンの .NET Framework と .NET Core: path は長さ 0 の文字列で、空白のみを含むか、1 つ以上の無効な文字を含みます。
GetInvalidPathChars() メソッドを使用して、無効な文字のクエリを実行できます。
path は nullです。
指定したパス、ファイル名、またはその両方が、システム定義の最大長を超えています。
指定されたパスが無効です (たとえば、マップされていないドライブ上にあります)。
ファイルの作成時に 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());
}
}
}
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
注釈
このメソッドによって作成された FileStream オブジェクトの既定の FileShare 値は 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
ファイルへの読み取りと書き込みのためにバッファーに格納されたバイト数。
返品
pathで指定されたファイルへの読み取り/書き込みアクセスを提供する、指定されたバッファー サイズを持つFileStream。
例外
呼び出し元に必要なアクセス許可がありません。
-または-
path は、読み取り専用のファイルを指定しました。
-または-
path は、非表示のファイルを指定しました。
2.1 より前のバージョンの .NET Framework と .NET Core: path は長さ 0 の文字列で、空白のみを含むか、1 つ以上の無効な文字を含みます。
GetInvalidPathChars() メソッドを使用して、無効な文字のクエリを実行できます。
path は nullです。
指定したパス、ファイル名、またはその両方が、システム定義の最大長を超えています。
指定されたパスが無効です (たとえば、マップされていないドライブ上にあります)。
ファイルの作成時に 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);
}
}
}
}
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 オブジェクトの既定の FileShare 値は 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 値の 1 つ。
返品
指定したバッファー サイズの新しいファイル。
例外
呼び出し元に必要なアクセス許可がありません。
-または-
path は、読み取り専用のファイルを指定しました。
-または-
path は、非表示のファイルを指定しました。
2.1 より前のバージョンの .NET Framework と .NET Core: path は長さ 0 の文字列で、空白のみを含むか、1 つ以上の無効な文字を含みます。
GetInvalidPathChars() メソッドを使用して、無効な文字のクエリを実行できます。
path は nullです。
指定したパス、ファイル名、またはその両方が、システム定義の最大長を超えています。
指定されたパスが無効です (たとえば、マップされていないドライブ上にあります)。
ファイルの作成時に 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 値の 1 つ。
- fileSecurity
- FileSecurity
ファイルのアクセス制御と監査セキュリティを決定する FileSecurity オブジェクト。
返品
指定されたバッファー サイズ、ファイル オプション、およびファイル セキュリティを持つ新しいファイル。
例外
呼び出し元に必要なアクセス許可がありません。
-または-
path は、読み取り専用のファイルを指定しました。
-または-
path は、非表示のファイルを指定しました。
2.1 より前のバージョンの .NET Framework と .NET Core: path は長さ 0 の文字列で、空白のみを含むか、1 つ以上の無効な文字を含みます。
GetInvalidPathChars() メソッドを使用して、無効な文字のクエリを実行できます。
path は nullです。
指定したパス、ファイル名、またはその両方が、システム定義の最大長を超えています。
指定されたパスが無効です (たとえば、マップされていないドライブ上にあります)。
ファイルの作成時に I/O エラーが発生しました。
path が無効な形式です。
注釈
path パラメーターは、相対パス情報または絶対パス情報を指定できます。 相対パス情報は、現在の作業ディレクトリに対する相対パスとして解釈されます。 現在の作業ディレクトリを取得するには、 GetCurrentDirectoryを参照してください。
このメソッドは、 FileStream(String, FileMode, FileAccess, FileShare, Int32) コンストラクターのオーバーロードと同じです。 指定したファイルが存在しない場合は作成されます。存在し、読み取り専用でない場合は、内容が置き換えられます。
既定では、新しいファイルへの完全な読み取り/書き込みアクセス権はすべてのユーザーに付与されます。 ファイルは読み取り/書き込みアクセス権で開かれるので、別のアプリケーションで開く前に閉じる必要があります。
一般的な I/O タスクの一覧については、「 一般的な I/O タスク」を参照してください。
Important
このメソッドは、Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity) の形式で .NET Core 3.1 に移植されました。