ServiceMetadataBehavior Třída

Definice

Obor názvů:

System.ServiceModel.Description

Sestavení:

System.ServiceModel.dll

Řídí publikování metadat služby a souvisejících informací.

public ref class ServiceMetadataBehavior : System::ServiceModel::Description::IServiceBehavior

public class ServiceMetadataBehavior : System.ServiceModel.Description.IServiceBehavior

type ServiceMetadataBehavior = class
    interface IServiceBehavior

Public Class ServiceMetadataBehavior
Implements IServiceBehavior

Dědičnost

Object

ServiceMetadataBehavior

Implementuje

IServiceBehavior

Příklady

Následující příklad kódu ukazuje použití ServiceMetadataBehavior v konfiguračním souboru k povolení podpory metadat pro požadavky HTTP GET a WS-Transfer GET.

        // Create a new metadata behavior object and set its properties to
        // create a secure endpoint.
        ServiceMetadataBehavior sb = new ServiceMetadataBehavior();
        //sb.EnableHelpPage= true;
        //sb.HttpsGetUrl = new Uri("https://myMachineName:8036/myEndpoint");
        //myServiceHost.Description.Behaviors.Add(sb);
    }

      private void SnippetServiceMetadataBehavior()
      {
          // service for which <<indigo2>> automatically adds a
          // ServiceMetadataBehavior to publish metadata as well as
          // an HTML service help page

          // from C_HowToSecureEndpoint\cs
          // Create a new metadata behavior object and set its properties to
          // create a secure endpoint.
          ServiceMetadataBehavior sb = new ServiceMetadataBehavior();
/*          sb.EnableHelpPage = true;
          sb.enableMetadataExchange = true;
          sb.HttpsGetUrl = new Uri("https://myMachineName:8036/myEndpoint");
          myServiceHost.Description.Behaviors.Add(sb);
 */
      }

    private void Run()
    {

      // T:System.ServiceModel.ServiceMetadataBehavior
      // <Snippet#0>

      // Create a ServiceHost for the service type and use the base address from configuration.
      ServiceHost host = new ServiceHost(typeof(SampleService));
      try
      {
        ServiceMetadataBehavior metad
          = host.Description.Behaviors.Find<ServiceMetadataBehavior>();
        if (metad == null)
          metad = new ServiceMetadataBehavior();
        metad.HttpGetEnabled = true;
        host.Description.Behaviors.Add(metad);
        host.AddServiceEndpoint(
          ServiceMetadataBehavior.MexContractName,
          MetadataExchangeBindings.CreateMexHttpBinding(),
          "mex"
        );

        // The service can now be accessed.
        Console.WriteLine("The service is ready.");
        Console.WriteLine("Press <ENTER> to terminate service.");
        Console.WriteLine();
        Console.ReadLine();

        // Close the ServiceHostBase to shutdown the service.
        host.Close();

        // </Snippet#0>

Poznámky

ServiceMetadataBehavior Přidáním objektu ServiceDescription.Behaviors do kolekce (nebo <elementu serviceMetadata> v konfiguračním souboru aplikace) povolíte nebo zakážete publikování metadat služby. Přidání chování do služby ale nestačí k povolení publikování metadat:

• Pokud chcete povolit WS-Transfer načítání metadat GET, musíte také přidat koncový bod do vaší služby, ve které je IMetadataExchangekontrakt . Příklad najdete v tématu Postupy: Publikování metadat pro službu pomocí kódu. Koncový IMetadataExchange bod je možné nakonfigurovat jako jakýkoli jiný koncový bod.

• Chcete-li povolit načítání metadat HTTP GET, nastavte HttpGetEnabled vlastnost na true. Další informace o adrese metadat HTTP GET naleznete v tématu HttpGetEnabled.

Adresa koncového IMetadataExchange bodu se řídí normálními pravidly týkajícími se kombinace základních adres a adres koncových bodů. Další informace najdete v tématu Metadata publikování.

Pokud chcete povolit publikování metadat pomocí konfiguračního souboru, přidejte <element serviceMetadata> do elementu <serviceBehaviors> a přidružte element <k elementu služby> , pro který chcete publikovat metadata. Příklad najdete v tématu Postupy: Publikování metadat pro službu pomocí konfiguračního souboru. Třída má následující členy:

• Vlastnost HttpGetEnabled určuje, jestli jsou metadata vrácena pro požadavky HTTP/GET.

• Vlastnost HttpGetUrl (ve spojení se základními adresami) určuje adresu HTTP/GET.

• Vlastnost HttpsGetEnabled určuje, jestli se pro požadavek HTTPS/GET vrátí metadata.

• Vlastnost HttpsGetUrl (ve spojení se základními adresami) určuje adresu HTTPS/GET.

• Vlastnost MetadataExporter vrátí podkladový vývozce.

Obvykle se ServiceMetadataBehavior používá z konfiguračního souboru aplikace. Příklad kódu najdete v části Příklad.

Konstruktory

ServiceMetadataBehavior()

Inicializuje novou instanci ServiceMetadataBehavior třídy.

Pole

MexContractName

Vrátí řetězec IMetadataContract.

Vlastnosti

ExternalMetadataLocation	Získá nebo nastaví hodnotu, která je umístěním metadat služby.
HttpGetBinding	Získá nebo nastaví vazbu použitou ke konfiguraci načítání metadat při přenosu http.
HttpGetEnabled	Získá nebo nastaví hodnotu, která označuje, zda publikovat metadata služby pro načtení pomocí požadavku HTTP/GET.
HttpGetUrl	Získá nebo nastaví umístění publikace metadat pro požadavky HTTP/GET.
HttpsGetBinding	Získá nebo nastaví vazbu použitou ke konfiguraci načítání metadat při přenosu HTTPS.
HttpsGetEnabled	Získá nebo nastaví hodnotu, která označuje, zda publikovat metadata služby pro načtení pomocí požadavku HTTPS/GET.
HttpsGetUrl	Získá nebo nastaví umístění publikace metadat pro požadavky HTTPS/GET.
MetadataExporter	Získá nebo nastaví interní MetadataExporter objekt použitý k publikování metadat služby.

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection)	IServiceBehavior Implementace, která nakonfiguruje základní vazby tak, aby podporovala chování.
IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase)	IServiceBehavior Implementace, která konfiguruje podkladové vazby tak, aby podporovala chování ve službě.
IServiceBehavior.Validate(ServiceDescription, ServiceHostBase)	IServiceBehavior Implementace, která ověřuje, že popis služby může podporovat chování.