<clientProviders>-Element (Instanz)

  • Artikel

Dieses Thema bezieht sich auf eine veraltete Technologie, die zum Zwecke der Abwärtskompatibilität mit vorhandenen Anwendungen beibehalten wird und nicht für die neue Entwicklung empfohlen wird. Verteilte Anwendungen sollten jetzt mit  Windows Communication Foundation (WCF) entwickelt werden.

Enthält Anbieter für Channelsenken, die Bestandteil der standardmäßigen clientseitigen Channelsenken-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-Channelsenken für diesen Channel überschrieben. Wenn solche Standard-Channelsenken in die Channelsenken-Aufrufkette für diese Vorlage eingefügt werden sollen, müssen Sie sie hier angeben.

<Konfiguration>

<system.runtime.remoting>

<Channels>

<Channel>

< clientProviders>

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

<Konfiguration>

<system.runtime.remoting>

<application>

<Channels>

<Channel>

< clientProviders>

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

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

Untergeordnete Elemente

Element Beschreibung

<formatter>

Enthält eine Formatierungssenke, die in die Channelsenken-Aufrufkette eingefügt werden soll. Kann im <clientProviders>-Instanzelement einmal vorkommen.

<provider>

Enthält eine Channelsenke, der in die Channelsenke-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"-Channelsenkenanbieter hinzu und übergibt einige benutzerdefinierte Konfigurationselemente, die von diesem Channelsenkenanbieter 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>

Anforderungen

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

Siehe auch

Verweis

Schema für Remoteeinstellungen

Konzepte

Senken und Senkenketten

Erstellungsdatum: 2010-02-13