「RedirectResult クラス (System.Web.Mvc)」を編集中

RedirectResultクラスとは、[[ASP.NET MVC]]の[[アクション・メソッド]]の戻り値（[[ActionResultクラス]]およびその派生クラス）として、[[Webブラウザ]]に対して指定された[[URI]]に[[リダイレクト]]するよう指示するHTTPレスポンスヘッダーを生成、送信する[[クラス]]である。

== 使い方 ==
RedirectResultクラスの使い方はいたって簡単。
単純に[[リダイレクト]]先の[[URL]]を指定するだけである。
これで[[Webブラウザ]]に対して[[302リダイレクト]]を送信する。
<source lang="csharp">
using System.Web.Mvc;

public class HomeController : Controller 
{
    public ActionResult Index() 
    {
        return new RedirectResult( "http://monobook.org/wiki/PHP" );
    }
}
</source>

これは[[PHP]]でいう以下のコードに相当する。
<source lang="php">
<?php
header( "Location: http://monobook.org/wiki/PHP" );
</source>

=== 301リダイレクト ===
[[ASP.NET MVC 3]]では、[[bool型]]のPermanentという[[プロパティ]]が追加され、永続的に移転したことを示す永久リダイレクト（[[301リダイレクト]]）を発生させるかを指定できるようになった。

なお、[[ASP.NET MVC 3]]で追加されたものであり[[ASP.NET MVC 2]]以前では存在しないので注意。

<source lang="csharp">
using System.Web.Mvc;

public class HomeController : Controller 
{
    public ActionResult Index() 
    {
        // ASP.NET MVC 3でコンストラクタに第2引数（bool型）が追加され、
        // trueにすると301リダイレクトになる。
        return new RedirectResult( "http://monobook.org/wiki/PHP", true );
    }
}
</source>

これは[[PHP]]でいう以下のコードに相当する。
<source lang="php">
<?php
header( "HTTP/1.1 301 Moved Permanently" ); 
header( "Location: http://monobook.org/wiki/PHP" );
</source>

[[ASP.NET MVC 2]]以前で[[301リダイレクト]]をしたい場合は[[ActionResultクラス]]を[[継承]]した自前クラスを作る。
<source lang="csharp">
using System.Web.Mvc;

public class PermanentRedirectResult : ActionResult
{
    public string Url { get; set; }

    public PermanentRedirectResult(string url)
    {
        this.Url = url;
    }

    public override void ExecuteResult(ControllerContext context)
    {
        if (context == null)
        {
            throw new ArgumentNullException("context");
        }
        if (string.IsNullOrEmpty(this.Url))
        {
            throw new ArgumentException("url is null or empty", "Url");
        }

        context.HttpContext.Response.StatusCode = 301;
        context.HttpContext.Response.RedirectLocation = this.Url;
        context.HttpContext.Response.End();
    }
} 
</source>

== 関連項目 ==
* [[ActionResult クラス (System.Web.Mvc)]] - アクションの戻り値
* [[ASP.NET MVC]]

== 参考文献 ==
<references />

== 外部リンク ==

{{stub}}