Visual C++ で基本的なファイル I/O を実行する

[アーティクル]
12/14/2024

この記事では、Microsoft Visual C++ または Visual C++ .NET で基本的なファイル入出力 (I/O) 操作を行う方法について説明します。

元の製品バージョン: Visual C++
元の KB 番号: 307398

まとめ

.NET Framework を初めて使用する場合、.NET Framework でのファイル操作のオブジェクトモデルは、多くの Visual Studio 開発者に人気のある FileSystemObject に似ていることがわかります。

切り替えを簡単にするには、「 Visual Basic で FileSystemObject を使用する方法を参照してください。
この記事の Visual C# .NET バージョンについては、「 Visual C# で基本的なファイル I/O を実行する方法」を参照してください。

この記事では、次の .NET Framework クラスライブラリ名前空間について説明します。

System::ComponentModel
System::Windows::Forms
System::Drawing

.NET Framework では引き続き FileSystemObject を使用できます。 FileSystemObjectはコンポーネントオブジェクトモデル (COM) コンポーネントであるため、.NET Framework では、相互運用レイヤーを介してオブジェクトにアクセスする必要があります。使用する場合は、.NET Framework によってコンポーネントのラッパーが自動的に生成されます。ただし、 File クラス、 FileInfo クラス、 Directory、 DirectoryInfo クラス、および .NET Framework のその他の関連クラスは、相互運用レイヤーのオーバーヘッドなしで、 FileSystemObjectでは使用できない機能を提供します。

デモンストレーションされたファイル I/O 操作

この記事の例では、基本的なファイル I/O 操作について説明します。ステップバイステップの例セクションでは、次の 6 つのファイル I/O 操作を示すサンプルプログラムを作成する方法について説明します。

テキストファイルを読み取る
テキストファイルを書き込む
ファイル情報の表示
ディスクドライブを一覧表示する
サブフォルダーを一覧表示する
ファイルの一覧表示

テキストファイルの読み取り

次のサンプルコードでは、 StreamReader クラスを使用してテキストファイルを読み取ります。ファイルの内容が ListBox コントロールに追加されます。 try...catch ブロックは、ファイルが空の場合にプログラムに警告するために使用されます。ファイルの末尾に達したタイミングを判断するには、多くの方法があります。このサンプルでは、 Peek メソッドを使用して、読み取る前に次の行を調べます。

listBox1->Items->Clear();
try
{
    String* textFile = String::Concat(windir, (S"\\mytest.txt"));
    StreamReader *reader=new  StreamReader(textFile);
    do
    {
        listBox1->Items->Add(reader->ReadLine());
    } while(reader->Peek() != -1);
}

catch (System::Exception *e)
{
    listBox1->Items->Add(e);
}

Visual C++ では、前のコードサンプルをマネージド C++ として正常にコンパイルするには、共通言語ランタイムサポートコンパイラオプション (/clr:oldSyntax) を追加する必要があります。共通言語ランタイムサポートコンパイラオプションを追加するには、次の手順に従います。

[ Project] をクリックし、[ <ProjectName> プロパティ] をクリック。

Note

<ProjectName> は、プロジェクトの名前のプレースホルダーです。
Configuration プロパティ展開し、General をクリックします。
右側のウィンドウで、共通言語ランタイムサポートプロジェクトの設定で Common Language Runtime Support、Old Syntax (/clr:oldSyntax) をクリックして選択します。
適用をクリックし、OK をクリックします。

テキストファイルを書き込む

このサンプルコードでは、 StreamWriter クラスを使用して、ファイルの作成と書き込みを行います。既存のファイルがある場合は、同じ方法で開くことができます。

StreamWriter* pwriter = new StreamWriter(S"c:\\KBTest.txt");
pwriter->WriteLine(S"File created using StreamWriter class.");
pwriter->Close();
listBox1->Items->Clear();
String *filew = new String(S"File Written to C:\\KBTest.txt");
listBox1->Items->Add(filew);

ファイル情報の表示

このサンプルコードでは、 FileInfo クラスを使用してファイルのプロパティにアクセスします。このサンプルでは、Notepad.exeを使用します。プロパティは ListBox コントロールに表示されます。

listBox1->Items->Clear();
String* testfile = String::Concat(windir, (S"\\notepad.exe"));
FileInfo *pFileProps =new FileInfo(testfile);

listBox1->Items->Add(String::Concat(S"File Name = ", (pFileProps->get_FullName())));
listBox1->Items->Add(String::Concat(S"Creation Time = ", (pFileProps->get_CreationTime()).ToString()));
listBox1->Items->Add(String::Concat(S"Last Access Time = " ,(pFileProps->get_LastAccessTime()).ToString()));
listBox1->Items->Add(String::Concat(S"Last Write Time = ", (pFileProps->get_LastWriteTime()).ToString()));
listBox1->Items->Add(String::Concat(S"Size = ", (pFileProps->get_Length()).ToString()));

ディスクドライブを一覧表示する

このサンプルコードでは、 Directory クラスと Drive クラスを使用して、システム上の論理ドライブを一覧表示します。このサンプルでは、結果は ListBox コントロールに表示されます。

listBox1->Items->Clear();
String* drives[] = Directory::GetLogicalDrives();
int numDrives = drives->get_Length();
for (int i=0; i<numDrives; i++)
{
    listBox1->Items->Add(drives[i]);
}

サブフォルダーを一覧表示する

このサンプルコードでは、Directory クラスの GetDirectories メソッドを使用してフォルダーの一覧を取得します。

listBox1->Items->Clear();
String* dirs[] = Directory::GetDirectories(windir);
int numDirs = dirs->get_Length();
for (int i=0; i<numDirs; i++)
{
    listBox1->Items->Add(dirs[i]);
}

ファイルの一覧表示

このサンプルコードでは、Directory クラスの GetFiles メソッドを使用して、ファイルの一覧を取得します。

listBox1->Items->Clear();
String* files[]= Directory::GetFiles(this->windir);
int numFiles = files->get_Length();
for (int i=0; i<numFiles; i++)
{
    listBox1->Items->Add(files[i]);
}

ユーザーがファイルにアクセスすると、多くの問題が発生する可能性があります。ファイルが存在しないか、ファイルが使用中であるか、ユーザーがアクセスしようとしているフォルダーのファイルに対する権限を持っていない可能性があります。生成される可能性のある例外を処理するコードを記述するときは、これらの可能性を考慮してください。

手順の例

Visual Studio .NET を起動します。
[ファイル] メニューの [新規作成] をポイントし、 [プロジェクト] をクリックします。
[ プロジェクトの種類で、 Visual C++ プロジェクト をクリックします。 [Templates セクションで、アプリケーション (.NET) Windows フォームクリックします。
Name ボックスに「KB307398」と入力し、[Location] ボックスに「C:\」と入力し、[OK] をクリックします。
デザインビューで Form1 フォームを開き、F4 キーを押して Properties ウィンドウを開きます。
Properties ウィンドウで、Size フォルダーを展開します。 [ Width ボックスに「 700」と入力します。 [ Height ボックスに「 320」と入力します。
1 つの ListBox コントロールと 6 つの Button コントロールを Form1 に追加します。

Note

ツールボックスを表示するには、View メニューの Toolbox をクリックします。

Properties ウィンドウで、Location、Name、Size、TabIndex、およびこれらのコントロールの Text プロパティを次のように変更します。

コントロール ID	Location	Name	サイズ	TabIndex	Text
button1	500, 32	button1	112, 23	1	テキストファイルの読み取り
button2	500, 64	button2	112, 23	2	テキストファイルの書き込み
button3	500, 96	button3	112, 23	3	ファイル情報の表示
button4	500, 128	button4	112, 23	4	ドライブの一覧表示
button5	500, 160	button5	112, 23	5	サブフォルダーを一覧表示する
button6	500, 192	button6	112, 23	6	ファイルの一覧表示
listBox1	24, 24	listBox1	450, 200	0	listBox1

Form1.h ファイルを開きます。 Form1 クラス宣言で、次のコードを使用して 1 つのプライベート String変数を宣言します。
```
private:
String *windir;
```
Form1 クラスコンストラクターに、次のコードを追加します。
```
windir = System::Environment::GetEnvironmentVariable("windir");
```
ファイル入力出力操作を実行するには、 System::IO 名前空間を追加します。

Shift キーを押しながら F7 キーを押して、デザインビューで Form1 を開きます。 [テキストファイルの読み取り] ボタンをダブルクリックし、次のコードを貼り付けます。

// How to read a text file:
// Use try...catch to deal with a 0 byte file or a non-existant file.
listBox1->Items->Clear();

try
{
    String* textFile = String::Concat(windir, (S"\\mytest.txt"));
    StreamReader *reader=new  StreamReader(textFile);
    do
    {
        listBox1->Items->Add(reader->ReadLine());
    } while(reader->Peek() != -1);
}
catch(FileNotFoundException *ex)
{
    listBox1->Items->Add(ex);
}  

catch (System::Exception *e)
{
    listBox1->Items->Add(e);
}

Form1 デザインビューで、 [テキストファイルの書き込み ] ボタンをダブルクリックし、次のコードを貼り付けます。

// This demonstrates how to create and to write to a text file.
StreamWriter* pwriter = new StreamWriter(S"c:\\KBTest.txt");
pwriter->WriteLine(S"The file was created by using the StreamWriter class.");
pwriter->Close();
listBox1->Items->Clear();
String *filew = new String(S"File written to C:\\KBTest.txt");
listBox1->Items->Add(filew);

Form1 デザインビューで、 View ファイル情報 ボタンをダブルクリックし、メソッドに次のコードを貼り付けます。

// This code retrieves file properties. The example uses Notepad.exe.
listBox1->Items->Clear();
String* testfile = String::Concat(windir, (S"\\notepad.exe"));
FileInfo *pFileProps =new FileInfo(testfile);

listBox1->Items->Add(String::Concat(S"File Name = ", (pFileProps->get_FullName())));
listBox1->Items->Add(String::Concat(S"Creation Time = ", (pFileProps->get_CreationTime()).ToString()));
listBox1->Items->Add(String::Concat(S"Last Access Time = " ,(pFileProps->get_LastAccessTime()).ToString()));
listBox1->Items->Add(String::Concat(S"Last Write Time = ", (pFileProps->get_LastWriteTime()).ToString()));
listBox1->Items->Add(String::Concat(S"Size = ", (pFileProps->get_Length()).ToString()));

Form1 デザインビューで、[リストドライブ] ボタンをダブルクリックし、次のコードを貼り付けます。

// This demonstrates how to obtain a list of disk drives.
listBox1->Items->Clear();
String* drives[] = Directory::GetLogicalDrives();
int numDrives = drives->get_Length();
for (int i=0; i<numDrives; i++)
{
    listBox1->Items->Add(drives[i]);
}

Form1 デザインビューで、[サブフォルダーの一覧] ボタンをダブルクリックし、次のコードを貼り付けます。

// This code obtains a list of folders. This example uses the Windows folder.
listBox1->Items->Clear();
String* dirs[] = Directory::GetDirectories(windir);
int numDirs = dirs->get_Length();
for (int i=0; i<numDirs; i++)
{
    listBox1->Items->Add(dirs[i]);
}

Form1 デザインビューで、[リストファイル] ボタンをダブルクリックし、次のコードを貼り付けます。

// This code obtains a list of files. This example uses the Windows folder.
listBox1->Items->Clear();
String* files[]= Directory::GetFiles(this->windir);
int numFiles = files->get_Length();
for (int i=0; i<numFiles; i++)
{
    listBox1->Items->Add(files[i]);
}

プログラムをビルドして実行するには、Ctrl キーを押しながら F5 キーを押します。

完全なコード例

//Form1.h
#pragma once

namespace KB307398
{
    using namespace System;
    using namespace System::IO;
    using namespace System::ComponentModel;
    using namespace System::Collections;
    using namespace System::Windows::Forms;
    using namespace System::Data;
    using namespace System::Drawing;

    /// <summary>
    /// Summary for Form1
    /// WARNING: If you change the name of this class, you will need to change the
    ///          'Resource File Name' property for the managed resource compiler tool
    ///          associated with all .resx files this class depends on.  Otherwise,
    ///          the designers will not be able to interact properly with localized
    ///          resources associated with this form.
    /// </summary>
    public __gc class Form1 : public System::Windows::Forms::Form
    {
        private:
        String *windir;
        public:
        Form1(void)
        {
            windir = System::Environment::GetEnvironmentVariable("windir");
            InitializeComponent();
        }

        protected:
        void Dispose(Boolean disposing)
        {
            if (disposing && components)
            {
            components->Dispose();
            }
            __super::Dispose(disposing);
        }
        private: System::Windows::Forms::Button *  button1;
        private: System::Windows::Forms::Button *  button2;
        private: System::Windows::Forms::Button *  button3;
        private: System::Windows::Forms::Button *  button4;
        private: System::Windows::Forms::Button *  button5;
        private: System::Windows::Forms::Button *  button6;
        private: System::Windows::Forms::ListBox *  listBox1;

        private:
        /// <summary>
        /// Required designer variable.
        /// </summary>
        System::ComponentModel::Container * components;

        /// <summary>
        /// Required method for Designer support - do not modify
        /// the contents of this method with the code editor.
        /// </summary>
        void InitializeComponent(void)
        {
            this->button1 = new System::Windows::Forms::Button();
            this->button2 = new System::Windows::Forms::Button();
            this->button3 = new System::Windows::Forms::Button();
            this->button4 = new System::Windows::Forms::Button();
            this->button5 = new System::Windows::Forms::Button();
            this->button6 = new System::Windows::Forms::Button();
            this->listBox1 = new System::Windows::Forms::ListBox();
            this->SuspendLayout();
            // button1
            this->button1->Location = System::Drawing::Point(500, 32);
            this->button1->Name = S"button1";
            this->button1->Size = System::Drawing::Size(112, 23);
            this->button1->TabIndex = 1;
            this->button1->Text = S"Read Text File";
            this->button1->Click += new System::EventHandler(this, button1_Click);
            // button2
            this->button2->Location = System::Drawing::Point(500, 64);
            this->button2->Name = S"button2";
            this->button2->Size = System::Drawing::Size(112, 23);
            this->button2->TabIndex = 2;
            this->button2->Text = S"Write Text File";
            this->button2->Click += new System::EventHandler(this, button2_Click);
            // button3
            this->button3->Location = System::Drawing::Point(500, 96);
            this->button3->Name = S"button3";
            this->button3->Size = System::Drawing::Size(112, 23);
            this->button3->TabIndex = 3;
            this->button3->Text = S"View File Information";
            this->button3->Click += new System::EventHandler(this, button3_Click);
            // button4
            this->button4->Location = System::Drawing::Point(500, 128);
            this->button4->Name = S"button4";
            this->button4->Size = System::Drawing::Size(112, 23);
            this->button4->TabIndex = 4;
            this->button4->Text = S"List Drives";
            this->button4->Click += new System::EventHandler(this, button4_Click);
            // button5
            this->button5->Location = System::Drawing::Point(500, 160);
            this->button5->Name = S"button5";
            this->button5->Size = System::Drawing::Size(112, 23);
            this->button5->TabIndex = 5;
            this->button5->Text = S"List Subfolders";
            this->button5->Click += new System::EventHandler(this, button5_Click);
            // button6
            this->button6->Location = System::Drawing::Point(500, 188);
            this->button6->Name = S"button6";
            this->button6->Size = System::Drawing::Size(112, 23);
            this->button6->TabIndex = 6;
            this->button6->Text = S"List Files";
            this->button6->Click += new System::EventHandler(this, button6_Click);
            // listBox1
            this->listBox1->Location = System::Drawing::Point(24, 24);
            this->listBox1->Name = S"listBox1";
            this->listBox1->Size = System::Drawing::Size(450, 199);
            this->listBox1->TabIndex = 0;
            // Form1
            this->AutoScaleBaseSize = System::Drawing::Size(5, 13);
            this->ClientSize = System::Drawing::Size(692, 293);
            this->Controls->Add(this->listBox1);
            this->Controls->Add(this->button6);
            this->Controls->Add(this->button5);
            this->Controls->Add(this->button4);
            this->Controls->Add(this->button3);
            this->Controls->Add(this->button2);
            this->Controls->Add(this->button1);
            this->Name = S"Form1";
            this->Text = S"Form1";
            this->ResumeLayout(false);
        }
        private: System::Void button1_Click(System::Object *  sender, System::EventArgs *  e)
        {
            // This code shows how to read a text file.
            // The try...catch code is to deal with a 0 byte file or a non-existant file.
            listBox1->Items->Clear();

            try
            {
                String* textFile = String::Concat(windir, (S"\\mytest.txt"));
                StreamReader *reader=new  StreamReader(textFile);
                do
                {
                    listBox1->Items->Add(reader->ReadLine());
                }
                while(reader->Peek() != -1);
            }
            catch(FileNotFoundException *ex)
            {
                listBox1->Items->Add(ex);
            }

            catch (System::Exception *e)
            {
                listBox1->Items->Add(e);
            }
        }

        private: System::Void button2_Click(System::Object *  sender, System::EventArgs *  e)
        {
            // This code demonstrates how to create and to write to a text file.
            StreamWriter* pwriter = new StreamWriter(S"c:\\KBTest.txt");
            pwriter->WriteLine(S"The file was created by using the StreamWriter class.");
            pwriter->Close();
            listBox1->Items->Clear();
            String *filew = new String(S"The file was written to C:\\KBTest.txt");
            listBox1->Items->Add(filew);
        }

        private: System::Void button3_Click(System::Object *  sender, System::EventArgs *  e)
         {
            // This code retrieves file properties. This example uses Notepad.exe.
            listBox1->Items->Clear();
            String* testfile = String::Concat(windir, (S"\\notepad.exe"));
            FileInfo *pFileProps  =new FileInfo(testfile);

            listBox1->Items->Add(String::Concat(S"File Name = ", (pFileProps->get_FullName() )) );
            listBox1->Items->Add(String::Concat(S"Creation Time = ", (pFileProps->get_CreationTime() ).ToString()) );
            listBox1->Items->Add(String::Concat(S"Last Access Time = "  ,(pFileProps->get_LastAccessTime() ).ToString()) );
            listBox1->Items->Add(String::Concat(S"Last Write Time = ", (pFileProps->get_LastWriteTime() ).ToString()) );
            listBox1->Items->Add(String::Concat(S"Size = ", (pFileProps->get_Length() ).ToString()) );
        }

        private: System::Void button4_Click(System::Object *  sender, System::EventArgs *  e)
        {
            // The code demonstrates how to obtain a list of disk drives.
            listBox1->Items->Clear();
            String* drives[] = Directory::GetLogicalDrives();
            int numDrives = drives->get_Length();
            for (int i=0; i<numDrives; i++)
            {
                listBox1->Items->Add(drives[i]);
            }
        }

        private: System::Void button5_Click(System::Object *  sender, System::EventArgs *  e)
        {
            // This code obtains a list of folders. This example uses the Windows folder.
            listBox1->Items->Clear();
            String* dirs[] = Directory::GetDirectories(windir);
            int numDirs = dirs->get_Length();
            for (int i=0; i<numDirs; i++)
            {
                listBox1->Items->Add(dirs[i]);
            }
        }

        private: System::Void button6_Click(System::Object *  sender, System::EventArgs *  e)
        {
            // This code obtains a list of files. This example uses the Windows folder.
            listBox1->Items->Clear();
            String* files[]= Directory::GetFiles(this->windir);
            int numFiles = files->get_Length();
            for (int i=0; i<numFiles; i++)
            {
                listBox1->Items->Add(files[i]);
            }
        }
    };
}

//Form1.cpp
#include "stdafx.h"
#include "Form1.h"
#include <windows.h>

using namespace KB307398;

int APIENTRY _tWinMain(HINSTANCE hInstance,
                     HINSTANCE hPrevInstance,
                     LPTSTR    lpCmdLine,
                     int       nCmdShow)
{
    System::Threading::Thread::CurrentThread->ApartmentState = System::Threading::ApartmentState::STA;
    Application::Run(new Form1());
    return 0;
}

次の方法で共有

Visual C++ で基本的なファイル I/O を実行する

まとめ

デモンストレーションされたファイル I/O 操作

テキストファイルの読み取り

テキストファイルを書き込む

ファイル情報の表示

ディスクドライブを一覧表示する

サブフォルダーを一覧表示する

ファイルの一覧表示

手順の例

完全なコード例

関連情報

フィードバック

その他のリソース

次の方法で共有

Visual C++ で基本的なファイル I/O を実行する

まとめ

デモンストレーションされたファイル I/O 操作

テキスト ファイルの読み取り

テキスト ファイルを書き込む

ファイル情報の表示

ディスク ドライブを一覧表示する

サブ フォルダーを一覧表示する

ファイルの一覧表示

手順の例

完全なコード例

関連情報

フィードバック

その他のリソース

テキストファイルの読み取り

テキストファイルを書き込む

ディスクドライブを一覧表示する

サブフォルダーを一覧表示する