ServiceMetadataBehavior 类

定义

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

继承

Object

ServiceMetadataBehavior

实现

IServiceBehavior

示例

下面的代码示例演示如何在配置文件中使用 ServiceMetadataBehavior，以便启用进行 HTTP GET 和 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>

注解

将 ServiceMetadataBehavior 对象添加到 ServiceDescription.Behaviors 应用程序配置文件 (或 <serviceMetadata> 元素的集合中，) 启用或禁用服务元数据的发布。 但是，向服务添加行为并不足以启用元数据发布：

• 要启用 WS-Transfer GET 元数据检索，还必须向您的服务添加终结点，其中协定为 IMetadataExchange。 有关示例，请参阅 如何：使用代码发布服务的元数据。 IMetadataExchange 终结点可以按配置任何其他终结点的方式进行配置。

• 要启用 HTTP GET 元数据检索，请将 HttpGetEnabled 属性设置为 true。 有关 HTTP GET 元数据的地址的详细信息，请参阅 HttpGetEnabled。

IMetadataExchange 终结点的地址遵循关于基址和终结点地址相结合的常规规则。 有关详细信息，请参阅 发布元数据。

若要使用配置文件启用元数据发布，请将 <serviceMetadata> 元素添加到 <serviceBehaviors> 元素，并将该元素与 <要为其发布元数据的服务> 元素相关联。 有关示例，请参阅 如何：使用配置文件发布服务的元数据。 该类包含以下成员：

• HttpGetEnabled 属性指定是否为 HTTP/GET 请求返回元数据。

• HttpGetUrl 属性（与基址结合使用）可指定 HTTP/GET 地址。

• HttpsGetEnabled 属性指定是否为 HTTPS/GET 请求返回元数据。

• HttpsGetUrl 属性（与基址结合使用）可指定 HTTPS/GET 地址。

• MetadataExporter 属性返回基础导出程序。

通常，从应用程序配置文件使用 ServiceMetadataBehavior。 有关代码示例，请参见“示例”部分。

构造函数

字段

属性

方法

显式接口实现

适用于