Freigeben über

Konfigurieren Schritt 2: Konfigurieren von ASP.NET Einstellungen

  • Artikel

von Keith Newman und Robert McMurray

2.1. Sitzungszustandseinstellungen

Unter Planen einer ASP.NET-Website auf IIS haben Sie eine der folgenden Optionen für die Sitzungszustandsspeicherung ausgewählt:

  • In-Process: Der Sitzungszustand wird im Arbeitsprozess gespeichert, in dem die ASP.NET-Anwendung ausgeführt wird.
  • Zustandsserver: Der Sitzungszustand wird außerhalb des Arbeitsprozesses gespeichert, in dem die ASP.NET-Anwendung ausgeführt wird.
  • SQL Server: Der Sitzungszustand wird in einer SQL Server-Datenbank gespeichert.

Sie haben sich möglicherweise auch dazu entschieden, Sitzungsdaten in einem Cookie auf dem Clientcomputer zu speichern. Sie können sogar die Verwendung von Cookies mit einer der anderen Speichermethoden kombinieren. Sie können beispielsweise Authentifizierungsdaten in einem Cookie speichern, während andere Sitzungszustandsdaten in einer SQL-Serverdatenbank gespeichert werden.

In den folgenden Abschnitten wird beschrieben, wie der Sitzungszustand auf Basis der vorgenommenen Planungsentscheidungen konfiguriert wird:

Speichern des Sitzungszustands „In-Process“

In diesem Abschnitt wird beschrieben, wie der In-Process-Sitzungszustand über die Benutzeroberfläche des IIS-Managers oder über die Befehlszeile konfiguriert wird.

So aktivieren Sie den In-Process-Sitzungszustand über die Benutzeroberfläche

  1. Navigieren Sie in IIS-Manager zu der Ebene, die Sie verwalten möchten.

  2. Doppelklicken Sie in der Featureansicht auf Sitzungszustand.

  3. Klicken Sie auf der Seite Sitzungszustand im Bereich Einstellungen für den Sitzungszustandsmodus auf In-Process.

  4. (Optional) Konfigurieren Sie die Cookieeinstellungen auf der Seite Sitzungszustand im Bereich Cookieeinstellungen.

    Weitere Informationen zu Cookieeinstellungen finden Sie unter Cookiemodus für den Sitzungszustand.

  5. Geben Sie in das Feld Timeout einen Timeoutwert im Format hh:mm:ss ein. Geben Sie z. B. „00:15:00“ für 15 Minuten ein.

  6. (Optional) Aktivieren Sie das Kontrollkästchen Hostingidentität für Identitätswechsel verwenden, um die Windows-Authentifizierung und die Hostprozessidentität (entweder eine ASP.NET- oder Windows-Dienstidentität) für Remoteverbindungen zu verwenden.

  7. Wählen Sie im Bereich Aktionen die Option Übernehmen aus.

So aktivieren Sie den In-Process-Sitzungszustand über die Befehlszeile

Verwenden Sie die folgende Syntax, um den In-Process-Sitzungszustand zu aktivieren:

appcmd set config /commit:WEBROOT /section:sessionState /mode:InProc

Die Variable mode:InProc aktiviert den In-Process-Sitzungszustand. Der In-Process-Sitzungszustand ist standardmäßig aktiviert.

Hinweis

Wenn Sie „Appcmd.exe“ verwenden, um das <sessionState>-Element auf globaler Ebene in IIS 8 zu konfigurieren, geben Sie /commit:WEBROOT im Befehl an, damit Konfigurationsänderungen an der Datei „Web.config“ im Stamm und nicht an der Datei „ApplicationHost.config“ vorgenommen werden.

Verwenden Sie die folgende Syntax, um die Standardzeit anzugeben, für die ein Sitzungsobjekt nach der letzten Anforderung für das jeweilige Objekt verwaltet wird:

appcmd set config /section:asp /timeout:timeSpan

Die Variable timeSpan gibt die maximale Dauer (hh:mm:ss) an, für die ein Sitzungsobjekt nach der letzten mit dem Objekt verknüpften Anforderung verwaltet wird. Der Standardwert ist 00:20:00.

Speichern des Sitzungszustands mithilfe eines Zustandsservers

In diesem Abschnitt wird beschrieben, wie ein Zustandsserver für die Sitzungszustandsspeicherung über die Benutzeroberfläche des IIS-Managers oder über die Befehlszeile konfiguriert wird.

In Planen einer ASP.NET-Website auf IIS haben Sie die folgenden Designentscheidungen getroffen:

  • Definieren Sie eine Verbindungszeichenfolge für den Zustandsserver.
  • Geben Sie die Anzahl der Sekunden vor dem Timeout der Verbindung an.
  • Entscheiden Sie, ob die Komprimierung aktiviert werden soll.
  • Entscheiden Sie, ob Sitzungszustandsdaten in einem Cookie gespeichert werden sollen.

So konfigurieren Sie einen Zustandsserver zum Verwalten des Sitzungszustands über die Benutzeroberfläche

  1. Navigieren Sie in IIS-Manager zu der Ebene, die Sie verwalten möchten.
  2. Doppelklicken Sie in der Featureansicht auf Sitzungszustand.
  3. Klicken Sie auf der Seite Sitzungszustand im Bereich Einstellungen für den Sitzungszustandsmodus auf Zustandsserver.
  4. Geben Sie eine Verbindungszeichenfolge in das Textfeld Verbindungszeichenfolge ein, oder klicken Sie auf Erstellen, um eine Verbindungszeichenfolge zu erstellen.
  5. Geben Sie im Textfeld Timeout (in Sekunden) einen Timeoutwert ein. Standardmäßig beträgt der Timeoutwert 10 Sekunden.
  6. (Optional) Konfigurieren Sie die Cookieeinstellungen auf der Seite Sitzungszustand im Bereich Cookieeinstellungen. Weitere Informationen zu Cookieeinstellungen finden Sie unter Cookiemodus für den Sitzungszustand.
  7. (Optional) Aktivieren Sie das Kontrollkästchen Hostingidentität für Identitätswechsel verwenden, um die Windows-Authentifizierung und die Hostprozessidentität (entweder eine ASP.NET- oder Windows-Dienstidentität) für Verbindungen zur Datenbank zu verwenden.
  8. Wählen Sie im Bereich Aktionen die Option Übernehmen aus.

So konfigurieren Sie einen Zustandsserver zum Verwalten des Sitzungszustands über die Befehlszeile

Verwenden Sie die folgende Syntax zum Konfigurieren eines Zustandsservers zum Verwalten des Sitzungszustands:

appcmd set config /commit:WEBROOT /section:sessionState /mode:StateServer /stateConnectionString:string /stateNetworkTimeout:timeSpan /useHostingIdentity:true|false

Die Variable mode:StateServer legt den Sitzungszustandsmodus zum Speichern der Sitzungsdaten auf einem Zustandsserver fest. Die Variable string definiert standardmäßig die Verbindungszeichenfolge, die vom Zustandsserver verwendet wird. Die Standardeinstellung ist tcpip=loopback:42424. Die Variable timeSpan legt die Zeit in Sekunden fest, die die Verbindung zum Zustandsserver aufrecht erhalten bleibt. Die Standardeinstellung beträgt 10 Sekunden. Die Variable useHostingIdentity:true|false aktiviert oder deaktiviert die Verwendung der Windows-Authentifizierung und der Hostprozessidentität (entweder eine ASP.NET- oder Windows-Dienstidentität) für Verbindungen zur Datenbank. Der Standardwert ist true.

Hinweis

Wenn Sie „Appcmd.exe“ verwenden, um das <sessionState>-Element auf globaler Ebene in IIS 8 zu konfigurieren, geben Sie /commit:WEBROOT im Befehl an, damit Konfigurationsänderungen an der Datei „Web.config“ im Stamm und nicht an der Datei „ApplicationHost.config“ vorgenommen werden.

Speichern des Sitzungszustands mithilfe von SQL Server

In diesem Abschnitt wird beschrieben, wie eine SQL-Serverdatenbank für die Sitzungszustandsspeicherung über die Benutzeroberfläche des IIS-Managers oder über die Befehlszeile konfiguriert wird.

In Planen einer ASP.NET-Website auf IIS haben Sie die folgenden Designentscheidungen getroffen:

  • Definieren Sie eine Verbindungszeichenfolge für die Datenbank.
  • Geben Sie die Anzahl der Sekunden vor dem Timeout der Verbindung an.
  • Geben Sie die Anzahl der Sekunden vor dem Versuch einer Verbindungswiederherstellung an.
  • Entscheiden Sie, ob eine benutzerdefinierte Datenbank aktiviert werden soll.
  • Entscheiden Sie, ob die Komprimierung aktiviert werden soll.
  • Entscheiden Sie, ob Sitzungszustandsdaten in einem Cookie gespeichert werden sollen.

So konfigurieren Sie einen SQL-Server zum Verwalten des Sitzungszustands über die Benutzeroberfläche

  1. Navigieren Sie in IIS-Manager zu der Ebene, die Sie verwalten möchten.
  2. Doppelklicken Sie in der Featureansicht auf Sitzungszustand.
  3. Klicken Sie auf der Seite Sitzungszustand im Bereich Einstellungen für den Sitzungszustandsmodus auf SQL Server.
  4. Geben Sie eine Verbindungszeichenfolge in das Textfeld Verbindungszeichenfolge ein, oder klicken Sie auf Erstellen, um eine Verbindungszeichenfolge zu erstellen. Wenn sich der SQL-Server auf einem von Ihnen verwalteten Server befindet, wählen Sie LocalSqlServer im Textfeld Verbindungszeichenfolge auf.
  5. Geben Sie im Textfeld Timeout einen Timeoutwert ein.
  6. (Optional) Aktivieren Sie das Kontrollkästchen Benutzerdefinierte Datenbank aktivieren, um eine benutzerdefinierte Datenbank zum Speichern der Sitzungszustandsdaten zu verwenden.
  7. (Optional) Konfigurieren Sie die Cookieeinstellungen auf der Seite Sitzungszustand im Bereich Cookieeinstellungen. Weitere Informationen zu Cookieeinstellungen finden Sie unter Cookiemodus für den Sitzungszustand.
  8. (Optional) Aktivieren Sie das Kontrollkästchen Hostingidentität für Identitätswechsel verwenden, um die Windows-Authentifizierung und die Hostprozessidentität (entweder eine ASP.NET- oder Windows-Dienstidentität) für Remoteverbindungen zur SQL-Datenbank zu verwenden.
  9. Wählen Sie im Bereich Aktionen die Option Übernehmen aus.

So konfigurieren Sie einen SQL-Server zum Verwalten des Sitzungszustands über die Befehlszeile

Verwenden Sie die folgende Syntax zum Konfigurieren eines Zustandsservers zum Verwalten des Sitzungszustands:

appcmd set config /commit:WEBROOT /section:sessionState /mode:SqlServer /sqlConnectionString:string /sqlCommandTimeout:timeSpan /useHostingIdentity:true|false

Die Variable mode:SqlServer legt den Sitzungszustandsmodus zum Speichern der Sitzungsdaten in einer SQL-Datenbank fest. Die Variable string definiert standardmäßig die Verbindungszeichenfolge, die vom SQL-Server verwendet wird. Die Standardeinstellung ist „LocalSqlServer“. Die Variable timeSpan legt die Zeit in Sekunden fest, die die Verbindung zum SQL-Server aufrecht erhalten bleibt. Der Standardwert ist 30 Sekunden. Die Variable useHostingIdentity:true|false aktiviert oder deaktiviert die Verwendung der Windows-Authentifizierung und der Hostprozessidentität (entweder eine ASP.NET- oder Windows-Dienstidentität) für Verbindungen zur Datenbank. Der Standardwert ist true.

Hinweis

Wenn Sie „Appcmd.exe“ verwenden, um das <sessionState>-Element auf globaler Ebene in IIS 8 zu konfigurieren, geben Sie /commit:WEBROOT im Befehl an, damit Konfigurationsänderungen an der Datei „Web.config“ im Stamm und nicht an der Datei „ApplicationHost.config“ vorgenommen werden.

In diesem Abschnitt wird beschrieben, wie eine SQL-Serverdatenbank für die Sitzungszustandsspeicherung über die Benutzeroberfläche des IIS-Managers oder über die Befehlszeile konfiguriert wird.

In Planen einer ASP.NET-Website auf IIS haben Sie die folgenden Designentscheidungen getroffen:

  • Wählen Sie einen Cookiemodus aus: „Automatische Erkennung“, „Cookies verwenden“, „Geräteprofil verwenden“ oder „URI verwenden“.
  • Geben Sie den Namen des Cookies an, sofern Sie nicht „URI verwenden“ ausgewählt haben.
  • Geben Sie die Anzahl der Minuten bis zum Timeout des Cookies an, sofern Sie nicht „URI verwenden“ ausgewählt haben.
  • Legen Sie fest, ob eine abgelaufene Sitzungs-ID neu generiert werden soll, sofern Sie nicht „Cookies verwenden“ ausgewählt haben.

So konfigurieren Sie den Modus „Cookies verwenden“ für den Sitzungszustand über die Benutzeroberfläche

  1. Navigieren Sie in IIS-Manager zu der Ebene, die Sie verwalten möchten.
  2. Doppelklicken Sie in der Featureansicht auf Sitzungszustand.
  3. Wählen Sie auf der Seite Sitzungszustand im Bereich Cookieeinstellungen die Option Cookies verwenden aus der Dropdownliste Modus aus.
  4. Geben Sie einen Cookienamen in das Textfeld Name ein, oder verwenden Sie den Standardcookienamen, ASP.NET_SessionId.
  5. Geben Sie einen Timeoutwert in das Textfeld Timeout ein, oder verwenden Sie „20 Minuten“, den Standardtimeoutwert.
  6. Wählen Sie im Bereich Aktionen die Option Übernehmen aus.

So konfigurieren Sie den Modus „Cookies verwenden“ für den Sitzungszustand über die Befehlszeile

Verwenden Sie die folgende Syntax, um den Modus „Cookies verwenden“ für den Sitzungszustand zu konfigurieren:

appcmd set config /commit:WEBROOT /section:sessionState /cookieless:UseCookies /cookieName:string /timeout:timeSpan

Die Variable cookieless:UseCookies konfiguriert IIS 8 für die Verwendung des Cookiemodus für den Sitzungszustand. Dies ist der Standardwert. Die Variable string ist der Name des Cookies. Der Standardwert ist ASP.NET_SessionId. Die Variable timeSpan legt die Zeit in Minuten fest, nach der das Cookie abläuft. Der Standardwert beträgt 20 Minuten. Geben Sie z. B. Folgendes an der Eingabeaufforderung ein, und drücken Sie dann die Eingabetaste, um ein Cookiemodus-Cookie für den Sitzungszustand festzulegen (mit der Bezeichnung MyCookie, das nach 40 Minuten abläuft):

appcmd set config /commit:WEBROOT /section:sessionState /cookieless:UseCookies /cookieName:MyCookie /timeout:40

Hinweis

Wenn Sie „Appcmd.exe“ verwenden, um das <sessionState>-Element auf globaler Ebene in IIS 8 zu konfigurieren, geben Sie /commit:WEBROOT im Befehl an, damit Konfigurationsänderungen an der Datei „Web.config“ im Stamm und nicht an der Datei „ApplicationHost.config“ vorgenommen werden.

Verwenden Sie die folgende Syntax, um den Cookiemodus „Geräteprofil“ für den Sitzungszustand zu konfigurieren:

appcmd set config /commit:WEBROOT /section:sessionState /cookieless:UseDeviceProfile /cookieName:string /timeout:timeSpan /regenerateExpiredSessionId:true|false

Die Variable cookieless:UseDeviceProfile konfiguriert IIS 8 für die Verwendung des Cookiemodus „Geräteprofil“ für den Sitzungszustand. Die Variable string ist der Name des Cookies. Der Standardwert ist ASP.NET_SessionId. Die Variable timeSpan legt die Zeit in Minuten fest, nach der das Cookie abläuft. Der Standardwert beträgt 20 Minuten. Die Variable regenerateExpiredSessionId:true|false aktiviert oder deaktiviert die erneute Generierung von abgelaufenen Sitzungs-IDs.

Hinweis

Wenn Sie „Appcmd.exe“ verwenden, um das <sessionState>-Element auf globaler Ebene in IIS 8 zu konfigurieren, geben Sie /commit:WEBROOT im Befehl an, damit Konfigurationsänderungen an der Datei „Web.config“ im Stamm und nicht an der Datei „ApplicationHost.config“ vorgenommen werden.

Verwenden Sie die folgende Syntax, um den Modus „Automatisch erkennen“ für den Sitzungszustand zu konfigurieren:

appcmd set config /commit:WEBROOT /section:sessionState /cookieless:AutoDetect /cookieName:string /timeout:timeSpan /regenerateExpiredSessionId:true|false

Die Variable cookieless:AutoDetect konfiguriert IIS 8 für die Verwendung des Cookiemodus „Automatisch erkennen“ für den Sitzungszustand. Die Variable string ist der Name des Cookies. Der Standardwert ist ASP.NET_SessionId. Die Variable timeSpan legt die Zeit in Minuten fest, nach der das Cookie abläuft. Der Standardwert beträgt 20 Minuten. Die Variable regenerateExpiredSessionId:true|false aktiviert oder deaktiviert die erneute Generierung von abgelaufenen Sitzungs-IDs.

Hinweis

Wenn Sie „Appcmd.exe“ verwenden, um das <sessionState>-Element auf globaler Ebene in IIS 8 zu konfigurieren, geben Sie /commit:WEBROOT im Befehl an, damit Konfigurationsänderungen an der Datei „Web.config“ im Stamm und nicht an der Datei „ApplicationHost.config“ vorgenommen werden.

Verwenden Sie die folgende Syntax, um den Modus „URI“ für den Sitzungszustand zu konfigurieren:

appcmd set config /commit:WEBROOT /section:sessionState /cookieless:UseUri /regenerateExpiredSessionId:true|false

Die Variable cookieless:UseUri konfiguriert IIS 8 für die Verwendung des Cookiemodus „URI“ für den Sitzungszustand. Die Variable regenerateExpiredSessionId:true|false aktiviert oder deaktiviert die erneute Generierung von abgelaufenen Sitzungs-IDs.

Hinweis

Wenn Sie „Appcmd.exe“ verwenden, um das <sessionState>-Element auf globaler Ebene in IIS 8 zu konfigurieren, geben Sie /commit:WEBROOT im Befehl an, damit Konfigurationsänderungen an der Datei „Web.config“ im Stamm und nicht an der Datei „ApplicationHost.config“ vorgenommen werden.

2.2. Seiten- und Steuerelementeinstellungen

In diesem Abschnitt wird beschrieben, wie die ASP.NET-Seiten- und Steuerelementeinstellungen über die Benutzeroberfläche des IIS-Managers oder über die Befehlszeile konfiguriert werden.

Hinweis

Diese Einstellungen gelten nur für ASP.NET Web Forms. Sie gelten nicht für ASP.NET MVC oder ASP.NET Web Pages.

Bearbeiten von Seiten und Steuerelementen

Sie können die Einstellungen der vorhandenen Seiten und Steuerelemente bearbeiten, und die Änderungen werden in der Datei „Web.config“ angezeigt.

So bearbeiten Sie die Einstellungen für Seiten und Steuerelemente über die Benutzeroberfläche

  1. Navigieren Sie in IIS-Manager zu der Ebene, die Sie verwalten möchten.
  2. Doppelklicken Sie in der Featureansicht auf Seiten und Steuerelemente.
  3. Bearbeiten Sie auf der Seite Seiten und Steuerelemente die erforderlichen Einstellungen.
  4. Klicken Sie abschließend im Bereich Aktionen auf Übernehmen .

So bearbeiten Sie die Einstellungen für Seiten und Steuerelemente über die Befehlszeile

Verwenden Sie die folgende Syntax, um die Seitenausgabepufferung zu aktivieren oder zu deaktivieren:

appcmd set config /commit:WEBROOT /section:pages /buffer:true|false

Die Variable buffer:true aktiviert die Pufferung der Seitenausgabe. Der Standardwert ist true.

Hinzufügen eines benutzerdefinierten Steuerelements

Unter Planen einer ASP.NET-Website auf IIS haben Sie die folgenden Designentscheidungen für jedes benutzerdefinierte Steuerelement, das Sie hinzufügen möchten, getroffen:

  • Geben Sie das Tagpräfix des Steuerelements an.
  • Geben Sie den .NET-Namespace des Steuerelements an.
  • Geben Sie die Assembly an, in der sich das Steuerelement befindet.

So fügen Sie ein benutzerdefiniertes Steuerelement über die Benutzeroberfläche hinzu

  1. Navigieren Sie in IIS-Manager zu der Ebene, die Sie verwalten möchten.
  2. Doppelklicken Sie in der Featureansicht auf Seiten und Steuerelemente.
  3. Klicken Sie im Bereich Aktionen auf Steuerelemente registrieren.
  4. Klicken Sie im Bereich Aktionen auf Benutzerdefiniertes Steuerelement hinzufügen.
  5. Geben Sie im Dialogfeld Benutzerdefiniertes Steuerelement hinzufügen ein Tagpräfix in das Textfeld Tagpräfix ein.
  6. Geben Sie im Textfeld Namespace den Namespace ein, zu dem das benutzerdefinierte Steuerelement gehört. Dies ist derselbe Namespace, der im Anwendungscode angegeben wurde.
  7. Geben Sie im Textfeld Assembly den Namen der Assemblyquelle für das benutzerdefinierte Steuerelement ein, und klicken Sie dann auf OK.

So fügen Sie ein benutzerdefiniertes Steuerelement über die Befehlszeile hinzu

Verwenden Sie die folgende Syntax, um ein benutzerdefiniertes Steuerelement hinzuzufügen:

appcmd set config /commit:WEBROOT /section:system.web/pages /+"controls.[assembly='string', namespace='string', src='string', tagName='string', tagPrefix='string']"

Die Variable assembly='string' gibt den Namen der Assembly an, die die COM-Steuerelementimplementierung enthält. Für diese ist es erforderlich, dass das namespace-Attribut ebenfalls festgelegt wird. Die Variable namespace='string' gibt den Namespace an, der dem Tagpräfix zugeordnet ist. Für diesen ist es erforderlich, dass das assembly-Attribut ebenfalls festgelegt wird, wenn sich das COM-Steuerelement nicht im Anwendungscodeverzeichnis befindet. Die Variable src='string' gibt den Namen der Datei an, die das Benutzersteuerelement enthält. Für diese ist es erforderlich, dass das tagName-Attribut ebenfalls festgelegt wird. Die Variable tagName='string' ist der Name des Steuerelements, der auf der Seite verwendet werden soll. Für diesen ist es erforderlich, dass das src-Attribut ebenfalls festgelegt wird. Die Variable tagPrefix='string' gibt das Tagpräfix an, das einer Quelldatei oder einem Namespace und einer Assembly zugeordnet wird. Dieses Attribut erfordert eine der folgenden Kombinationen anderer Attribute:

  • namespace, um ein COM-Steuerelement zu definieren, wenn sich das Steuerelement im Anwendungscodeverzeichnis befindet.
  • namespace und assembly zum Definieren eines COM-Steuerelements.
  • tagName und src zum Definieren eines Benutzersteuerelements.

Geben Sie z. B. Folgendes an der Eingabeaufforderung ein, und drücken Sie dann die EINGABETASTE, um ein benutzerdefiniertes Steuerelement hinzuzufügen, das die angegebene Quelle für ein Benutzersteuerelement verwendet:

appcmd set config /commit:WEBROOT /section:system.web/pages /+"controls.[tagPrefix='MyTag', tagName='MyControl', src='controls/MyControl.asx']"

Hinweis

Wenn Sie „Appcmd.exe“ verwenden, um das <controls>-Element auf globaler Ebene in IIS 8 zu konfigurieren, geben Sie /commit:WEBROOT im Befehl an, damit Konfigurationsänderungen an der Datei „Web.config“ im Stamm und nicht an der Datei „ApplicationHost.config“ vorgenommen werden.

2.3. Anwendungseinstellungen

In diesem Abschnitt wird beschrieben, wie die Anwendungseinstellungen über die Benutzeroberfläche des IIS-Managers oder über die Befehlszeile konfiguriert werden.

Unter Planen einer ASP.NET-Website auf IIS haben Sie die folgenden Designentscheidungen für die einzelnen Anwendungseinstellungen getroffen, die Sie konfigurieren möchten:

  1. Geben Sie einen Namen für die Einstellung an.
  2. Geben Sie einen Wert für die Einstellung an.

So erstellen Sie eine Anwendungseinstellung über die Benutzeroberfläche

  1. Navigieren Sie in IIS-Manager zu der Ebene, die Sie verwalten möchten.
  2. Doppelklicken Sie in der Featureansicht auf Anwendungseinstellungen.
  3. Klicken Sie im Bereich Aktionen auf Hinzufügen.
  4. Geben Sie im Dialogfeld Anwendungseinstellung hinzufügen einen Namen für die Anwendungseinstellung in das Textfeld Name ein.
  5. Geben Sie im Dialogfeld Anwendungseinstellung hinzufügen einen Wert für die Anwendungseinstellung in das Textfeld Wert ein, und klicken Sie dann auf OK.

So erstellen Sie eine Anwendungseinstellung über die Befehlszeile

Verwenden Sie die folgende Syntax, um eine Anwendungseinstellung hinzuzufügen:

appcmd set config /commit:MACHINE /section:appSettings /+"[key='string', value='string']"

Die Variable key=string gibt den Namen der Anwendungseinstellung an, während die Variable value=string den Wert für die Anwendungseinstellung darstellt. Geben Sie z. B. Folgendes an der Eingabeaufforderung ein, und drücken Sie dann die Eingabetaste, um eine Anwendungseinstellung für den Namen Ihrer Anwendung hinzuzufügen:

appcmd set config /commit:MACHINE /section:appSettings /+"[key='Application Name', value='MyApplication']"

2.4. .NET-Kompilierungseinstellungen

Bearbeiten Sie die .NET-Kompilierungseinstellungen in IIS 8, wenn Sie steuern möchten, wie ASP.NET-Code kompiliert wird. In diesem Abschnitt wird beschrieben, wie die Einstellungen zum Kompilieren der ASP.NET-Anwendung bearbeitet werden.

So konfigurieren Sie die Einstellungen für die .NET-Kompilierung über die Benutzeroberfläche

  1. Navigieren Sie in IIS-Manager zu der Ebene, die Sie verwalten möchten.
  2. Doppelklicken Sie in der Featureansicht auf .NET-Kompilierung.
  3. Bearbeiten Sie auf der Seite .NET-Kompilierung die erforderlichen Einstellungen.
  4. Klicken Sie abschließend im Bereich Aktionen auf Übernehmen .

So konfigurieren Sie die Einstellungen für die .NET-Kompilierung über die Befehlszeile

Verwenden Sie die folgende Syntax, um die Batchkompilierung für eine Website zu aktivieren oder zu deaktivieren:

appcmd set config /commit:WEBROOT /section:compilation /batch:true|false

Die Variable batch:true aktiviert die Batchkompilierung, während die Variable batch:false die Batchkompilierung deaktiviert. Der Standardwert ist true.

Verwenden Sie die folgende Syntax, um die maximale Dateigröße (in KB) für die Batchkompilierung zu ändern:

appcmd set config /commit:WEBROOT /section:compilation /maxBatchGeneratedFileSize:int

Die Variable int gibt die maximale Dateigröße (in KB) an. Der Standardwert lautet „1000“.

Verwenden Sie die folgende Syntax, um die maximale Anzahl von Seiten pro Batchkompilierung für eine Website anzugeben:

appcmd set config /commit:WEBROOT /section:compilation /maxBatchSize:int

Die Variable int gibt die maximale Anzahl von Seiten pro Batchkompilierung an.

Verwenden Sie die folgende Syntax, um den Timeout (in Sekunden) für die Batchkompilierung für eine Website zu definieren:

appcmd set config /commit:WEBROOT /section:compilation /batchTimeout:timeSpan

Die Variable timeSpan ist das Timeout in Sekunden für die Batchkompilierung.

Verwenden Sie die folgende Syntax, um die Kompilierung von Binärdateien für die Produktionsumgebung oder zum Debuggen für eine Website anzugeben:

appcmd set config /commit:WEBROOT /section:compilation /debug:true|false

Die Variable debug:true aktiviert die Kompilierung von Binärdateien zum Debuggen, währen die Variable debug:false die Kompilierung von Binärdateien für die Produktionsumgebung aktiviert. Der Standardwert ist false.

Verwenden Sie die folgende Syntax, um die Häufigkeit anzugeben, mit der Ressourcen dynamisch neu kompiliert werden können, bevor eine Anwendung für eine Website neu gestartet wird:

appcmd set config /commit:WEBROOT /section:compilation /numRecompilesBeforeAppRestart:int

Die Variable int gibt die Häufigkeit an, mit der Ressourcen dynamisch neu kompiliert werden können, bevor eine Anwendung neu gestartet wird. Der Standardwert beträgt 15.

Verwenden Sie die folgende Syntax, um das URL-Zeilenpragma für eine Website zu aktivieren oder zu deaktivieren:

appcmd set config /commit:WEBROOT /section:compilation /urlLinePragmas:true|false

Die Variable urlLinePragmas:true aktiviert das URL-Zeilenpragma, während die Variable urlLinePragmas:false das URL-Zeilenpragma deaktiviert. Der Standardwert ist false.

Verwenden Sie die folgende Syntax, um die explizite Visual Basic-Kompilierung für eine Website zu aktivieren oder zu deaktivieren:

appcmd set config /commit:WEBROOT /section:compilation /explicit:true|false

Die Variable explicit:true aktiviert die explizite Visual Basic-Kompilierung, während die Variable explicit:false die explizite Visual Basic-Kompilierung deaktiviert. Der Standardwert ist false.

Verwenden Sie die folgende Syntax, um die strikte Visual Basic-Kompilierung für eine Website zu aktivieren oder zu deaktivieren:

appcmd set config /commit:WEBROOT /section:compilation /strict:true|false

Die Variable strict:true aktiviert die strikte Visual Basic-Kompilierung, während die Variable strict:false die strikte Visual Basic-Kompilierung deaktiviert. Der Standardwert ist false.

Verwenden Sie die folgende Syntax, um eine Verarbeitungsdirektive für die ASP.NET-Kompilierung für eine Website hinzuzufügen:

appcmd set config /commit:WEBROOT /section:compilation /+"assemblies.[assembly='string']"

Die Variable string gibt die Verarbeitungsdirektive der ASP.NET-Kompilierung an.

Verwenden Sie die folgende Syntax, um eine Verarbeitungsdirektive für die ASP.NET-Kompilierung für eine Website zu entfernen:

appcmd set config /commit:WEBROOT /section:compilation /-"assemblies.[assembly='string']"

Die Variable string gibt die Verarbeitungsdirektive der ASP.NET-Kompilierung an.

Verwenden Sie die folgende Syntax, um eine Verarbeitungsdirektive für die ASP.NET-Kompilierung für eine Website zu entfernen:

appcmd set config /commit:WEBROOT /section:compilation /-"assemblies.[assembly='string']"

Die Variable string gibt die Verarbeitungsdirektive der ASP.NET-Kompilierung an.

Verwenden Sie die folgende Syntax, um die Standardprogrammiersprache zu wechseln, die in dynamischen Kompilierungsdateien für eine Website verwendet wird:

appcmd set config /commit:WEBROOT /section:compilation /defaultLanguage:string

Die Variable string gibt die Standardprogrammiersprache an. Der Standardwert ist „vb“. Geben Sie z. B. Folgendes an der Eingabeaufforderung ein, und drücken Sie dann die Eingabetaste, um die Standardprogrammiersprache, die für dynamische Kompilierungsdateien verwendet wird, von Visual Basic in C# zu ändern:

appcmd set config /commit:WEBROOT /section:compilation /defaultLanguage:c#

Verwenden Sie die folgende Syntax, um das Verzeichnis anzugeben, das während der Kompilierung für eine Website zum Speichern temporärer Dateien verwendet wird:

appcmd set config /commit:WEBROOT /section:compilation /tempDirectory:string

Die Variable string ist der Verzeichnispfad.

Hinweis

Wenn Sie „Appcmd.exe“ verwenden, um das <compilation>-Element auf globaler Ebene in IIS 8 zu konfigurieren, geben Sie /commit:WEBROOT im Befehl an, damit Konfigurationsänderungen an der Datei „Web.config“ im Stamm und nicht an der Datei „ApplicationHost.config“ vorgenommen werden.

2.5. .NET-Globalisierungseinstellungen

In diesem Abschnitt wird beschrieben, wie die Globalisierungseinstellungen für Ihre ASP.NET-Anwendung über die Benutzeroberfläche des IIS-Managers oder über die Befehlszeile bearbeitet werden.

So bearbeiten Sie .NET-Globalisierungseinstellungen über die Benutzeroberfläche

  1. Navigieren Sie in IIS-Manager zu der Ebene, die Sie verwalten möchten.
  2. Doppelklicken Sie in der Featureansicht auf .NET-Globalisierung.
  3. Klicken Sie auf der Seite .NET-Globalisierung auf dem Eigenschaftenblatt auf die globalen Einstellungen, die Sie bearbeiten möchten, und wählen Sie dann einen Wert aus der Dropdownliste aus.
  4. Klicken Sie im Bereich Aktionen auf Übernehmen.

So bearbeiten Sie .NET-Globalisierungseinstellungen über die Befehlszeile

Verwenden Sie die folgende Syntax, um die Standardkultur zur Verarbeitung von Webanforderungen zu bearbeiten:

appcmd set config /commit:WEBROOT /section:globalization /culture:string

Die Variable string gibt die Standardkultur für die Verarbeitung von Webanforderungen an. Geben Sie z. B. Folgendes an der Eingabeaufforderung ein, und drücken Sie dann die Eingabetaste, um die Standardkultur für die Verarbeitung von Webanforderungen in „Englisch (USA)“ zu ändern:

appcmd set config /commit:WEBROOT /section:globalization /culture:en-us

Hinweis

Wenn Sie „Appcmd.exe“ verwenden, um das <globalization>-Element auf globaler Ebene in IIS 8 zu konfigurieren, geben Sie /commit:WEBROOT im Befehl an, damit Konfigurationsänderungen an der Datei „Web.config“ im Stamm und nicht an der Datei „ApplicationHost.config“ vorgenommen werden.

Verwenden Sie die folgende Syntax, um die clientbasierte Kultur zu aktivieren oder zu deaktivieren:

appcmd set config /commit:WEBROOT /section:globalization /enableClientBasedCulture:true|false

Die Variable enableClientBasedCulture:true aktiviert die clientbasierte Kultur, während die Variable enableClientBasedCulture:false die clientbasierte Kultur deaktiviert. Der Standardwert ist false.

Verwenden Sie die folgende Syntax, um die Standardkultur zur Verarbeitung von gebietsschemaabhängigen Ressourcensuchvorgängen zu bearbeiten:

appcmd set config /commit:WEBROOT /section:globalization /uiCulture:string

Die Variable string gibt die Standardkultur für die Verarbeitung von gebietsschemaabhängigen Ressourcensuchvorgänge an.

Verwenden Sie die folgende Syntax, um die Standardkultur zur Verarbeitung von gebietsschemaabhängigen Ressourcensuchvorgängen zu bearbeiten:

appcmd set config /commit:WEBROOT /section:globalization /uiCulture:string

Die Variable string gibt die Standardkultur für die Verarbeitung von gebietsschemaabhängigen Ressourcensuchvorgänge an.

Verwenden Sie die folgenden Syntax, um die Standardcodierung zum Analysieren von ASPX-, ASMX- und ASAX-Dateien zu ändern:

appcmd set config /commit:WEBROOT /section:globalization /fileEncoding:string

Die Variable string ist die Standardcodierung, die beim Analysieren von ASPX-, ASMX- und ASAX-Dateien verwendet wird.

Verwenden Sie die folgende Syntax, um die Headercodierung für Antworten zu ändern:

appcmd set config /commit:WEBROOT /section:globalization /responseHeaderEncoding:string

Die Variable string gibt die für Antworten verwendete Headercodierung an. Der Standardwert ist utf-8.

Verwenden Sie die folgende Syntax, um die Inhaltscodierung für Antworten zu bearbeiten:

appcmd set config /commit:WEBROOT /section:globalization /responseEncoding:string

Die Variable string gibt die für Antworten verwendete Inhaltscodierung an. Der Standardwert ist utf-8.