ASP COM Plus <comPlus>
L'elemento <comPlus> dell'elemento <asp> configura le impostazioni COM+ seguenti per Active Server Pages (ASP) in Internet Information Services (IIS) 7:
La proprietà appServiceFlags contiene i flag che devono essere impostati per abilitare i servizi COM+ nelle applicazioni IIS 7. Dopo aver abilitato i flag, potrebbe essere necessario impostare anche altre proprietà. Per altre informazioni, vedere la sezione Configurazione più avanti in questo articolo.
L'attributo executeInMta specifica se ASP può eseguire script in un appartamento multithreaded. ASP è in grado di eseguire tutti i thread in un appartamento multi thread (MTA). Se i componenti COM sono principalmente senza thread o entrambi thread, l'esecuzione dei thread ASP come MTA può migliorare significativamente le prestazioni. Per impostazione predefinita, la proprietà executeInMta è impostata su false, il che significa che ASP non viene eseguito in MTA. Impostare questa proprietà su true a livello di applicazione per abilitare l'esecuzione di ASP in MTA.
L'attributo partitionId specifica il GUID (Global Unique Identifier) di una partizione COM+ che viene usata per isolare le applicazioni Web nelle proprie partizioni COM+. Le partizioni COM+ contengono versioni diverse dei propri componenti COM personalizzati.
Nota
Se si specifica un valore per l'attributo partitionId , sarà anche necessario impostare il flag UsePartition dell'attributo appServiceFlags .
L'attributo sxsName specifica il nome di un'applicazione COM+ e abilita gli assembly side-by-side (SxS). Gli assembly side-by-side (SxS) consentono alle applicazioni ASP di specificare la versione di una DLL di sistema supportata da SxS da usare, ad esempio MSVCRT, MSXML, COMCTL, GDIPLUS e così via.
Nota
Se si specifica un valore per l'attributo sxsName , sarà anche necessario impostare il flag EnableSxS dell'attributo appServiceFlags .
L'attributo trackThreadingModel specifica se IIS 7 controlla il modello di threading di tutti i componenti (oggetti COM) creati dall'applicazione. L'impostazione preferita di questo attributo metabase è false. Se trackThreadingModel è impostato su true, si applicano le condizioni seguenti:
ASP usa le risorse di sistema per tenere traccia del modello di threading, riducendo le prestazioni dell'applicazione ASP.
Gli oggetti creati nell'applicazione ASP all'esterno del metodo OnStartPage o OnEndPage vengono rilasciati in precedenza rispetto al previsto, che causano la riduzione della scalabilità dell'applicazione e possono impedire al componente di scrivere alla risposta nel metodo di distruttore dell'oggetto.
Se l'attributo trackThreadingModel è impostato su false e si assegna l'ambito dell'applicazione ai componenti creati, tali componenti devono aggregare il marshalling senza thread. Se non si aggrega il marshalling a thread libero, ASP genera un errore quando si tenta di creare un'istanza del componente. Per altre informazioni, vedere Selezione di un modello di threading per componenti in IIS.
Compatibilità
| Versione | Note |
|---|---|
| IIS 10.0 | L'elemento <comPlus> non è stato modificato in IIS 10.0. |
| IIS 8,5 | L'elemento <comPlus> non è stato modificato in IIS 8.5. |
| IIS 8,0 | L'elemento <comPlus> non è stato modificato in IIS 8.0. |
| IIS 7,5 | L'elemento <comPlus> non è stato modificato in IIS 7.5. |
| IIS 7.0 | L'elemento <comPlus> dell'elemento <asp> è stato introdotto in IIS 7.0. |
| IIS 6.0 | L'elemento <comPlus> sostituisce le proprietà metabase di IIS 6.0 seguenti:
|
Installazione
Per supportare e configurare applicazioni ASP nel server Web, è necessario installare il modulo ASP. Per installare il modulo ASP, seguire questa procedura.
Windows Server 2012 o Windows Server 2012 R2
Sulla barra delle applicazioni fare clic su Server Manager. - In Server Manager fare clic sul menu Gestisci e quindi su Aggiungi ruoli e funzionalità. - Nella procedura guidata Aggiungi ruoli e funzionalità fare clic su Avanti. Selezionare il tipo di installazione e fare clic su Avanti. Selezionare il server di destinazione e fare clic su Avanti. - Nella pagina Ruoli server espandere Server Web (IIS) espandere Server Web, espandere Server Web, espandere Sviluppo applicazioni e quindi selezionare ASP.
Se viene visualizzata la finestra di dialogo Aggiungi funzionalità richieste da ASP? fare clic su Aggiungi funzionalità. Questa pagina viene visualizzata solo se non è già stato installato il servizio ruolo estensioni ISAPI nel server. - Nella pagina Ruoli server fare clic su Avanti. - Nella pagina Seleziona funzionalità fare clic su Avanti. - Nella pagina Conferma selezioni di installazione fare clic su Installa. - Nella pagina Risultati fare clic su Chiudi.
Windows 8 o Windows 8.1
Nella schermata Start spostare il puntatore nell'angolo inferiore sinistro, fare clic con il pulsante destro del mouse sul pulsante Start e quindi fare clic su Pannello di controllo.
In Pannello di controllo fare clic su Programmi e funzionalità e quindi su Attiva o disattiva le funzionalità di Windows.
Espandere Internet Information Services, espandere Servizi Web a livello mondiale, espandere Funzionalità di sviluppo applicazioni e quindi selezionare ASP.
Nota
Il ruolo estensioni ISAPI verrà selezionato se non è già stato installato.
Fare clic su OK.
Fare clic su Close.
Windows Server 2008 o Windows Server 2008 R2
- Nella barra delle applicazioni fare clic su Start, scegliere Strumenti di amministrazione e quindi fare clic su Server Manager.
- Nel riquadro della gerarchia di Server Manager espandere Ruoli e quindi fare clic su Server Web (IIS).
- Nel riquadro Server Web (IIS) scorrere fino alla sezione Servizi ruolo e quindi fare clic su Aggiungi servizi ruolo.
- Nella pagina Seleziona servizi ruolo della Procedura guidata Aggiungi servizi ruolo selezionare ASP.
- Se viene visualizzata la finestra di dialogo Aggiungi servizi ruolo richiesti da ASP , fare clic su Aggiungi servizi ruolo obbligatori. Questa pagina viene visualizzata solo se non è già stato installato il servizio ruolo estensioni ISAPI nel server.
- Nella pagina Selezione servizi ruolo fare clic su Avanti.
- Nella pagina Conferma selezioni per l'installazione fare clic su Installa.
- Nella pagina Risultati fare clic su Chiudi.
Windows Vista o Windows 7
Nella barra delle applicazioni fare clic su Start e quindi fare clic su Pannello di controllo.
In Pannello di controllo fare clic su Programmi e funzionalità e quindi su Attiva o disattiva funzionalità di Windows.
Espandere Internet Information Services, quindi Servizi Web a livello mondiale, quindi Funzionalità di sviluppo di applicazioni.
Selezionare ASP e quindi fare clic su OK.
Procedure
Come configurare le impostazioni dello stato della sessione ASP per un sito o un'applicazione
Aprire Gestione Internet Information Services (IIS):
Se si usa Windows Server 2012 o Windows Server 2012 R2:
- Nella barra delle applicazioni fare clic su Server Manager, scegliere Strumenti e quindi fare clic su Gestione Internet Information Services (IIS).
Se si usa Windows 8 o Windows 8.1:
- Tenere premuto il tasto Windows, premere la lettera X e quindi fare clic su Pannello di controllo.
- Fare clic su Strumenti di amministrazione e quindi fare doppio clic su Gestione Internet Information Services (IIS).
Se si usa Windows Server 2008 o Windows Server 2008 R2:
- Sulla barra delle applicazioni fare clic su Start, scegliere Strumenti di amministrazione, quindi fare clic su Gestione Internet Information Services (IIS).
Se si usa Windows Vista o Windows 7:
- Sulla barra delle applicazioni fare clic su Start e quindi su Pannello di controllo.
- Fare doppio clic su Strumenti di amministrazione, quindi fare doppio clic su Gestione Internet Information Services (IIS).
Nel riquadro Connessioni espandere il nome del server, espandere Siti e quindi passare al sito Web o all'applicazione Web da configurare.
Nel riquadro Home del sito o dell'applicazione fare doppio clic su ASP.
Nel riquadro ASP espandere la sezione Com Plus Properties e configurare le impostazioni desiderate.
Fare clic su Applica nel riquadro Azioni .
Configurazione
Attributi
| Attributo | Descrizione | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
appServiceFlags |
Attributo flag facoltativo. Contiene i flag che devono essere impostati per abilitare i servizi COM+ nelle applicazioni IIS. L'attributo appServiceFlags può essere uno dei valori possibili seguenti. Il valore predefinito è None.
|
||||||||||
executeInMta |
Attributo booleano facoltativo. Specifica se ASP viene eseguito in un ambiente multithreading. Il valore predefinito è false. |
||||||||||
partitionId |
Attributo stringa facoltativo. Specifica l'identificatore univoco globale (GUID) della partizione COM+. Nota: Questo attributo è obbligatorio quando l'attributo appServiceFlags è impostato su UsePartition Il valore predefinito è 00000000-0000-0000-0000-000000000000. |
||||||||||
sxsName |
Attributo stringa facoltativo. Nota: Questo attributo è obbligatorio quando l'attributo appServiceFlags è impostato su EnableSxS. Specifica il nome dell'applicazione COM+. |
||||||||||
trackThreadingModel |
Attributo booleano facoltativo. Specifica se il controllo del modello di thread è abilitato. Un valore true indica che IIS rispetta il modello di threading dei componenti creati da un'applicazione. Il valore predefinito è false. |
Elementi figlio
Nessuno.
Esempio di configurazione
Nell'esempio di configurazione seguente viene illustrato come configurare IIS per abilitare il controllo del modello di thread e configurare ASP per l'esecuzione in un raggruppamento multithreading.
<configuration>
<system.webServer>
<asp>
<comPlus trackThreadingModel="true" executeInMta="true" />
</asp>
</system.webServer>
</configuration>
Codice di esempio
Gli esempi di codice seguenti illustrano come configurare IIS per abilitare il controllo del modello di thread e configurare ASP per l'esecuzione in un raggruppamento multithreading.
AppCmd.exe
appcmd.exe set config "Default Web Site" -section:system.webServer/asp /comPlus.trackThreadingModel:"True" /commit:apphost
appcmd.exe set config "Default Web Site" -section:system.webServer/asp /comPlus.executeInMta:"True" /commit:apphost
Nota
È necessario assicurarsi di impostare il parametro commit su apphost quando si usa AppCmd.exe per configurare queste impostazioni. In questo modo le impostazioni di configurazione vengono confermate nella sezione relativa al percorso appropriato nel file ApplicationHost.config.
C#
using System;
using System.Text;
using Microsoft.Web.Administration;
internal static class Sample
{
private static void Main()
{
using (ServerManager serverManager = new ServerManager())
{
Configuration config = serverManager.GetApplicationHostConfiguration();
ConfigurationSection aspSection = config.GetSection("system.webServer/asp", "Default Web Site");
ConfigurationElement comPlusElement = aspSection.GetChildElement("comPlus");
comPlusElement["trackThreadingModel"] = true;
comPlusElement["executeInMta"] = true;
serverManager.CommitChanges();
}
}
}
VB.NET
Imports System
Imports System.Text
Imports Microsoft.Web.Administration
Module Sample
Sub Main()
Dim serverManager As ServerManager = New ServerManager
Dim config As Configuration = serverManager.GetApplicationHostConfiguration
Dim aspSection As ConfigurationSection = config.GetSection("system.webServer/asp", "Default Web Site")
Dim comPlusElement As ConfigurationElement = aspSection.GetChildElement("comPlus")
comPlusElement("trackThreadingModel") = True
comPlusElement("executeInMta") = True
serverManager.CommitChanges()
End Sub
End Module
JavaScript
var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var aspSection = adminManager.GetAdminSection("system.webServer/asp", "MACHINE/WEBROOT/APPHOST/Default Web Site");
var comPlusElement = aspSection.ChildElements.Item("comPlus");
comPlusElement.Properties.Item("trackThreadingModel").Value = true;
comPlusElement.Properties.Item("executeInMta").Value = true;
adminManager.CommitChanges();
VBScript
Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set aspSection = adminManager.GetAdminSection("system.webServer/asp", "MACHINE/WEBROOT/APPHOST/Default Web Site")
Set comPlusElement = aspSection.ChildElements.Item("comPlus")
comPlusElement.Properties.Item("trackThreadingModel").Value = True
comPlusElement.Properties.Item("executeInMta").Value = True
adminManager.CommitChanges()