<clientProviders>-Element (Instanz)

Artikel
12/17/2007

Enthält Anbieter für Channelempfänger, die Bestandteil der standardmäßig verwendeten clientseitigen Channelempfänger-Aufrufkette für diese Channelvorlage werden sollen, wenn an anderer Stelle in der Konfigurationsdatei auf die Vorlage verwiesen wird. Wenn Sie an einer der unten angegebenen Positionen Anbieter festlegen, werden die Standard-Channelempfänger für diesen Channel überschrieben. Wenn solche Standard-Channelempfänger in die Channelempfänger-Aufrufkette für diese Vorlage eingefügt werden sollen, müssen Sie sie hier angeben.

<system.runtime.remoting>

<clientProviders>

Die hier angegebenen Anbieter überschreiben die Standardanbieter für diesen Channel überall dort, wo auf diese Channelvorlage verwiesen wird.

<system.runtime.remoting>

<clientProviders>

Hier überschreiben die Anbieter Standardanbieter nur für diese Channelinstanz.

<clientProviders> 
      <formatter/> 
      <provider/> 
</clientProviders>

Untergeordnete Elemente

Element	Beschreibung
<formatter>	Enthält einen Formatierungsempfänger, der in die Channelempfänger-Aufrufkette eingefügt werden soll. Kann im <clientProviders>-Instanzelement einmal vorkommen.
<provider>	Enthält einen Channelempfänger, der in die Channelempfänger-Aufrufkette eingefügt werden soll. Kann im <clientProviders>-Instanzelement einmal oder mehrmals vorkommen.

Hinweise

Bei Verwendung in einem Channelvorlagenelement überschreiben alle referenzierten oder deklarierten Anbieter auf der gezeigten Ebene die Standardanbieter des Channels und werden zu Standardanbietern, wenn an anderer Stelle in der Konfigurationsdatei auf den Channel verwiesen wird. Machen Sie sich klar, dass alle Standardanbieter oder -formatierungsprogramme für diesen Channel überschrieben werden, wenn dieses Element verwendet wird. Wenn diese Anbieter oder Formatierungsprogramme zusätzlich zu den benutzerdefinierten Anbietern Teil dieser Channelvorlage sein sollen, müssen Sie alle Anbieter und das Formatierungsprogramm angeben, das für diesen Channel verwendet werden soll, wenn durch andere darauf verwiesen wird.

Bei Verwendung in einer Channelinstanz überschreiben alle referenzierten oder deklarierten Anbieter auf der angezeigten Ebene die Standardanbieter dieses Channels nur für diese Channelinstanz. Wenn diese Instanz auf eine Vorlage verweist, die clientProviders deklariert, überschreiben die hier angegebenen Anbieter auch jene Anbieter vollständig.

Beispiel

Die folgende Konfigurationsdatei deklariert mithilfe eines <channels>-Vorlagenelements einen HttpChannel mit der id "httpbinary" und gibt mit dem <clientProviders>-Vorlagenelement an, dass BinaryClientFormatterSink die Remoteaufrufe serialisieren soll. Anschließend gibt sie die Anforderung aus, dass diese Clientanwendung diese spezielle Channelkonfiguration verwenden soll, indem sie innerhalb des <application>-Elements ref="httpbinary" im <channel>-Instanzelement angibt. Zum Schluss fügt sie mithilfe eines <clientProviders>-Instanzelements einen "propsetter"-Channelempfängeranbieter hinzu und übergibt einige benutzerdefinierte Konfigurationselemente, die von diesem Channelempfängeranbieter verwendet werden. Beachten Sie, dass bei Verwendung des type-Attributs zum Angeben eines Typs in einer Assembly, die sich im globalen Assemblycache befindet, vollständige Typinformationen einschließlich Version, Kultur und öffentlicher Schlüssel erforderlich sind. Diese Informationen wurden der Kürze halber in den unten stehenden type-Attributen weggelassen.

<configuration>
   <system.runtime.remoting>
      <channelSinkProviders>
         <clientProviders>
            <provider 
               id="propsetter" 
               type="ChannelSinkPropertySetterProvider, PropsSink" 
            />
         </clientProviders>
      <channels>
         <channel 
            type="System.Runtime.Remoting.Channels.Http.HttpChannel, System.Runtime.Remoting" 
            id="httpbinary"
         >
            <clientProviders>
               <formatter                   type="System.Runtime.Remoting.Channels.BinaryClientFormatterSinkProvider, System.Runtime.Remoting"
               />
            </clientProviders>
         </channel>
      </channels>
      <application>
         <channels>
            <channel ref="httpbinary">
               <clientProviders>
                  <provider 
                     ref="propsetter" 
                     username="somename" 
                     writeToConsole="true"
                  >
                     <endpoint url="contoso.com:9000" someProp="xyz" />
                     <endpoint url="contoso.com:9001" someProp="123" />
                  </provider>
               </clientProviders>
            </channel>
         </channels>
         <client>
            <wellknown 
               url="http://computername:80/RemoteType.rem"                type="RemoteType, RemoteAssembly"
            />
         </client>
      </application>
   </system.runtime.remoting>
</configuration>

Voraussetzungen

Konfigurationsdateien: Anwendungskonfigurationsdatei, Konfigurationsdatei für den Computer (Machine.config)

Siehe auch

Referenz

Schema für Remoteeinstellungen

Konzepte

Empfänger und Empfängerketten

Footer image

Freigeben über