<serviceMetadata>

Gibt die Veröffentlichung von Dienstmetadaten und den zugehörigen Informationen an.

<configuration>
  <system.serviceModel>
    <behaviors>
      <serviceBehaviors>
        <behavior>
          <serviceMetadata>

Syntax

<serviceMetadata externalMetadataLocation="String"
                 httpGetBinding="String"
                 httpGetBindingConfiguration="String"
                 httpGetEnabled="Boolean"
                 httpGetUrl="String"
                 httpsGetBinding="String"
                 httpsGetBindingConfiguration="String"
                 httpsGetEnabled="Boolean"
                 httpsGetUrl="String"
                 policyVersion="Policy12/Policy15" />

Attribute und Elemente

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

Attribute

Untergeordnete Elemente

Nichts

Übergeordnete Elemente

Bemerkungen

Mit diesem Konfigurationselement können Sie die Metadatenveröffentlichungsfeatures eines Diensts steuern. Um die unbeabsichtigte Offenlegung potenziell sensibler Dienstmetadaten zu verhindern, deaktiviert die Standardkonfiguration für WCF-Dienste (Windows Communication Foundation) die Metadatenveröffentlichung. Dieses Verhalten ist standardmäßig sicher, bedeutet aber auch, dass Sie kein Metadatenimporttool (z. B. Svcutil.exe) verwenden können, um den zum Aufrufen des Diensts erforderlichen Clientcode zu generieren, es sei denn, das Metadatenveröffentlichungsverhalten des Diensts ist in der Konfiguration explizit aktiviert. Mit diesem Konfigurationselement können Sie dieses Veröffentlichungsverhalten für Ihren Dienst aktivieren.

Ein detailliertes Beispiel für die Konfiguration dieses Verhaltens finden Sie unter Metadatenveröffentlichungsverhalten.

Mit den optionalen httpGetBinding Attributen httpsGetBinding können Sie die Bindungen konfigurieren, die zum Abrufen von Metadaten über HTTP GET (oder HTTPS GET) verwendet werden. Wenn sie nicht angegeben sind, werden die Standardbindungen (HttpTransportBindingElementim Fall von HTTP und HttpsTransportBindingElementim Fall von HTTPS) für den Metadatenabruf entsprechend verwendet. Beachten Sie, dass Sie diese Attribute nicht mit den integrierten WCF-Bindungen verwenden können. Es werden nur Bindungen mit inneren Bindungselementen IReplyChannel unterstützt. Darüber hinaus muss die MessageVersion Eigenschaft der Bindung sein None.

Damit der Dienst möglichst gut vor böswilligen Benutzern geschützt wird, können Sie für die Übertragung den HTTPS-Mechanismus (SSL über HTTP) verwenden. Hierfür müssen Sie zunächst ein geeignetes X.509-Zertifikat an einen bestimmten Port des Computers, auf dem der Dienst gehostet wird, binden. (Weitere Informationen finden Sie unter Arbeiten mit Zertifikaten.) Fügen Sie dieses Element der Dienstkonfiguration hinzu, und legen Sie das httpsGetEnabled Attribut auf true. Setzen Sie abschließend wie im folgenden Beispiel gezeigt das httpsGetUrl-Attribut auf den URL des Dienstmetadaten-Endpunkts:

<behaviors>
  <serviceBehaviors>
    <behavior name="NewBehavior">
      <serviceMetadata httpsGetEnabled="true"
                       httpsGetUrl="https://myComputerName/myEndpoint" />
    </behavior>
  </serviceBehaviors>
</behaviors>

Example

Im folgenden Beispiel wird ein Dienst so konfiguriert, dass Metadaten mithilfe des <serviceMetadata-Elements> verfügbar gemacht werden. Außerdem wird ein Endpunkt so konfiguriert, dass er den IMetadataExchange Vertrag als Implementierung eines WS-MetadataExchange (MEX)-Protokolls verfügbar macht. Im Beispiel wird die mexHttpBindingStandardbindung verwendet, die dem wsHttpBinding sicherheitsmodus entspricht None. Eine relative Adresse von "mex" wird im Endpunkt verwendet, was bei der Auflösung mit der Basisadresse der Dienste zu einer Endpunktadresse von http://localhost/servicemodelsamples/service.svc/mex.

<configuration>
  <system.serviceModel>
    <services>
      <service name="Microsoft.ServiceModel.Samples.CalculatorService"
               behaviorConfiguration="CalculatorServiceBehavior">
        <!-- This endpoint is exposed at the base address provided by the host: http://localhost/servicemodelsamples/service.svc -->
        <endpoint address=""
                  binding="wsHttpBinding"
                  contract="Microsoft.ServiceModel.Samples.ICalculator" />
        <!-- The mex endpoint is exposed at http://localhost/servicemodelsamples/service.svc/mex
             To expose the IMetadataExchange contract, you must enable the serviceMetadata behavior as demonstrated below. -->
        <endpoint address="mex"
                  binding="mexHttpBinding"
                  contract="IMetadataExchange" />
      </service>
    </services>
    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->
    <behaviors>
      <serviceBehaviors>
        <behavior name="CalculatorServiceBehavior">
          <!-- The serviceMetadata behavior publishes metadata through the IMetadataExchange contract. When this behavior is
               present, you can expose this contract through an endpoint as shown above. Setting httpGetEnabled to true publishes
               the service's WSDL at the <baseaddress>?wsdl eg. http://localhost/servicemodelsamples/service.svc?wsdl -->
          <serviceMetadata httpGetEnabled="True" />
          <serviceDebug includeExceptionDetailInFaults="False" />
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>
</configuration>

Siehe auch

• ServiceMetadataPublishingElement
• ServiceMetadataBehavior
• Sicherheitsverhalten
• Verhalten der Metadatenveröffentlichung