次の方法で共有


コントローラーの追加 (VB)

作成者: Rick Anderson

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

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

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

MVC は Model-View-Controller の略です。 MVC は、各部分が個別に責任を持つようなアプリケーションを開発するためのパターンです。

  • モデル: アプリケーションのデータ。
  • ビュー: アプリケーションが HTML 応答を動的に生成するために使用するテンプレート ファイル。
  • コントローラー: アプリケーションへの受信 URL 要求を処理し、モデル データを取得し、クライアントに応答をレンダリングするビュー テンプレートを指定するクラス。

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

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

AddController

新しいコントローラーに "HelloWorldController" という名前を付け、[追加] をクリックします。

2AddEmptyController

右側の [ソリューション エクスプローラー] で、HelloWorldController.cs という名前の新しいファイルが作成され、そのファイルが IDE で開かれています。

新しい public class HelloWorldController ブロック内に、次に示すコードのような 2 つの新しいメソッドを作成します。 例として、コントローラーから HTML の文字列を直接返します。

Namespace MvcMovie
    Public Class HelloWorldController
        Inherits System.Web.Mvc.Controller

        Public Function Index() As String
            Return "This is my default action..."
        End Function

        Public Function Welcome() As String
            Return "This is the Welcome action method..."
        End Function

    End Class
End Namespace

コントローラーの名前は HelloWorldController で、新しいメソッドの名前は Index です。 アプリケーションを実行します (F5 または Ctrl + F5 を押します)。 ブラウザーが起動したら、"HelloWorld" をアドレスバーのパスに追加します。 (このコンピューターの場合は http://localhost:43246/HelloWorld) ブラウザーは次のスクリーンショットのようになります。 上記のメソッドでは、コードは直接文字列を返しました。 システムに HTML を返すように指示し、実際に HTML が返されました。

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

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

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

URL の最初の部分によって、実行するコントローラー クラスが決まります。 したがって、/HelloWorldHelloWorldController クラスにマップされます。 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 メソッドを変更します。 VB のオプション パラメーター機能を使用して、numTimes パラメーターに値が渡されない場合に、そのパラメーターの既定値を 1 ににする必要があることを示しています。

Public Function Welcome(ByVal name As String, Optional ByVal numTimes As Integer = 1) As String
    Dim message As String = "Hello " & name & ", NumTimes is: " & numTimes
    Return "" & Server.HtmlEncode(message) & ""
End Function

アプリケーションを実行して、http://localhost:xxxx/HelloWorld/Welcome?name=Scott&numtimes=4 を参照します。namenumtimes に、異なる値を試すことができます。 システムは、アドレス バーのクエリ文字列からメソッド内のパラメーターに、名前付きパラメーターを自動的にマップします。

ウィンドウに Hello Scott Num Times が 4 のテキストが表示されたブラウザーを示すスクリーンショット。

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