ServiceHost クラス

定義

名前空間:: System.ServiceModel

アセンブリ:: System.ServiceModel.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

サービスのホストを提供します。

public ref class ServiceHost : System::ServiceModel::ServiceHostBase

public class ServiceHost : System.ServiceModel.ServiceHostBase

type ServiceHost = class
    inherit ServiceHostBase

Public Class ServiceHost
Inherits ServiceHostBase

継承: Object

CommunicationObject

ServiceHostBase
ServiceHost

派生: System.ServiceModel.Security.WSTrustServiceHost

System.ServiceModel.Web.WebServiceHost

例

// Host the service within this EXE console application.
public static void Main()
{
  using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService)))
  {
    try
    {
      // Open the ServiceHost to start listening for messages.
      serviceHost.Open();

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

      // Close the ServiceHost.
      serviceHost.Close();
    }
    catch (TimeoutException timeProblem)
    {
      Console.WriteLine(timeProblem.Message);
      Console.ReadLine();
    }
    catch (CommunicationException commProblem)
    {
      Console.WriteLine(commProblem.Message);
      Console.ReadLine();
    }
  }
}

' Host the service within this EXE console application.
Public Shared Sub Main()
    ' Create a ServiceHost for the CalculatorService type and use the base address from config.
    Using svcHost As New ServiceHost(GetType(CalculatorService))
        Try
            ' Open the ServiceHost to start listening for messages.
            svcHost.Open()

            ' 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 ServiceHost.
            svcHost.Close()

        Catch timeout As TimeoutException
            Console.WriteLine(timeout.Message)
            Console.ReadLine()
        Catch commException As CommunicationException
            Console.WriteLine(commException.Message)
            Console.ReadLine()
        End Try
    End Using

End Sub

注釈

Windows Communication Foundation (WCF) サービスモデルプログラミングモデルで使用されるホストを実装します。

ServiceHost クラスを使用して、インターネットインフォメーションサービス (IIS) または Windows Activation Services (WAS) を使用してサービスを公開していない場合に、クライアントアプリケーションで使用するサービスを構成して公開します。 IIS と WAS の両方が、ユーザーの代わりに ServiceHost オブジェクトと対話します。

呼び出し元が使用するサービスを公開するには、WCF には完全なサービスの説明 ( ServiceDescription クラスで表される) が必要です。 ServiceHost クラスは、サービスの種類と構成情報からServiceDescriptionを作成し、その説明を使用して、説明内の各エンドポイントのChannelDispatcher オブジェクトを作成します。

ServiceHost オブジェクトを使用して、サービスの読み込み、エンドポイントの構成、セキュリティ設定の適用、受信要求を処理するためのリスナーの開始を行います。

コンストラクター

名前	説明
ServiceHost()	ServiceHost クラスの新しいインスタンスを初期化します。
ServiceHost(Object, Uri[])	サービスのインスタンスとそのベースアドレスを指定して、 ServiceHost クラスの新しいインスタンスを初期化します。
ServiceHost(Type, Uri[])	サービスの種類とそのベースアドレスを指定して、 ServiceHost クラスの新しいインスタンスを初期化します。

プロパティ

名前	説明
Authentication	サービス認証の動作を取得します。 (継承元 ServiceHostBase)
Authorization	ホストされているサービスの承認動作を取得します。 (継承元 ServiceHostBase)
BaseAddresses	ホストされているサービスによって使用されるベースアドレスを取得します。 (継承元 ServiceHostBase)
ChannelDispatchers	サービスホストによって使用されるチャネルディスパッチャーのコレクションを取得します。 (継承元 ServiceHostBase)
CloseTimeout	サービスホストが閉じるのに許可される時間の間隔を取得または設定します。 (継承元 ServiceHostBase)
Credentials	ホストされているサービスの資格情報を取得します。 (継承元 ServiceHostBase)
DefaultCloseTimeout	サービスホストが閉じるのに許可される既定の時間間隔を取得します。 (継承元 ServiceHostBase)
DefaultOpenTimeout	サービスホストを開くために許可される既定の時間間隔を取得します。 (継承元 ServiceHostBase)
Description	ホストされているサービスの説明を取得します。 (継承元 ServiceHostBase)
Extensions	現在指定されているサービスホストの拡張機能を取得します。 (継承元 ServiceHostBase)
ImplementedContracts	ホストされているサービスによって実装されたコントラクトを取得します。 (継承元 ServiceHostBase)
IsDisposed	通信オブジェクトが破棄されたかどうかを示す値を取得します。 (継承元 CommunicationObject)
ManualFlowControlLimit	ホストされるサービスによって受信されるメッセージのフロー制御制限を取得または設定します。 (継承元 ServiceHostBase)
OpenTimeout	サービスホストが開くことを許可する時間間隔を取得または設定します。 (継承元 ServiceHostBase)
SingletonInstance	ホストされているサービスのシングルトンインスタンスを取得します。
State	通信オブジェクトの現在の状態を示す値を取得します。 (継承元 CommunicationObject)
ThisLock	状態遷移中にクラスインスタンスを保護する相互排他的ロックを取得します。 (継承元 CommunicationObject)

メソッド

名前	説明
Abort()	通信オブジェクトを現在の状態から終了状態に直ちに遷移させます。 (継承元 CommunicationObject)
AddBaseAddress(Uri)	サービスホストにベースアドレスを追加します。 (継承元 ServiceHostBase)
AddDefaultEndpoints()	既定のバインディングを使用して、サービスホストで見つかった各コントラクト内のすべてのベースアドレスのサービスエンドポイントを追加します。 (継承元 ServiceHostBase)
AddServiceEndpoint(ServiceEndpoint)	指定したサービスエンドポイントをホステッドサービスに追加します。 (継承元 ServiceHostBase)
AddServiceEndpoint(String, Binding, String, Uri)	リッスンするアドレスを含むコントラクト、バインディング、エンドポイントアドレス、URI を指定して、ホストされるサービスにサービスエンドポイントを追加します。 (継承元 ServiceHostBase)
AddServiceEndpoint(String, Binding, String)	指定したコントラクト、バインディング、およびエンドポイントアドレスを使用して、ホストされているサービスにサービスエンドポイントを追加します。 (継承元 ServiceHostBase)
AddServiceEndpoint(String, Binding, Uri, Uri)	エンドポイントとリッスンアドレスを含む、指定されたコントラクト、バインディング、URI を使用して、ホストされるサービスにサービスエンドポイントを追加します。 (継承元 ServiceHostBase)
AddServiceEndpoint(String, Binding, Uri)	指定したコントラクト、バインディング、およびエンドポイントアドレスを含む URI を使用して、ホストされるサービスにサービスエンドポイントを追加します。 (継承元 ServiceHostBase)
AddServiceEndpoint(Type, Binding, String, Uri)	指定したコントラクト、バインディング、エンドポイントアドレス、サービスがリッスンする URI を使用して、ホストされるサービスにサービスエンドポイントを追加します。
AddServiceEndpoint(Type, Binding, String)	指定したコントラクト、バインディング、およびエンドポイントアドレスを使用して、ホストされているサービスにサービスエンドポイントを追加します。
AddServiceEndpoint(Type, Binding, Uri, Uri)	指定したコントラクト、バインディング、エンドポイントアドレスを含む URI、サービスがリッスンする URI を使用して、ホストされるサービスにサービスエンドポイントを追加します。
AddServiceEndpoint(Type, Binding, Uri)	指定したコントラクト、バインディング、およびエンドポイントアドレスを含む URI を使用して、ホストされるサービスにサービスエンドポイントを追加します。
ApplyConfiguration()	構成ファイルからサービスの説明を読み込み、構築中のランタイムに適用します。
ApplyConfiguration()	構成ファイルからサービス記述情報を読み込み、構築中のランタイムに適用します。 (継承元 ServiceHostBase)
BeginClose(AsyncCallback, Object)	通信オブジェクトを閉じる非同期操作を開始します。 (継承元 CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	指定したタイムアウトで通信オブジェクトを閉じる非同期操作を開始します。 (継承元 CommunicationObject)
BeginOpen(AsyncCallback, Object)	通信オブジェクトを開く非同期操作を開始します。 (継承元 CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	指定した時間内に通信オブジェクトを開く非同期操作を開始します。 (継承元 CommunicationObject)
Close()	通信オブジェクトを現在の状態から閉じた状態に遷移させます。 (継承元 CommunicationObject)
Close(TimeSpan)	指定した時間内に、通信オブジェクトを現在の状態から閉じた状態に遷移させます。 (継承元 CommunicationObject)
CreateDescription(IDictionary<String,ContractDescription>)	ホストされているサービスの説明を作成します。
EndClose(IAsyncResult)	通信オブジェクトを閉じる非同期操作を完了します。 (継承元 CommunicationObject)
EndOpen(IAsyncResult)	通信オブジェクトを開く非同期操作を完了します。 (継承元 CommunicationObject)
Equals(Object)	指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
Fault()	通信オブジェクトを現在の状態から障害状態に遷移させます。 (継承元 CommunicationObject)
GetCommunicationObjectType()	通信オブジェクトの種類を取得します。 (継承元 CommunicationObject)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
IncrementManualFlowControlLimit(Int32)	ホストされるサービスに対するメッセージのフローレートの制限を、指定した増分で増やします。 (継承元 ServiceHostBase)
InitializeDescription(Object, UriSchemeKeyedCollection)	インスタンスと指定したベースアドレスに基づいてホストされるサービスの説明を初期化します。
InitializeDescription(Type, UriSchemeKeyedCollection)	型と指定したベースアドレスに基づいて、ホストされるサービスの説明を初期化します。
InitializeDescription(UriSchemeKeyedCollection)	コントラクトとサービスの説明を使用して、サービスホストを作成して初期化します。 (継承元 ServiceHostBase)
InitializeRuntime()	サービスホストのランタイムを初期化します。 (継承元 ServiceHostBase)
LoadConfigurationSection(ServiceElement)	ホストされるサービスの構成ファイルからサービス要素を読み込みます。 (継承元 ServiceHostBase)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
OnAbort()	サービスを中止します。 (継承元 ServiceHostBase)
OnBeginClose(TimeSpan, AsyncCallback, Object)	サービスホストの終了時に呼び出された非同期操作を開始します。 (継承元 ServiceHostBase)
OnBeginOpen(TimeSpan, AsyncCallback, Object)	サービスホストを開くときに呼び出される非同期操作を開始します。 (継承元 ServiceHostBase)
OnClose(TimeSpan)	チャネルディスパッチャー、関連するインスタンスコンテキスト、リスナーなど、ホストされているサービスを閉じます。 (継承元 ServiceHostBase)
OnClosed()	サービスホストが閉じられたときにホストされている破棄可能なサービスを破棄します。
OnClosing()	通信オブジェクトの終了状態への遷移中に呼び出されます。 (継承元 CommunicationObject)
OnEndClose(IAsyncResult)	サービスホストの終了時に呼び出された非同期操作を完了します。 (継承元 ServiceHostBase)
OnEndOpen(IAsyncResult)	サービスホストを開くときに呼び出された非同期操作を完了します。 (継承元 ServiceHostBase)
OnFaulted()	同期障害操作の呼び出しにより、通信オブジェクトが障害状態に遷移した後に、処理を挿入します。 (継承元 CommunicationObject)
OnOpen(TimeSpan)	チャネルディスパッチャーを開きます。 (継承元 ServiceHostBase)
OnOpened()	ホステッドサービスのサービス資格情報、サービス認証、および承認動作を取得します。 (継承元 ServiceHostBase)
OnOpening()	通信オブジェクトの開始状態への遷移中に呼び出されます。 (継承元 CommunicationObject)
Open()	通信オブジェクトが作成された状態から開かれた状態に遷移します。 (継承元 CommunicationObject)
Open(TimeSpan)	指定した時間内に、通信オブジェクトが作成された状態から開かれた状態に遷移します。 (継承元 CommunicationObject)
ReleasePerformanceCounters()	ホストされるサービスのサービスおよびチャネルディスパッチャーのパフォーマンスカウンターを解放します。 (継承元 ServiceHostBase)
SetEndpointAddress(ServiceEndpoint, String)	指定したエンドポイントのエンドポイントアドレスを、指定したアドレスに設定します。 (継承元 ServiceHostBase)
ThrowIfDisposed()	通信オブジェクトが破棄された場合に例外をスローします。 (継承元 CommunicationObject)
ThrowIfDisposedOrImmutable()	State プロパティがCreated状態に設定されていない通信オブジェクトの場合は、例外をスローします。 (継承元 CommunicationObject)
ThrowIfDisposedOrNotOpen()	通信オブジェクトが Opened 状態でない場合は、例外をスローします。 (継承元 CommunicationObject)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

イベント

名前	説明
Closed	通信オブジェクトが閉じた状態に遷移したときに発生します。 (継承元 CommunicationObject)
Closing	通信オブジェクトが終了状態に遷移したときに発生します。 (継承元 CommunicationObject)
Faulted	通信オブジェクトが障害状態に遷移したときに発生します。 (継承元 CommunicationObject)
Opened	通信オブジェクトが開かれた状態に遷移したときに発生します。 (継承元 CommunicationObject)
Opening	通信オブジェクトが開始状態に遷移したときに発生します。 (継承元 CommunicationObject)
UnknownMessageReceived	不明なメッセージを受信したときに発生します。 (継承元 ServiceHostBase)

明示的なインターフェイスの実装

名前	説明
IDisposable.Dispose()	サービスホストを閉じます。 (継承元 ServiceHostBase)

適用対象

フィードバック

このページはお役に立ちましたか?