File.Create メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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 で指定したファイルへの読み取り/書き込みアクセスを提供する path
。
例外
呼び出し元に、必要なアクセス許可がありません。
- または -
path
が読み取り専用のファイルを指定しました。
- または -
path
によって、非表示のファイルが指定されました。
.NET Framework バージョンと .NET Core バージョンが 2.1 より前の場合: path
は長さ 0 の文字列、空白のみを含む、または無効な文字が 1 つ以上含まれています。 正しくない文字を照会するには、GetInvalidPathChars() メソッドを使用します。
path
が null
です。
指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。
指定されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。
ファイルの作成中に 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
注釈
このメソッドによって作成されたオブジェクトの既定値FileShareは FileStream です。元の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() メソッドを使用します。
path
が null
です。
指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。
指定されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。
ファイルの作成中に 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
注釈
このメソッドによって作成されたオブジェクトの既定値FileShareは FileStream です。元の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() メソッドを使用します。
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 値のいずれか。
- fileSecurity
- FileSecurity
ファイルのアクセス制御と監査セキュリティを決定する FileSecurity オブジェクト。
戻り値
指定したバッファー サイズ、ファイル オプション、ファイル セキュリティが設定された新しいファイル。
例外
呼び出し元に、必要なアクセス許可がありません。
- または -
path
が読み取り専用のファイルを指定しました。
- または -
path
によって、非表示のファイルが指定されました。
.NET Framework バージョンと .NET Core バージョンが 2.1 より前の場合: path
は長さ 0 の文字列、空白のみを含む、または無効な文字が 1 つ以上含まれています。 正しくない文字を照会するには、GetInvalidPathChars() メソッドを使用します。
path
が null
です。
指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。
指定されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。
ファイルの作成中に 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