C#でURLからファイルをダウンロードする方法（WebClientクラスの使い方）

C#でURLからファイルをダウンロードする基本

C#では、WebClientクラスを使うことで、URLから簡単にファイルをダウンロードできます。WebClientクラスはSystem.Net名前空間に含まれており、URIで識別されるローカル・イントラネット・インターネット上のあらゆるリソースとの間でデータを送受信するための共通メソッドを提供しています。

Webクライアントとは何か

Webクライアントとは、コンピュータにインストールされ、ユーザーの要求に応じてWebサーバーとやり取りするアプリケーションやWebブラウザ（Google Chrome、Internet Explorer、Opera、Firefox、Safariなど）を指します。本質的には、サーバーから処理済みのデータを受け取って利用する「消費者側」のアプリケーションです。

クライアントとサーバーの関係

クライアントとサーバーは、1つの接続を構成する2つの要素であり、それぞれ別々のマシン上で動作します。Webクライアントが情報を要求し、Webサーバー側はリモートコンピュータからの要求を受け付けて、要求された情報を返す役割を担います。

Webサーバーは、クライアントが閲覧できるように情報を保存する責任を持っており、通常はWebホストとしても機能します。Webホストはサーバーへの接続を許可することで、保存された情報の閲覧を可能にします。

WebClientクラスの仕組みと基本的な使い方

C#のWebClientクラスは、内部でWebRequestクラスを利用してリソースへのアクセスを実現しています。WebClientのインスタンスは、WebRequest.RegisterPrefixメソッドで登録された任意のWebRequest派生クラスを通じてデータにアクセスできます。

ファイルのダウンロードにはDownloadFileメソッドを使用します。基本的な書き方は以下の通りです。

WebClient client = new WebClient();
client.DownloadFile("url", "path");

サンプルコード

ここでは、「https://downloadfreeimages.jpg」から画像をダウンロードし、コンピュータのローカルディレクトリに保存する例を紹介します。

using System;
using System.Net;

namespace DemoApplication {
    public class Program {
        public static void Main() {
            string url = "https://downloadfreeimages.jpg";
            string savePath = @"D:\Demo\FreeImages.jpg";
            WebClient client = new WebClient();
            client.DownloadFile(url, savePath);
            Console.ReadLine();
        }
    }
}

実行結果

上記のコードを実行すると、指定したURLから画像がダウンロードされ、指定したパスに自動的に保存されます。

D:\Demo

補足：HttpClientという選択肢

.NET Framework 4.5以降では、非同期処理に対応したより柔軟なHttpClientクラスの使用が推奨されています。GetAsyncやGetByteArrayAsyncなどのメソッドを活用すれば、UIをブロックせずにファイルをダウンロードできるため、モダンなアプリケーション開発ではこちらも検討すると良いでしょう。