ServiceHost 클래스

정의

네임스페이스:

System.ServiceModel

어셈블리:

System.ServiceModel.dll

서비스에 대한 호스트를 제공합니다.

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

설명

WCF(Windows Communication Foundation) 서비스 모델 프로그래밍 모델에서 사용하는 호스트를 구현합니다.

서비스를 노출하는 데 IIS(인터넷 정보 서비스) 또는 WAS(Windows Activation Services)를 사용하지 않는 경우 클라이언트 애플리케이션에서 사용할 수 있도록 서비스를 구성하고 노출하려면 ServiceHost 클래스를 사용합니다. 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	호스팅된 서비스의 singleton 인스턴스를 가져옵니다.
State	통신 개체의 현재 상태를 나타내는 값을 가져옵니다. (다음에서 상속됨 CommunicationObject)
ThisLock	상태 전환 중에 클래스 인스턴스를 보호하는 상호 배타적인 전용 잠금을 가져옵니다. (다음에서 상속됨 CommunicationObject)

메서드

Abort()	통신 개체가 현재 상태에서 Closing 상태로 즉시 전환되도록 합니다. (다음에서 상속됨 CommunicationObject)
AddBaseAddress(Uri)	서비스 호스트에 기본 주소를 추가합니다. (다음에서 상속됨 ServiceHostBase)
AddDefaultEndpoints()	기본 바인딩을 사용하는 서비스 호스트에 있는 각 계약에서 모든 기본 주소에 대한 서비스 엔드포인트를 추가합니다. (다음에서 상속됨 ServiceHostBase)
AddServiceEndpoint(ServiceEndpoint)	지정된 서비스 엔드포인트를 호스팅된 서비스에 추가합니다. (다음에서 상속됨 ServiceHostBase)
AddServiceEndpoint(String, Binding, String)	지정된 계약, 바인딩, 엔드포인트 주소를 사용하여 서비스 엔드포인트를 호스팅된 서비스에 추가합니다. (다음에서 상속됨 ServiceHostBase)
AddServiceEndpoint(String, Binding, String, Uri)	지정된 계약, 바인딩, 엔드포인트 주소 및 수신 주소가 포함된 URI를 사용하여 서비스 엔드포인트를 호스팅된 서비스에 추가합니다. (다음에서 상속됨 ServiceHostBase)
AddServiceEndpoint(String, Binding, Uri)	지정된 계약, 바인딩 및 엔드포인트 주소가 포함된 URI를 사용하여 서비스 엔드포인트를 호스팅된 서비스에 추가합니다. (다음에서 상속됨 ServiceHostBase)
AddServiceEndpoint(String, Binding, Uri, Uri)	지정된 계약, 바인딩, 엔드포인트와 수신 주소가 포함된 URI를 사용하여 서비스 엔드포인트를 호스팅된 서비스에 추가합니다. (다음에서 상속됨 ServiceHostBase)
AddServiceEndpoint(Type, Binding, String)	지정된 계약, 바인딩, 엔드포인트 주소를 사용하여 서비스 엔드포인트를 호스팅된 서비스에 추가합니다.
AddServiceEndpoint(Type, Binding, String, Uri)	지정된 계약, 바인딩, 엔드포인트 주소 및 서비스가 수신 대기하는 URI를 사용하여 서비스 엔드포인트를 호스팅된 서비스에 추가합니다.
AddServiceEndpoint(Type, Binding, Uri)	지정된 계약, 바인딩 및 엔드포인트 주소가 포함된 URI를 사용하여 서비스 엔드포인트를 호스팅된 서비스에 추가합니다.
AddServiceEndpoint(Type, Binding, Uri, Uri)	지정된 계약, 바인딩, 엔드포인트 주소가 포함된 URI 및 서비스가 수신 대기하는 URI를 사용하여 서비스 엔드포인트를 호스팅된 서비스에 추가합니다.
ApplyConfiguration()	구성 파일에서 서비스 설명을 로드하고 이 설명을 생성 중인 런타임에 적용합니다.
BeginClose(AsyncCallback, Object)	통신 개체를 닫기 위한 비동기 작업을 시작합니다. (다음에서 상속됨 CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	지정된 제한 시간 내에서 통신 개체를 닫기 위한 비동기 작업을 시작합니다. (다음에서 상속됨 CommunicationObject)
BeginOpen(AsyncCallback, Object)	통신 개체를 열기 위한 비동기 작업을 시작합니다. (다음에서 상속됨 CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	지정된 시간 간격 내에서 통신 개체를 열기 위한 비동기 작업을 시작합니다. (다음에서 상속됨 CommunicationObject)
Close()	통신 개체가 현재 상태에서 Closed 상태로 전환되도록 합니다. (다음에서 상속됨 CommunicationObject)
Close(TimeSpan)	통신 개체가 지정된 시간 간격 내에 현재 상태에서 Closed 상태로 전환되도록 합니다. (다음에서 상속됨 CommunicationObject)
CreateDescription(IDictionary<String,ContractDescription>)	호스팅된 서비스에 대한 설명을 만듭니다.
EndClose(IAsyncResult)	통신 개체를 닫기 위한 비동기 작업을 완료합니다. (다음에서 상속됨 CommunicationObject)
EndOpen(IAsyncResult)	통신 개체를 열기 위한 비동기 작업을 완료합니다. (다음에서 상속됨 CommunicationObject)
Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
Fault()	통신 개체가 현재 상태에서 Faulted 상태로 전환되도록 합니다. (다음에서 상속됨 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)
OnCloseAsync(TimeSpan)	서비스에 대한 호스트를 제공합니다. (다음에서 상속됨 CommunicationObject)
OnClosed()	서비스 호스트가 닫히면 호스팅 중인 삭제 가능한 서비스를 삭제합니다.
OnClosing()	통신 개체가 Closing 상태로 전환되는 중에 호출됩니다. (다음에서 상속됨 CommunicationObject)
OnEndClose(IAsyncResult)	서비스 호스트를 닫았을 때 호출되는 비동기 작업을 완료합니다. (다음에서 상속됨 ServiceHostBase)
OnEndOpen(IAsyncResult)	서비스 호스트를 열었을 때 호출되는 비동기 작업을 완료합니다. (다음에서 상속됨 ServiceHostBase)
OnFaulted()	통신 개체가 동기 오류 작업의 호출로 인해 Faulted 상태로 전환된 후 해당 통신 개체에 대한 처리를 삽입합니다. (다음에서 상속됨 CommunicationObject)
OnOpen(TimeSpan)	채널 디스패처를 엽니다. (다음에서 상속됨 ServiceHostBase)
OnOpenAsync(TimeSpan)	서비스에 대한 호스트를 제공합니다. (다음에서 상속됨 CommunicationObject)
OnOpened()	호스팅된 서비스의 서비스 자격 증명, 서비스 인증 및 서비스 인증 동작을 가져옵니다. (다음에서 상속됨 ServiceHostBase)
OnOpening()	통신 개체가 Opening 상태로 전환되는 중에 호출됩니다. (다음에서 상속됨 CommunicationObject)
Open()	통신 개체가 Created 상태에서 Opened 상태로 전환되도록 합니다. (다음에서 상속됨 CommunicationObject)
Open(TimeSpan)	통신 개체가 지정된 시간 간격 내에 Created 상태에서 Opened 상태로 전환되도록 합니다. (다음에서 상속됨 CommunicationObject)
ReleasePerformanceCounters()	호스팅된 서비스의 서비스 및 채널 디스패처 성능 카운터를 해제합니다. (다음에서 상속됨 ServiceHostBase)
SetEndpointAddress(ServiceEndpoint, String)	지정된 엔드포인트의 엔드포인트 주소를 지정된 주소로 설정합니다. (다음에서 상속됨 ServiceHostBase)
ThrowIfDisposed()	통신 개체가 삭제되면 예외를 throw합니다. (다음에서 상속됨 CommunicationObject)
ThrowIfDisposedOrImmutable()	통신 개체의 State 속성이 Created 상태로 설정되지 않은 경우 예외를 throw합니다. (다음에서 상속됨 CommunicationObject)
ThrowIfDisposedOrNotOpen()	통신 개체가 Opened 상태가 아니면 예외를 throw합니다. (다음에서 상속됨 CommunicationObject)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

이벤트

Closed	통신 개체가 Closed 상태로 전환될 때 발생합니다. (다음에서 상속됨 CommunicationObject)
Closing	통신 개체가 Closing 상태로 전환될 때 발생합니다. (다음에서 상속됨 CommunicationObject)
Faulted	통신 개체가 Faulted 상태로 전환될 때 발생합니다. (다음에서 상속됨 CommunicationObject)
Opened	통신 개체가 Opened 상태로 전환될 때 발생합니다. (다음에서 상속됨 CommunicationObject)
Opening	통신 개체가 Opening 상태로 전환될 때 발생합니다. (다음에서 상속됨 CommunicationObject)
UnknownMessageReceived	알 수 없는 메시지를 수신할 때 발생합니다. (다음에서 상속됨 ServiceHostBase)

명시적 인터페이스 구현

IDisposable.Dispose()

서비스 호스트를 닫습니다. (다음에서 상속됨 ServiceHostBase)