Elemento <wellknown> (istanza del client)

Questo argomento è specifico di una tecnologia legacy mantenuta per una questione di compatibilità con le applicazioni esistenti di versioni precedenti e non è consigliato per il nuovo sviluppo. Le applicazioni distribuite devono ora essere sviluppate utilizzando  Windows Communication Foundation (WCF).

Contiene informazioni relative a oggetti (noti) attivati da server, che vengono richiesti dall'applicazione. Quando un client utilizza un elemento <wellknown>, per l'elemento padre <client> non è necessario un attributo url. Questo elemento può essere presente in un file di configurazione del computer e in un file di configurazione dell'applicazione.

Schema Hierarchy

<configuration>
  Elemento <system.runtime.remoting>
    Elemento <application>
      Elemento <client>
        Elemento <wellknown> (istanza del client)

Sintassi

<wellknown  
   url="url" 
   displayName="displayName" 
   type="type,assembly"
/>

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo	Descrizione
type	Attributo obbligatorio. Specifica il nome completo del tipo dell'oggetto e il nome dell'assembly contenente l'implementazione del tipo sul client. Se l'assembly che contiene il tipo si trova nella Global Assembly Cache, vengono specificate anche le informazioni relative alla versione, alle impostazioni cultura e alla chiave pubblica.
url	Attributo obbligatorio. Specifica l'URL completo del tipo attivato da server, compreso l'URI (Uniform Resource Identifier) dell'oggetto.
displayName	Attributo facoltativo. Viene utilizzato dallo strumento .NET Framework Configuration per creare l'elenco degli oggetti attivati da server che devono essere chiamati dal client. Nel sistema di gestione remota .NET Framework questo attributo non viene utilizzato.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Descrizione
application	Contiene informazioni relative a oggetti remoti utilizzati ed esposti dall'applicazione.
client	Contiene gli oggetti utilizzati dall'applicazione. Poiché l'attributo url è obbligatorio per i tipi attivati da client, ma non per quelli attivati da server, ciascun URL univoco sarà costituito da un elemento client contenente i tipi attivati da client pubblicati nel percorso specificato.
configuration	È l'elemento radice in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
system.runtime.remoting	Contiene informazioni relative a oggetti e canali remoti.

Esempio

Nel file di configurazione seguente viene dichiarato un tipo remoto (noto) attivato da server per l'utilizzo e viene specificato che l'applicazione client deve utilizzare il canale HttpChannel, ma anche consentire al sistema di gestione remota .NET Framework di trovare una porta appropriata per conto del client.

<configuration>
   <system.runtime.remoting>
      <application>
         <client>
            <wellknown 
               type="RemoteType, RemoteAssembly"
               url="http://computername:8080/RemoteType.rem"
            />
         </client>
         <channels>
            <channel
               ref="http" 
               port="0"
            />
         </channels>
      </application>
   </system.runtime.remoting>
</configuration>

Vedere anche

Riferimento

Schema delle impostazioni remote

Concetti

Attivazione di oggetti remoti

Data di compilazione: 2010-02-13