コントローラーの追加 (C#)

[アーティクル]
05/30/2024

Note

ASP.NET MVC 5 と Visual Studio 2013 を使用するこのチュートリアルの更新版は、こちらで入手できます。より安全で、より簡単に操作でき、より多くの機能を備えています。

このチュートリアルでは、Microsoft Visual Web Developer 2010 Express Service Pack 1 (Microsoft Visual Studio の無料版) を使用した ASP.NET MVC Web アプリケーション構築の基本事項を説明します。開始する前に、以下に示す前提条件がインストールされていることを確認してください。次のリンクをクリックすると、これらをすべてインストールできます: Web Platform Installer。また、次のリンクを使用して前提条件となるソフトウェアを個別にインストールすることもできます。

Visual Studio Web Developer Express SP1 の前提条件

ASP.NET MVC 3 Tools Update

SQL Server Compact 4.0 (ランタイム + ツールのサポート)

Visual Web Developer 2010 ではなく Visual Studio 2010 を使用する場合は、Visual Studio 2010 の前提条件のリンクをクリックして、前提条件をインストールします。

このトピックに関連する、Visual Web Developer プロジェクトと C# ソースコードを使用できます。 C# バージョンをダウンロードします。 Visual Basic を使用する場合は、このチュートリアルの Visual Basic バージョンに切り替えてください。

MVC は Model-View-Controller の略です。 MVC は、適切に設計され、保守が容易なアプリケーションを開発するためのパターンです。 MVC ベースのアプリケーションには、次のものが含まれます。

コントローラー: アプリケーションへの受信要求を処理し、モデルデータを取得し、クライアントに応答を返すビューテンプレートを指定するクラス。
モデル: アプリケーションのデータを表し、検証ロジックを使ってそのデータにビジネスルールを適用するクラス。
ビュー: アプリケーションが HTML 応答を動的に生成するために使うテンプレートファイル。

このチュートリアルシリーズでは、これらすべての概念について説明し、それらを使用してアプリケーションをビルドする方法について説明します。

まず、コントローラークラスを作成しましょう。 ソリューションエクスプローラーで、Controllers フォルダーを右クリックし、[コントローラーの追加] を選択します。

新しいコントローラーに "HelloWorldController" という名前を付けます。既定のテンプレートを [Empty controller] のままにし、[追加] をクリックします。

ソリューションエクスプローラーで、HelloWorldController.cs という名前の新しいファイルが作成されたことに注意してください。ファイルは IDE で開かれます。

[Hello World Controller dot c s] タブと [ソリューションエクスプローラー] ウィンドウを示すスクリーンショット。Hello World Controller dot c s が Controllers フォルダーで選択されています。

public class HelloWorldController ブロック内に、次のコードのような 2 つのメソッドを作成します。コントローラーは、例のように HTML の文字列を返します。

using System.Web;
using System.Web.Mvc; 
 
namespace MvcMovie.Controllers 
{ 
    public class HelloWorldController : Controller 
    { 
        // 
        // GET: /HelloWorld/ 
 
        public string Index() 
        { 
            return "This is my <b>default</b> action..."; 
        } 
 
        // 
        // GET: /HelloWorld/Welcome/ 
 
        public string Welcome() 
        { 
            return "This is the Welcome action method..."; 
        } 
    } 
}

コントローラーの名前は HelloWorldController、上記の最初のメソッドの名前は Index です。これをブラウザーから呼び出してみましょう。アプリケーションを実行します (F5 または Ctrl + F5 を押します)。ブラウザーで、アドレスバーのパスに "HelloWorld" を追加します。 (たとえば、次の図では http://localhost:43246/HelloWorld.) ブラウザーのページは次のスクリーンショットのようになります。上記のメソッドでは、コードは直接文字列を返しました。システムに HTML を返すように指示し、実際に HTML が返されました。

ブラウザーを示すスクリーンショット。これは、ウィンドウ内のテキストである私の既定のアクションです。

ASP.NET MVC は、受信 URL に応じて異なるコントローラークラス (およびそれらに含まれるさまざまなアクションメソッド) を呼び出します。 ASP.NET MVC で使われる既定のマッピングロジックでは、次のような形式を使って、呼び出すコードを決定します。

/[Controller]/[ActionName]/[Parameters]

URL の最初の部分によって、実行するコントローラークラスが決まります。したがって、/HelloWorld は HelloWorldController クラスにマップされます。 URL の 2 番目の部分では、実行するクラスのアクションメソッドが決定されます。したがって、/HelloWorld/Index によって HelloWorldController クラスの Index メソッドが実行されます。参照する必要があったのは /HelloWorld のみであり、Index メソッドは既定で使用されていたことに注意してください。これは、メソッド明示的に指定されていない場合に、Index という名前のメソッドがコントローラーで呼び出される既定のメソッドだからです。

http://localhost:xxxx/HelloWorld/Welcome を参照します。 Welcome メソッドが実行され、"This is the Welcome action method..." という文字列を返します。既定の MVC マッピングは /[Controller]/[ActionName]/[Parameters] です。この URL では、コントローラーは HelloWorld で、Welcome がアクションメソッドです。 URL の [Parameters] の部分はまだ使っていません。

ブラウザーを示すスクリーンショット。これは、ウィンドウ内のテキストである Welcome アクションメソッドです。

この例を少し変更して、URL からコントローラーにパラメーター情報を渡せるようにしてみましょう (たとえば、/HelloWorld/Welcome?name=Scott&numtimes=4)。次に示すように、2 つのパラメーターを含むように Welcome メソッドを変更します。このコードでは、C# のオプションパラメーター機能を使用して、numTimes パラメーターに値が渡されない場合に、そのパラメーターの既定値を 1 にする必要があることを示しています。

public string Welcome(string name, int numTimes = 1) {
     return HttpUtility.HtmlEncode("Hello " + name + ", NumTimes is: " + numTimes);
}

アプリケーションを実行し、サンプル URL を参照します (http://localhost:xxxx/HelloWorld/Welcome?name=Scott&numtimes=4))。 URL の name と numtimes に違う値を指定してみてください。システムは、アドレスバーのクエリ文字列から名前付きパラメーターをメソッドのパラメーターに自動的にマップします。

ブラウザーを示すスクリーンショット。Hello Scott Num Times は、ウィンドウ内のテキストである 4 です。

これらの例の両方では、コントローラーによって MVC の "VC" 部分が実行されています。つまり、ビューとコントローラーが動作します。コントローラーは HTML を直接返しています。通常、コントローラーが HTML を直接返すことは、コーディングが非常に面倒になるため望ましくありません。代わりに、通常は、別のビューテンプレートファイルを使って、HTML 応答を生成できるようにします。次に、これを行う方法を見てみましょう。

前へ次へ

次の方法で共有

コントローラーの追加 (C#)

フィードバック

その他のリソース