Informazioni sul file di personalizzazione

Ogni intestazione di sezione nel file di personalizzazione è costituita da parentesi quadre ([]) contenenti un tipo e un parametro. I quattro tipi di sezione sono indicati dalle stringhe letterali connect, sql, userlist o logs. Il parametro è la stringa letterale, l'impostazione predefinita, un identificatore specificato dall'utente o niente.

Importante

A partire da Windows 8 e Windows Server 2012, i componenti del server di RDS non sono più inclusi nel sistema operativo Windows. Per altri dettagli, vedere la Guida di riferimento per la compatibilità di Windows 8 e Windows Server 2012. I componenti del client di RDS verranno rimossi in una versione futura di Windows. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. Le applicazioni che usano RDS devono eseguire la migrazione a WCF Data Service.

Pertanto, ogni sezione è contrassegnata con una delle intestazioni di sezione seguenti:

  
[ connect default ] [ connect    
identifier   
] [ sql  default ] [ sql    
identifier   
] [ userlist    
identifier   
] [ logs ]  
  

Le intestazioni di sezione hanno le seguenti parti.

In parte	Descrizione
connect	Stringa letterale che modifica una stringa di connessione.
sql	Stringa letterale che modifica una stringa di comando.
userlist	Stringa letterale che modifica i diritti di accesso di un utente specifico.
logs	Stringa letterale che specifica un file di log che registra errori operativi.
default	Stringa letterale usata se non viene specificato o trovato alcun identificatore.
identificatore	Stringa che corrisponde a una stringa nella stringa connect o command. - Usare questa sezione se l'intestazione della sezione contiene connect e la stringa dell’identificatore viene trovata nella stringa di connessione. - Usare questa sezione se l'intestazione della sezione contiene sql e la stringa dell’identificatore viene trovata nella stringa di comando. - Usare questa sezione se l'intestazione della sezione contiene sql e la stringa dell’identificatore corrisponde a un identificatore di sezione connect.

DataFactory chiama il gestore, passando i parametri client. Il gestore cerca le stringhe intere nei parametri client che corrispondono agli identificatori nelle intestazioni di sezione appropriate. Se viene trovata una corrispondenza, il contenuto di tale sezione viene applicato al parametro client.

Una sezione specifica viene usata nelle circostanze seguenti:

• Una sezione connect viene usata se la parte valore della parola chiave della stringa di connessione client, "Data Source=valore", corrisponde a un identificatore di sezione connect.

• Una sezione sql viene usata se la stringa di comando client contiene una stringa corrispondente a un identificatore di sezione sql.

• Se non è presente alcun identificatore corrispondente, viene usata una sezione connect o sql con un parametro predefinito.

• Una sezione userlist viene usata se l'identificatore di sezione userlist corrisponde a un identificatore di sezione connect. Se esiste una corrispondenza, il contenuto della sezione userlist viene applicato alla connessione regolata dalla sezione connect.

• Se la stringa in una stringa di connessione o di comando non corrisponde all'identificatore in un'intestazione di sezione connect o sql e non è presente alcuna intestazione di sezione connect o sql con un parametro predefinito, la stringa client viene usata senza modifiche.

• La sezione logs viene usata ogni volta che DataFactory è in funzionamento.

Vedi anche

Sezione sulla connessione del file di personalizzazione
Sezione Logs del file di personalizzazione
Sezione SQL del file di personalizzazione
Sezione UserList del file di personalizzazione
Personalizzazione di DataFactory
Impostazioni obbligatorie dei client
Scrittura di un gestore personalizzato