Condividi tramite

Elemento <provider> (modello)

  • Articolo

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 il modello di provider di sink di canale per un sink di canale da inserire nella catena di sink di canale server o client. È possibile includere tale elemento in base a due ordini gerarchici. 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 <channelSinkProviders>
      Elemento <clientProviders> (istanza)
        Elemento <provider> (modello)

Sintassi

<provider  
   id="ProviderID" 
   type="ProviderType, ProviderAssembly"    
   customChannelSinkProperty="customProperty"
/>

Attributi ed elementi

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

Attributi

Attributo Descrizione

id

Attributo obbligatorio.

Specifica una stringa che identifica il provider di sink di canale. Questa stringa può essere utilizzata nell'attributo ref di altri utenti per eseguire un'associazione al provider di sink del canale in questione.

type

Attributo obbligatorio.

Specifica il nome completo del tipo del provider di sink di canale e il nome dell'assembly contenente l'implementazione del provider. 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.

customChannelSinkProperty

Attributo facoltativo.

Indica una proprietà personalizzata di sink di canale supportata. È possibile specificare un numero qualsiasi di proprietà di sink di provider e di canale in grado di essere supportate da provider di sink di canale personalizzati e dai propri sink. Una proprietà personalizzata di sink di canale verrà specificata con una coppia attributo/valore. Nell’esempio

<provider id="CustomChannelSinkProvider" type="Namespace.CustomChannelSinkProvider, CustomChannels" customChannelSinkProperty="ChannelSinkPropertyValue"/>

l'attributo customChannelSinkProperty e il relativo valore saranno disponibili come argomento IDictionary nel costruttore del provider.

È anche possibile specificare in questo ambito i dati personalizzati del provider di sink. È supportato un solo livello di nodi. Nell’esempio

<provider ref="custom">
<extra data="value"/>
<extra data="AnotherValue"/>
</provider>

le informazioni aggiuntive saranno disponibili come interfaccia ICollection di SinkProviderData nel costruttore del provider.

Elementi figlio

Nessuno.

Elementi padre

Elemento Descrizione

channelSinkProviders

Contiene modelli per provider di sink di canale client e server. È possibile fare riferimento a qualsiasi provider di sink di canale specificato sotto questo elemento dovunque è registrato un provider di sink di canale.

clientProviders

Contiene i provider per i sink di canale che devono diventare parte della catena di chiamate di sink di canale sul lato client predefinita per il modello di canale quando si fa riferimento a tale modello in altri punti del file di configurazione. Se vengono specificati provider, viene eseguito l'override dei sink di canale predefiniti per il canale. Se si desidera inserire tali sink di canale predefiniti nella catena di chiamate di sink di canale per il modello, è necessario specificare anche tali sink.

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 utilizzato un elemento di istanza <provider> per assegnare al canale HttpChannel i provider di sink di canale "propsetter" e "null" che sono stati dichiarati con elementi del modello <provider>. Inoltre, il provider di sink di canale "propsetter" verrà creato con le proprietà personalizzate del provider specificate come attributi nell'elemento di istanza del provider e come coppie nome/valore dell'attributo figlio <endpoint>.

<configuration>
   <system.runtime.remoting>
      <application>
         <client>
            <wellknown 
               type="RemoteType, RemoteAssembly"
               url="http://computername:8080/RemoteType.rem"/>
         </client>
         <channels>
            <channel ref="http">
               <clientProviders>
                  <formatter ref="soap"/>
                  <provider 
                     ref="propsetter" 
                     username="bob" 
                     writeToConsole="true"
                  >
                     <endpoint url="contoso.com:9000" someProperty="xyz" />
                     <endpoint url="contoso.com:9001" someProperty="123" />
                  </provider>
                  <provider ref="null" writeToConsole="true" />
               </clientProviders>
            </channel>
         </channels>
      </application>
      <channelSinkProviders>
         <clientProviders>
            <provider 
               id="propsetter" 
               type="ChannelSinkPropertySetterProvider, SinkAssembly" 
            />
            <provider 
               id="null" 
               type="NullSinkProvider, SinkAssembly" 
            />
         </clientProviders>
      </channelSinkProviders>
      <debug loadTypes="true" />
   </system.runtime.remoting>
</configuration>

Vedere anche

Riferimento

Schema delle impostazioni remote

Concetti

Sink e catene di sink

Data di compilazione: 2010-02-13