Inhalt: 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.

Überblick

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.

So konfigurieren Sie die serverweiten ASP.NET-Einstellungen:

  1. Melden Sie sich in Plesk an.

  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:

    Beim ersten Öffnen der ASP.NET-Konfigurationsseite werden Beispiele für Verbindungsparameter mit häufig verwendeten Kombinationen angezeigt. Sie können diese löschen und eigene Zeichenfolgen angeben.

    • To add a string, click Add one more.
    • Um eine Zeichenfolge zu entfernen, klicken Sie direkt daneben auf image cross icon.
  4. Richten Sie benutzerdefinierte Fehlermeldungen ein, die von ASP.NET-Anwendungen zurückgegeben werden:

    • Um den Modus für die benutzerdefinierten Meldungen festzulegen, wählen Sie eine entsprechende Option im Menü „Benutzerdefinierter Fehlermodus“ aus:

      • An: Benutzerdefinierte Fehlermeldungen sind aktiviert.
      • Aus: Benutzerdefinierte Fehlermeldungen sind deaktiviert und es werden detaillierte Fehler angezeigt.
      • Nur remote: Benutzerdefinierte Fehlermeldungen werden nur für Remoteclients und ASP.NET-Fehler für den lokalen Host gezeigt.
    • To add a custom error message (which will be applied unless the Off mode was selected), enter the values in the „Custom errors“ fields.

      • Der Statuscode definiert den HTTP-Statuscode, der zur Umleitung auf die Fehlerseite führt.
      • Die URL zur Weiterleitung definiert die Webadresse der Fehlerseite, auf der dem Client die Fehlerinformationen angezeigt werden.

      Aufgrund möglicher Konflikte ist es nicht möglich, eine benutzerdefinierte Fehlermeldung mit einem bereits vorhandenen Fehlercode hinzuzufügen. Sie können jedoch die URL für den vorhandenen Code neu definieren.

    • Um eine benutzerdefinierte Fehlermeldung aus der Liste zu entfernen, klicken Sie auf image cross icon

  5. Configure compilation settings:

    • Um die Programmiersprache zu bestimmen, die als Standard in dynamischen Kompilierungsdateien verwendet werden soll, wählen Sie einen Eintrag in der Liste „Standardsprache der Webseite“ aus.

    • Um die Kompilierung von Retail-Binärdateien zu aktivieren, lassen Sie das Kontrollkästchen bei „Debugging aktivieren“ leer.

    • Um die Kompilierung von Debug-Binärdateien zu ermöglichen, aktivieren Sie das Kontrollkästchen „Debugging aktivieren“. In diesem Fall wird in einer Meldung auf einer Diagnoseseite angezeigt, in welchen Quellcodefragmenten der Fehler enthalten ist.

      Bemerkung: Beim Ausführen von Anwendungen im Debugmodus wird mehr Speicher und/oder Leistung benötigt. Es wird empfohlen, das Debugging nur während der Testphase einer Anwendung zu verwenden und es vor dem Bereitstellen der Anwendung in ein Produktionsszenario zu deaktivieren.

  6. Configure encoding settings for ASP.NET applications:

    • Um für alle eingehenden Abfragen die Übernahme des Zeichensatzes festzulegen, geben Sie einen Kodierungswert in das Feld „Anfragenkodierung“ ein (der Standardwert ist „utf-8“).
    • Um für alle Antworten die Übernahme des Zeichensatzes festzulegen, geben Sie einen Kodierungswert in das Feld „Antwortkodierung“ ein (der Standardwert ist „utf-8“).
    • Um eine Kodierung festzulegen, die als Standard für die Analyse von .aspx-, .asmx- und .asax- Dateien verwendet werden soll, geben Sie einen Kodierungswert in das Feld „Dateikodierung“ ein (der Standardwert ist „Windows-1252“).
    • Um eine Sprache festzulegen, die standardmäßig für die Verarbeitung eingehender Webabfragen verwendet werden soll, wählen Sie das entsprechende Element in der Liste „Sprache“ aus.
    • Um eine Sprache festzulegen, die standardmäßig für die Verarbeitung von Suchen nach einer gebietsschemaabhängigen Ressource verwendet werden soll, wählen Sie das entsprechende Element in der Liste „UI-Sprache“ aus.
  7. Set a code access security trust level for ASP.NET applications:

    Die CAS-Vertrauensstufe ist eine Auswahl von Einschränkungen, die auf eine Anwendung angewendet werden. Beispielsweise beschränkt eine niedrige Vertrauensstufe die Netzwerkrechte einer Anwendung (wie das Senden von E-Mails etc.), während eine volle Vertrauensstufe jegliche Einschränkungen entfernt.

    • Wenn Sie die Änderung der CAS-Vertrauensstufe für Websites zulassen wollen, müssen Sie das Kontrollkästchen bei „Änderung der CAS-Vertrauensstufe für einzelne Websites zulassen“ aktivieren. Sollten Sie das Kontrollkästchen nicht aktivieren, verwenden Websites die serverweite Einstellung. Und bei aktiviertem Kästchen kann jede Website ihre eigene CAS-Vertrauensstufe besitzen, die in den Hosting-Einstellungen der Website angegeben ist.

      Bemerkung: Wenn einer Assembly eine zu niedrige Vertrauensstufe zugewiesen wird, funktioniert sie nicht korrekt. Weitere Informationen zu den Berechtigungsstufen finden Sie unter https://msdn.microsoft.com/de-de/library/Aa302425

  8. Legen Sie die Clientsitzungsparameter im Feld „Sitzungseinstellungen“ fest:

    • Um den Standardauthentifizierungsmodus für Anwendungen einzurichten, wählen Sie das entsprechende Element in der Liste „Authentifizierungsmodus“ aus. Wenn eine Form der IIS-Authentifizierung verwendet wird, muss der Authentifizierungsmodus „Windows“ ausgewählt werden.
    • Um einzurichten, wie lange eine Sitzung im Leerlauf bleiben kann, bevor sie abgebrochen wird, geben Sie die entsprechende Anzahl an Minuten in das Feld „Sitzungstimeout“ ein.
  9. Klicken Sie auf Speichern, um alle Änderungen zu übernehmen.

Bemerkung: Plesk unterstützt separate Konfigurationen für verschiedene Versionen von .NET Framework.

Bemerkung: 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.