<provider>-Element (Vorlage)

Artikel
12/17/2007

Enthält die Anbietervorlage für einen Channelempfänger, der in die Server- oder Client-Channelempfängerkette eingefügt werden soll. Für den Einschluss dieses Elements sind zwei verschiedene Hierarchien möglich.

<system.runtime.remoting>-Element

<channelSinkProviders>-Element

<clientProviders>-Element (Instanz)

<provider>-Element (Vorlage)

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete sowie übergeordnete Elemente beschrieben.

Attribute

Attribut Beschreibung

Attribut	Beschreibung
id	Erforderliches Attribut. Gibt eine Zeichenfolge an, die diesen Channelempfängeranbieter identifiziert. Andere Elemente können diese Zeichenfolge in ihrem ref-Attribut verwenden, um eine Bindung zu diesem Channelempfängeranbieter herzustellen.
type	Erforderliches Attribut. Gibt den vollständigen Typnamen des Channelempfängeranbieters und den Namen der Assembly an, die die Anbieterimplementierung enthält. Hierzu gehören die Version, die Kultur und der öffentliche Schlüssel, wenn die übergeordnete Assembly sich im globalen Assemblycache befindet.
customChannelSinkProperty	Optionales Attribut. Gibt eine Eigenschaft für einen unterstützten benutzerdefinierten Channelempfänger an. Sie können beliebig viele Eigenschaften für Anbieter und Channelempfänger angeben, die von benutzerdefinierten Channelempfängeranbietern und deren Empfängern unterstützt werden könnten. Eine benutzerdefinierte Channelempfängereigenschaft geben Sie mit einem Attribut-Wert-Paar an. Im folgenden Beispiel `<provider id="CustomChannelSinkProvider" type="Namespace.CustomChannelSinkProvider, CustomChannels" customChannelSinkProperty="ChannelSinkPropertyValue"/>` ist das `customChannelSinkProperty`-Attribut und der zugehörige Wert als IDictionary-Argument im Konstruktor des Anbieters verfügbar. Benutzerdefinierte Daten von Empfängeranbietern können hier ebenfalls angegeben werden. Es wird nur eine Knotenebene unterstützt. Im folgenden Beispiel `<provider ref="custom"> <extra data="value"/> <extra data="AnotherValue"/> </provider>` sind die zusätzlichen Informationen als ICollection von SinkProviderData im Konstruktor des Anbieters verfügbar.

Erforderliches Attribut.

Gibt eine Zeichenfolge an, die diesen Channelempfängeranbieter identifiziert. Andere Elemente können diese Zeichenfolge in ihrem ref-Attribut verwenden, um eine Bindung zu diesem Channelempfängeranbieter herzustellen.

type

Erforderliches Attribut.

Gibt den vollständigen Typnamen des Channelempfängeranbieters und den Namen der Assembly an, die die Anbieterimplementierung enthält. Hierzu gehören die Version, die Kultur und der öffentliche Schlüssel, wenn die übergeordnete Assembly sich im globalen Assemblycache befindet.

customChannelSinkProperty

Optionales Attribut.

Gibt eine Eigenschaft für einen unterstützten benutzerdefinierten Channelempfänger an. Sie können beliebig viele Eigenschaften für Anbieter und Channelempfänger angeben, die von benutzerdefinierten Channelempfängeranbietern und deren Empfängern unterstützt werden könnten. Eine benutzerdefinierte Channelempfängereigenschaft geben Sie mit einem Attribut-Wert-Paar an. Im folgenden Beispiel

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

ist das customChannelSinkProperty-Attribut und der zugehörige Wert als IDictionary-Argument im Konstruktor des Anbieters verfügbar.

Benutzerdefinierte Daten von Empfängeranbietern können hier ebenfalls angegeben werden. Es wird nur eine Knotenebene unterstützt. Im folgenden Beispiel

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

sind die zusätzlichen Informationen als ICollection von SinkProviderData im Konstruktor des Anbieters verfügbar.

Untergeordnete Elemente

Keines.

Übergeordnete Elemente

Element	Beschreibung
channelSinkProviders	Enthält Vorlagen für Anbieter für Client- und Server-Channelempfänger. Auf alle unter diesem Element angegebenen Channelempfängeranbieter kann an einer beliebigen Stelle verwiesen werden, an der ein Channelempfängeranbieter registriert sein könnte.
clientProviders	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 Anbieter an einer der unten angegebenen Positionen festlegen, werden dadurch 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.
configuration	Das Stammelement in jeder Konfigurationsdatei, das von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.
system.runtime.remoting	Enthält Informationen über Remoteobjekte und Channels.

Beispiel

Die folgende Konfigurationsdatei weist mithilfe des <provider>-Instanzelements dem HttpChannel den "propsetter"-Channelempfängeranbieter und einen "null"-Channelempfängeranbieter zu, die ihrerseits mit <provider>-Vorlagenelementen deklariert wurden. Außerdem wird der "propsetter"-Channelempfängeranbieter mit den benutzerdefinierten Anbietereigenschaften erstellt, die als Attribute für das Anbieterinstanzelement und als Name-Wert-Paare für das untergeordnete <endpoint>-Attribut angegeben wurden.

<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>