Condividi tramite

Procedura dettagliata: Creazione di un file di configurazione per Web Core ospitato

Questa procedura dettagliata illustra come creare un file di configurazione da usare con le funzionalità Di base Web ospitate disponibili in IIS 7.

Quando si creano applicazioni che usano la funzionalità Hosted Web Core in IIS 7, è necessario fornire un file di configurazione personalizzato che segue il formato del file ApplicationHost.config. A seconda delle impostazioni di configurazione, l'applicazione può ospitare pagine Web e applicazioni nello stesso server in cui si ospitano siti Web che usano IIS 7. Ad esempio, se il server Web dispone di un solo sito Web che gestisce pagine Web sulla porta TCP 80, è possibile configurare l'applicazione per la gestione di pagine Web sulla porta TCP 8080.

Poiché l'applicazione richiede un file di configurazione personalizzato, i siti Web e l'applicazione Web Core ospitata non condividono le stesse impostazioni di funzionalità. È ad esempio possibile configurare i siti Web per implementare funzionalità dinamiche non richieste dall'applicazione oppure configurare l'applicazione in modo da richiedere un metodo di autenticazione specifico che non viene usato dai siti Web.

Anche se il file ApplicationHost.config per IIS 7 può contenere più pool di applicazioni, la funzionalità Hosted Web Core in IIS 7 supporta solo un singolo pool di applicazioni.

Prerequisiti

Per completare i passaggi dell'esempio, è necessario il software seguente:

  • IIS 7 in Windows Vista.

Nota

Anche se è necessario eseguire l'applicazione Web Core ospitata in Windows Vista, non è necessario creare il file di configurazione in Windows Vista. È possibile creare il file di configurazione in una versione diversa di Windows e quindi copiare il file di configurazione in un computer in cui è installato Windows Vista.

  • Visual Studio 2005

Nota

È anche possibile usare Visual Studio .NET 2003 o versioni precedenti, anche se la procedura dettagliata potrebbe non essere identica.

Creazione di un file di configurazione

I passaggi descritti in questa parte della procedura dettagliata consentono di creare un nuovo file di configurazione da usare con un'applicazione Web Core ospitata che contiene le impostazioni necessarie per la gestione del contenuto statico.

Per creare un file di configurazione

  1. Avviare Visual Studio 2005.

  2. Creare un nuovo file di configurazione:

    1. Scegliere Nuovo dal menu File, quindi fare clic su File.

      Verrà visualizzata la finestra di dialogo Nuovo file .

    2. Nel riquadro Categorie fare clic su Generale.

    3. Nel riquadro Modelli selezionare File XML.

    4. Fare clic su Apri.

      Verrà aperto un nuovo file XML con il codice XML seguente:

      <?xml version="1.0" encoding="UTF-8"?>

  3. Per identificare questo file XML come file di configurazione per l'applicazione, aggiungere il codice XML seguente sotto l'elemento <?xml?> :

    <configuration>  

</configuration>

Definizione di sezioni di configurazione

Dopo aver creato il file di configurazione, è necessario definire le sezioni di configurazione che il file di configurazione conterrà. A tale scopo, aggiungere un <configSections> elemento al file di configurazione.

Per aggiungere la <sezione configSections>

  1. Per creare la sezione che definisce le sezioni che il file di configurazione conterrà, aggiungere il codice XML seguente all'interno dell'elemento <configuration> :

    <configSections>  

</configSections>

  2. Per definire le informazioni che verranno incluse nella <system.applicationHost> sezione, aggiungere il codice XML seguente all'interno dell'elemento <configSections> :

    <sectionGroup name="system.applicationHost"  
        type="System.ApplicationHost.Configuration.SystemApplicationHostSectionGroup">  
    <section name="applicationPools"  
            type="System.ApplicationHost.Configuration.ApplicationPoolsSection"  
            allowDefinition="MachineOnly"  
            overrideModeDefault="Deny" />  
    <section name="listenerAdapters"  
            type="System.ApplicationHost.Configuration.ListenerAdaptersSection"  
            allowDefinition="MachineOnly"  
            overrideModeDefault="Deny" />  
    <section name="log"  
            type="System.ApplicationHost.Configuration.LogSection"  
            allowDefinition="MachineOnly"  
            overrideModeDefault="Deny" />  
    <section name="sites"  
            type="System.ApplicationHost.Configuration.SitesSection"  
            allowDefinition="MachineOnly"  
            overrideModeDefault="Deny" />  
</sectionGroup>

  3. Per definire le informazioni che verranno incluse nella <system.applicationHost> sezione, aggiungere il codice seguente all'interno dell'elemento <configSections> :

    <sectionGroup name="system.webServer"  
    type="System.WebServer.Configuration.SystemWebServerSectionGroup">  
    <section name="defaultDocument"  
        type="System.WebServer.Configuration.DefaultDocumentSection"  
        overrideModeDefault="Allow" />  
    <section name="directoryBrowse"  
        type="System.WebServer.Configuration.DirectoryBrowseSection"  
        overrideModeDefault="Allow" />  
    <section name="globalModules"  
        type="System.WebServer.Configuration.GlobalModulesSection"  
        allowDefinition="MachineOnly"  
        overrideModeDefault="Deny" />  
    <section name="handlers"  
        type="System.WebServer.Configuration.HandlersSection"  
        overrideModeDefault="Deny" />  
    <section name="httpLogging"  
        type="System.WebServer.Configuration.HttpLoggingSection"  
        overrideModeDefault="Deny" />  
    <section name="modules"  
        type="System.WebServer.Configuration.ModulesSection"  
        allowDefinition="MachineToApplication"  
        overrideModeDefault="Deny" />  
    <sectionGroup name="security"  
        type="System.WebServer.Configuration.SecuritySectionGroup">  
        <section name="access"  
            type="System.WebServer.Configuration.AccessSection"  
            overrideModeDefault="Deny" />  
        <sectionGroup name="authentication"  
            type="System.WebServer.Configuration.AuthenticationSectionGroup">  
            <section name="anonymousAuthentication"  
                type="System.WebServer.Configuration.AnonymousAuthenticationSection"  
                overrideModeDefault="Allow" />  
        </sectionGroup>  
    </sectionGroup>  
    <section name="staticContent"  
        type="System.WebServer.Configuration.StaticContentSection"  
        overrideModeDefault="Deny" />  
</sectionGroup>

Aggiunta delle <impostazioni system.applicationHost>

Dopo aver definito le sezioni che il file di configurazione conterrà, è necessario popolare le sezioni di configurazione con le impostazioni necessarie per l'applicazione.

Per aggiungere la <sezione system.applicationHost>

  1. Per aggiungere la <system.applicationHost> sezione al file di configurazione, aggiungere il codice XML seguente all'interno dell'elemento <configuration> :

    <system.applicationHost>  

</system.applicationHost>

  2. Per creare un pool di applicazioni, aggiungere il codice XML seguente all'interno dell'elemento <system.applicationHost> :

    <applicationPools>  
    <add name="TestAppPool" />  
    <applicationPoolDefaults>  
        <processModel identityType="NetworkService" />  
    </applicationPoolDefaults>  
</applicationPools>

  3. Per definire un adattatore listener per HTTP, aggiungere il codice XML seguente all'interno dell'elemento <system.applicationHost> :

    <listenerAdapters>  
    <add name="http" />  
</listenerAdapters>

  4. Per creare un sito Web, aggiungere il codice XML seguente all'interno dell'elemento <system.applicationHost> :

    <sites>  
    <site name="Test Web Site" id="1">  
        <application path="/">  
            <virtualDirectory path="/"  
                physicalPath="D:\inetpub\TestPath\wwwroot" />  
        </application>  
        <bindings>  
            <binding protocol="HTTP" bindingInformation="*:8080:" />  
        </bindings>  
    </site>  
    <siteDefaults>  
        <logFile directory="D:\inetpub\TestPath\Logs" />  
    </siteDefaults>  
    <applicationDefaults applicationPool="TestAppPool" />  
    <virtualDirectoryDefaults allowSubDirConfig="true" />  
</sites>

Nota

È possibile modificare i percorsi di file e le associazioni server nelle impostazioni XML in base alle esigenze dell'applicazione.

Aggiunta delle <impostazioni system.webServer>

Per aggiungere la <sezione system.webServer>

  1. Per aggiungere la <system.webServer> sezione al file di configurazione, aggiungere il codice XML seguente all'interno dell'elemento <configuration> :

    <system.webServer>  

</system.webServer>

  2. Per definire i moduli globali che verranno usati dall'applicazione, aggiungere il codice XML seguente all'interno dell'elemento <system.webServer> :

    <globalModules>  
    <add name="DefaultDocumentModule"  
        image="D:\Windows\system32\inetsrv\defdoc.dll" />  
    <add name="DirectoryListingModule"  
        image="D:\Windows\system32\inetsrv\dirlist.dll" />  
    <add name="StaticFileModule"  
        image="D:\Windows\system32\inetsrv\static.dll" />  
    <add name="AnonymousAuthenticationModule"  
        image="D:\Windows\system32\inetsrv\authanon.dll" />  
    <add name="HttpLoggingModule"  
        image="D:\Windows\system32\inetsrv\loghttp.dll" />  
</globalModules>

  3. Per definire i gestori che verranno usati dall'applicazione, aggiungere il codice XML seguente all'interno dell'elemento <system.webServer> :

    <handlers>  
    <add name="StaticFile" path="*" verb="*"  
        modules="StaticFileModule,DefaultDocumentModule,DirectoryListingModule"  
        resourceType="Either" requireAccess="Read" />  
</handlers>

  4. Per definire i moduli che verranno usati dall'applicazione, aggiungere il codice XML seguente all'interno dell'elemento <system.webServer> :

    <modules>  
    <add name="DefaultDocumentModule" />  
    <add name="DirectoryListingModule" />  
    <add name="StaticFileModule" />  
    <add name="AnonymousAuthenticationModule" />  
    <add name="HttpLoggingModule" />  
</modules>

  5. Per definire le opzioni di esplorazione della directory e registrazione HTTP, aggiungere il codice XML seguente all'interno dell'elemento <system.webServer> :

    <directoryBrowse enabled="true" />  
<httpLogging dontLog="false" />

  6. Per abilitare un documento predefinito, aggiungere il codice XML seguente all'interno dell'elemento <system.webServer> :

    <defaultDocument enabled="true">  
    <files>  
        <add value="default.htm" />  
    </files>  
</defaultDocument>

  7. Per definire i tipi MIME che verranno implementati dall'applicazione, aggiungere il codice XML seguente all'interno dell'elemento <system.webServer> :

    <staticContent>  
    <mimeMap fileExtension=".gif" mimeType="image/gif" />  
    <mimeMap fileExtension=".htm" mimeType="text/html" />  
    <mimeMap fileExtension=".jpg" mimeType="image/jpeg" />  
    <mimeMap fileExtension=".txt" mimeType="text/plain" />  
</staticContent>

    Nota

    È possibile aggiungere tipi MIME in base alle esigenze dell'applicazione aggiungendo altri <mimeMap> elementi.

  8. Per definire le opzioni di sicurezza dell'applicazione, aggiungere il codice XML seguente all'interno dell'elemento <system.webServer> :

    <security>  
    <access flags="Read" sslFlags="None" />  
    <authentication>  
        <anonymousAuthentication enabled="true"  
            userName="IUSR" defaultLogonDomain="" />  
    </authentication>  
</security>

    Dopo aver completato tutti i passaggi precedenti, è necessario salvare il file di configurazione in un percorso in cui l'applicazione Web Core ospitata sarà in grado di accedervi.

    L'applicazione potrebbe riscontrare un errore se una sezione del file di configurazione non è stata definita correttamente. A seconda dell'errore, è possibile recuperare informazioni aggiuntive sul problema esaminando i log di Visualizzatore eventi del server e i file di log IIS creati automaticamente dall'applicazione. Per altre informazioni sulla risoluzione dei problemi relativi a un'applicazione Web Core ospitata, vedere i passaggi per la risoluzione dei problemi elencati in Procedura dettagliata: Creazione di un'applicazione Web Core ospitata.

Vedere anche

Creazione di applicazioni Web Core ospitate
Procedura dettagliata: Creazione di un'applicazione Web Core ospitata

  • Last updated on