summary: ASP.NET is a flexible set of tools and web development technologies that allows you to employ a number of applications based on the ASP.NET framework.

In this topic, you will learn how to configure the server-wide ASP.NET settings in Plesk.

Overview

Plesk supports ASP.NET 2.0 and 4.x, as well as ASP.NET Core 2.1 and later. Most ASP.NET configuration settings that commonly need to be customized in order for ASP.NET applications to function in a desirable way can be edited through Plesk.

サーバ全体に対する ASP.NET 設定を構成するには:

  1. Log in to Plesk.

  2. Go to Tools & Settings > ASP.NET Settings (under "Applications & Databases"). The settings for different versions of ASP.NET are located under the corresponding tabs.

    image asp net settings

  3. Set up the strings that determine database connection data for ASP.NET applications which use databases:

    初めて ASP.NET の構成ページを開くと、共通構成を持つ接続パラメータのサンプルが表示されます。サンプルを削除し、独自の文字列に変更することができます。

    • To add a string, click Add one more.
    • To remove a string, click the image cross icon icon next to it.
  4. Set up custom error messages that will be returned by ASP.NET applications:

    • To set the custom error messages mode, select the appropriate option from the "Custom error mode" menu:

      • On: カスタムエラーメッセージが有効になります。
      • Off: カスタムエラーメッセージが無効になり、エラーの詳細が表示されるようになります。
      • リモートのみ: カスタムエラーメッセージはリモートクライアントにのみ表示され、ASP.NET エラーはローカルホストに表示されます。
    • To add a custom error message (which will be applied unless the Off mode was selected), enter the values in the "Custom errors" fields.

      • ステータスコード: エラーページにリダイレクトされる HTTP ステータスコードを定義します。
      • リダイレクト URL: エラーに関する情報をクライアントに提供するエラーページのアドレスを定義します。

      競合を避けるため、既存のエラーコードに対してカスタムエラーメッセージを追加することはできませんが、既存のコードの URL を再定義することはできます。

    • To remove a custom error message from the list, click the image cross icon icon next to it

  5. Configure compilation settings:

    • To determine the programming language to be used as default in dynamic compilation files, choose an entry from the "Default webpage language" list.

    • To enable compiling retail binaries, leave the "Switch on debugging" checkbox cleared.

    • To enable compiling debug binaries, select the "Switch on debugging" checkbox. In this case, the source code fragments containing error will be shown in a diagnostic page message.

      注釈: アプリケーションをデバッグモードで実行すると、メモリやパフォーマンスのオーバーヘッドが発生します。デバッグは、アプリケーションのテスト時に使用して、本番環境では無効にすることをお勧めします。

  6. Configure encoding settings for ASP.NET applications:

    • To set an adopted encoding of all incoming requests, enter an encoding value into the "Request encoding" field (default is utf-8).
    • To set an adopted encoding of all responses, enter an encoding value into the "Response encoding" field (default is utf-8).
    • To set an encoding which must be used by default for parsing of .aspx, .asmx, and .asax files, enter an encoding value into the "File encoding" field (default is Windows-1252).
    • To set a culture which must be used by default for processing incoming web requests, select an appropriate item from the "Culture" list.
    • To set a culture which must be used by default when processing searches for a locale-dependent resource, select an appropriate item from the "UI Culture" list.
  7. Set a code access security trust level for ASP.NET applications:

    CAS 信頼レベルとは、アプリケーションに適用される一連の制限のことです。たとえば、信頼レベル(低)では、アプリケーションのネットワーク機能(メールの送信など)が制限されますが、信頼レベル(フル)ではすべての規制が解除されます。

    • To allow changing the CAS trust level for websites, select the checkbox "Allow changing the CAS trust level for individual websites". If you do not select this checkbox, websites will use the server-wide setting. Otherwise, each website will be able to have its own CAS trust level specified in the website's hosting settings.

      注釈: アセンブリに割り当てた信頼レベルが低すぎると、アセンブリが正しく機能しません。パーミッションレベルの詳細については、https://msdn.microsoft.com/ja-jp/library/Aa302425

  8. Set client session parameters in the "Session Settings" field:

    • To set up the default authentication mode for applications, select an appropriate item from the "Authentication mode" list. "Windows" authentication mode should be selected if any form of IIS authentication is used.
    • To set up time that a session can remain idle before it is abandoned, enter the appropriate number of minutes into the "Session timeout" field.
  9. Click Save to apply all changes.

注釈: Plesk は .NET フレームワークの異なるバージョンの設定を別々にサポートしています。

注釈: If you want to use ASP.NET Core web applications, select the "Microsoft ASP.NET Core " component when installing Plesk. After that, you can upload your ASP.NET Core application to your web site and use it. In this case, it is recommended to switch off the ASP.NET support for your domain to save server resources. To do so, go to Websites & Domains > find the domain that will host your application > go to the "Hosting & DNS" tab > Hosting and clear the Microsoft ASP.NET checkbox.