<serviceMetadata>

Anger publiceringen av tjänstens metadata och tillhörande information.

<Konfiguration>
  <system.serviceModel>
    <Beteenden>
      <serviceBehaviors>
        <Beteende>
          <serviceMetadata>

Syntax

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

Attribut och element

I följande avsnitt beskrivs attribut, underordnade element och överordnade element.

Attribut

Underordnade element

Ingen

Överordnade element

Kommentarer

Med det här konfigurationselementet kan du styra publiceringsfunktionerna för metadata för en tjänst. För att förhindra oavsiktligt avslöjande av potentiellt känsliga tjänstmetadata inaktiverar standardkonfigurationen för WCF-tjänster (Windows Communication Foundation) metadatapublicering. Det här beteendet är säkert som standard, men innebär också att du inte kan använda ett verktyg för metadataimport (till exempel Svcutil.exe) för att generera den klientkod som krävs för att anropa tjänsten om inte tjänstens beteende för metadatapublicering uttryckligen är aktiverat i konfigurationen. Med det här konfigurationselementet kan du aktivera det här publiceringsbeteendet för din tjänst.

Ett detaljerat exempel på hur du konfigurerar det här beteendet finns i Beteende för metadatapublicering.

Med de valfria httpGetBinding attributen och httpsGetBinding kan du konfigurera bindningar som används för metadatahämtning via HTTP GET (eller HTTPS GET). Om de inte anges används standardbindningarna (HttpTransportBindingElementnär det gäller HTTP och HttpsTransportBindingElement, när det gäller HTTPS) för metadatahämtning efter behov. Observera att du inte kan använda dessa attribut med de inbyggda WCF-bindningarna. Endast bindningar med inre bindningselement som stöder IReplyChannel stöds. Dessutom måste egenskapen för MessageVersion bindningen vara None.

För att minska exponeringen av en tjänst för skadliga användare är det möjligt att skydda överföringen med hjälp av mekanismen SSL över HTTP (HTTPS). För att göra det måste du först binda ett lämpligt X.509-certifikat till en specifik port på den dator som är värd för tjänsten. (Mer information finns i Arbeta med certifikat.) För det andra lägger du till det här elementet i tjänstkonfigurationen och anger httpsGetEnabled attributet till true. httpsGetUrl Ange slutligen attributet till URL:en för tjänstmetadataslutpunkten, som du ser i följande exempel.

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

Exempel

I följande exempel konfigurerar du en tjänst för att exponera metadata med hjälp av elementet <serviceMetadata> . Den konfigurerar också en slutpunkt för att exponera IMetadataExchange kontraktet som en implementering av ett mex-protokoll (WS-MetadataExchange). I exemplet används mexHttpBinding, som är en bekvämlighetsstandardbindning som motsvarar wsHttpBinding med säkerhetsläget inställt på None. En relativ adress för "mex" används i slutpunkten, som när den matchas mot tjänstens basadress resulterar i en slutpunktsadress för 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>

Se även

• ServiceMetadataPublishingElement
• ServiceMetadataBehavior
• Säkerhetsbeteenden
• Beteende för metadatapublicering