ServiceHost Classe

Definição

Namespace:: System.ServiceModel

Assembly:: System.ServiceModel.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece um host para serviços.

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

public class ServiceHost : System.ServiceModel.ServiceHostBase

type ServiceHost = class
    inherit ServiceHostBase

Public Class ServiceHost
Inherits ServiceHostBase

Herança: Object

CommunicationObject

ServiceHostBase
ServiceHost

Derivado: System.ServiceModel.Security.WSTrustServiceHost

System.ServiceModel.Web.WebServiceHost

Exemplos

// 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

Comentários

Implementa o host usado pelo modelo de programação do modelo de serviço Windows Communication Foundation (WCF).

Use a classe ServiceHost para configurar e expor um serviço para uso por aplicativos cliente quando você não estiver usando o IIS (Serviços de Informações da Internet) ou os Serviços de Ativação Windows (WAS) para expor um serviço. O IIS e o WAS interagem com um ServiceHost objeto em seu nome.

Para expor um serviço para uso por chamadores, o WCF requer uma descrição de serviço completa (representada pela ServiceDescription classe). A ServiceHost classe cria um ServiceDescription tipo de serviço e informações de configuração e, em seguida, usa essa descrição para criar ChannelDispatcher objetos para cada ponto de extremidade na descrição.

Use um ServiceHost objeto para carregar um serviço, configurar pontos de extremidade, aplicar configurações de segurança e iniciar ouvintes para lidar com solicitações de entrada.

Construtores

Nome	Description
ServiceHost()	Inicializa uma nova instância da classe ServiceHost.
ServiceHost(Object, Uri[])	Inicializa uma nova instância da ServiceHost classe com a instância do serviço e seus endereços base especificados.
ServiceHost(Type, Uri[])	Inicializa uma nova instância da ServiceHost classe com o tipo de serviço e seus endereços base especificados.

Propriedades

Nome	Description
Authentication	Obtém o comportamento de autenticação de serviço. (Herdado de ServiceHostBase)
Authorization	Obtém o comportamento de autorização para o serviço hospedado. (Herdado de ServiceHostBase)
BaseAddresses	Obtém os endereços base usados pelo serviço hospedado. (Herdado de ServiceHostBase)
ChannelDispatchers	Obtém a coleção de dispatchers de canal usada pelo host de serviço. (Herdado de ServiceHostBase)
CloseTimeout	Obtém ou define o intervalo de tempo permitido para o host de serviço fechar. (Herdado de ServiceHostBase)
Credentials	Obtém a credencial do serviço hospedado. (Herdado de ServiceHostBase)
DefaultCloseTimeout	Obtém o intervalo de tempo padrão permitido para o host de serviço fechar. (Herdado de ServiceHostBase)
DefaultOpenTimeout	Obtém o intervalo de tempo padrão permitido para o host de serviço abrir. (Herdado de ServiceHostBase)
Description	Obtém a descrição do serviço hospedado. (Herdado de ServiceHostBase)
Extensions	Obtém as extensões do host de serviço especificado atual. (Herdado de ServiceHostBase)
ImplementedContracts	Recupera os contratos implementados pelo serviço hospedado. (Herdado de ServiceHostBase)
IsDisposed	Obtém um valor que indica se o objeto de comunicação foi descartado. (Herdado de CommunicationObject)
ManualFlowControlLimit	Obtém ou define o limite de controle de fluxo para mensagens recebidas pelo serviço hospedado. (Herdado de ServiceHostBase)
OpenTimeout	Obtém ou define o intervalo de tempo permitido para o host de serviço abrir. (Herdado de ServiceHostBase)
SingletonInstance	Obtém a instância singleton do serviço hospedado.
State	Obtém um valor que indica o estado atual do objeto de comunicação. (Herdado de CommunicationObject)
ThisLock	Obtém o bloqueio mutuamente exclusivo que protege a instância de classe durante uma transição de estado. (Herdado de CommunicationObject)

Métodos

Nome	Description
Abort()	Faz com que um objeto de comunicação faça a transição imediatamente de seu estado atual para o estado de fechamento. (Herdado de CommunicationObject)
AddBaseAddress(Uri)	Adiciona um endereço base ao host de serviço. (Herdado de ServiceHostBase)
AddDefaultEndpoints()	Adiciona pontos de extremidade de serviço para todos os endereços base em cada contrato encontrado no host de serviço com a associação padrão. (Herdado de ServiceHostBase)
AddServiceEndpoint(ServiceEndpoint)	Adiciona o ponto de extremidade de serviço especificado ao serviço hospedado. (Herdado de ServiceHostBase)
AddServiceEndpoint(String, Binding, String, Uri)	Adiciona um ponto de extremidade de serviço ao serviço hospedado com um contrato, associação, endereço de ponto de extremidade e URI especificados que contém o endereço no qual ele escuta. (Herdado de ServiceHostBase)
AddServiceEndpoint(String, Binding, String)	Adiciona um ponto de extremidade de serviço ao serviço hospedado com um contrato, associação e endereço de ponto de extremidade especificados. (Herdado de ServiceHostBase)
AddServiceEndpoint(String, Binding, Uri, Uri)	Adiciona um ponto de extremidade de serviço ao serviço hospedado com o contrato, a associação e os URIs especificados que contêm o ponto de extremidade e os endereços de escuta. (Herdado de ServiceHostBase)
AddServiceEndpoint(String, Binding, Uri)	Adiciona um ponto de extremidade de serviço ao serviço hospedado com um contrato, associação e um URI especificados que contém o endereço do ponto de extremidade. (Herdado de ServiceHostBase)
AddServiceEndpoint(Type, Binding, String, Uri)	Adiciona um ponto de extremidade de serviço ao serviço hospedado com um contrato, associação, um endereço de ponto de extremidade e um URI no qual o serviço escuta.
AddServiceEndpoint(Type, Binding, String)	Adiciona um ponto de extremidade de serviço ao serviço hospedado com um contrato, associação e endereço de ponto de extremidade especificados.
AddServiceEndpoint(Type, Binding, Uri, Uri)	Adiciona um ponto de extremidade de serviço ao serviço hospedado com um contrato, associação, um URI que contém o endereço do ponto de extremidade e um URI no qual o serviço escuta.
AddServiceEndpoint(Type, Binding, Uri)	Adiciona um ponto de extremidade de serviço ao serviço hospedado com um contrato, associação e URI especificados que contém o endereço do ponto de extremidade.
ApplyConfiguration()	Carrega a descrição do serviço do arquivo de configuração e aplica-a ao runtime que está sendo construído.
ApplyConfiguration()	Carrega as informações de descrição do serviço do arquivo de configuração e aplica-as ao runtime que está sendo construído. (Herdado de ServiceHostBase)
BeginClose(AsyncCallback, Object)	Inicia uma operação assíncrona para fechar um objeto de comunicação. (Herdado de CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	Inicia uma operação assíncrona para fechar um objeto de comunicação com um tempo limite especificado. (Herdado de CommunicationObject)
BeginOpen(AsyncCallback, Object)	Inicia uma operação assíncrona para abrir um objeto de comunicação. (Herdado de CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	Inicia uma operação assíncrona para abrir um objeto de comunicação dentro de um intervalo de tempo especificado. (Herdado de CommunicationObject)
Close()	Faz com que um objeto de comunicação faça a transição de seu estado atual para o estado fechado. (Herdado de CommunicationObject)
Close(TimeSpan)	Faz com que um objeto de comunicação faça a transição de seu estado atual para o estado fechado dentro de um intervalo de tempo especificado. (Herdado de CommunicationObject)
CreateDescription(IDictionary<String,ContractDescription>)	Cria uma descrição do serviço hospedado.
EndClose(IAsyncResult)	Conclui uma operação assíncrona para fechar um objeto de comunicação. (Herdado de CommunicationObject)
EndOpen(IAsyncResult)	Conclui uma operação assíncrona para abrir um objeto de comunicação. (Herdado de CommunicationObject)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Fault()	Faz com que um objeto de comunicação faça a transição de seu estado atual para o estado com falha. (Herdado de CommunicationObject)
GetCommunicationObjectType()	Obtém o tipo de objeto de comunicação. (Herdado de CommunicationObject)
GetHashCode()	Serve como a função hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IncrementManualFlowControlLimit(Int32)	Aumenta o limite da taxa de fluxo de mensagens para o serviço hospedado por um incremento especificado. (Herdado de ServiceHostBase)
InitializeDescription(Object, UriSchemeKeyedCollection)	Inicializa uma descrição do serviço hospedado com base em sua instância e endereços base especificados.
InitializeDescription(Type, UriSchemeKeyedCollection)	Inicializa uma descrição do serviço hospedado com base em seu tipo e endereços base especificados.
InitializeDescription(UriSchemeKeyedCollection)	Cria e inicializa o host de serviço com as descrições de contrato e serviço. (Herdado de ServiceHostBase)
InitializeRuntime()	Inicializa o runtime do host de serviço. (Herdado de ServiceHostBase)
LoadConfigurationSection(ServiceElement)	Carrega o elemento de serviço do arquivo de configuração do serviço hospedado. (Herdado de ServiceHostBase)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
OnAbort()	Anula o serviço. (Herdado de ServiceHostBase)
OnBeginClose(TimeSpan, AsyncCallback, Object)	Inicia uma operação assíncrona invocada no fechamento do host de serviço. (Herdado de ServiceHostBase)
OnBeginOpen(TimeSpan, AsyncCallback, Object)	Inicia uma operação assíncrona invocada na abertura do host de serviço. (Herdado de ServiceHostBase)
OnClose(TimeSpan)	Fecha o serviço hospedado, incluindo seus dispatchers de canal e contextos de instância e ouvintes associados. (Herdado de ServiceHostBase)
OnClosed()	Descarta os serviços descartáveis que estão sendo hospedados quando o host do serviço é fechado.
OnClosing()	Invocado durante a transição de um objeto de comunicação para o estado de fechamento. (Herdado de CommunicationObject)
OnEndClose(IAsyncResult)	Conclui uma operação assíncrona invocada no fechamento do host de serviço. (Herdado de ServiceHostBase)
OnEndOpen(IAsyncResult)	Conclui uma operação assíncrona invocada na abertura do host de serviço. (Herdado de ServiceHostBase)
OnFaulted()	Insere o processamento em um objeto de comunicação depois que ele faz a transição para o estado com falha devido à invocação de uma operação de falha síncrona. (Herdado de CommunicationObject)
OnOpen(TimeSpan)	Abre os dispatchers de canal. (Herdado de ServiceHostBase)
OnOpened()	Obtém as credenciais de serviço, a autenticação de serviço e o comportamento de autorização para o serviço hospedado. (Herdado de ServiceHostBase)
OnOpening()	Invocado durante a transição de um objeto de comunicação para o estado de abertura. (Herdado de CommunicationObject)
Open()	Faz com que um objeto de comunicação faça a transição do estado criado para o estado aberto. (Herdado de CommunicationObject)
Open(TimeSpan)	Faz com que um objeto de comunicação faça a transição do estado criado para o estado aberto dentro de um intervalo de tempo especificado. (Herdado de CommunicationObject)
ReleasePerformanceCounters()	Libera os contadores de desempenho do serviço e do dispatcher de canal para o serviço hospedado. (Herdado de ServiceHostBase)
SetEndpointAddress(ServiceEndpoint, String)	Define o endereço do ponto de extremidade do ponto de extremidade especificado como o endereço especificado. (Herdado de ServiceHostBase)
ThrowIfDisposed()	Gerará uma exceção se o objeto de comunicação for descartado. (Herdado de CommunicationObject)
ThrowIfDisposedOrImmutable()	Gerará uma exceção se o objeto de comunicação a State propriedade não estiver definida como o Created estado. (Herdado de CommunicationObject)
ThrowIfDisposedOrNotOpen()	Gera uma exceção se o objeto de comunicação não estiver no Opened estado. (Herdado de CommunicationObject)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Eventos

Nome	Description
Closed	Ocorre quando um objeto de comunicação faz a transição para o estado fechado. (Herdado de CommunicationObject)
Closing	Ocorre quando um objeto de comunicação faz a transição para o estado de fechamento. (Herdado de CommunicationObject)
Faulted	Ocorre quando um objeto de comunicação faz a transição para o estado com falha. (Herdado de CommunicationObject)
Opened	Ocorre quando um objeto de comunicação faz a transição para o estado aberto. (Herdado de CommunicationObject)
Opening	Ocorre quando um objeto de comunicação faz a transição para o estado de abertura. (Herdado de CommunicationObject)
UnknownMessageReceived	Ocorre quando uma mensagem desconhecida é recebida. (Herdado de ServiceHostBase)

Implantações explícitas de interface

Nome	Description
IDisposable.Dispose()	Fecha o host de serviço. (Herdado de ServiceHostBase)

Aplica-se a

Comentários

Esta página foi útil?