ServiceHost Classe

Definição

Fornece um host de serviços.Provides a host for services.

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
Derivado

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 de modelo de serviço do Windows Communication Foundation (WCF).Implements the host used by the Windows Communication Foundation (WCF) service model programming model.

Use a ServiceHost classe para configurar e expor um serviço para uso por aplicativos cliente quando você não estiver usando o serviços de informações da Internet (IIS) ou o WAS (serviços de ativação do Windows) para expor um serviço.Use the ServiceHost class to configure and expose a service for use by client applications when you are not using Internet Information Services (IIS) or Windows Activation Services (WAS) to expose a service. O IIS e o was interagem ServiceHost com um objeto em seu nome.Both IIS and WAS interact with a ServiceHost object on your behalf.

Para expor um serviço para uso pelos chamadores, o WCF requer uma descrição de serviço completa (representada ServiceDescription pela classe).To expose a service for use by callers, WCF requires a complete service description (represented by the ServiceDescription class). A ServiceHost classe cria um ServiceDescription do tipo de serviço e informações de configuração e, em seguida, usa ChannelDispatcher essa descrição para criar objetos para cada ponto de extremidade na descrição.The ServiceHost class creates a ServiceDescription from the service type and configuration information and then uses that description to create ChannelDispatcher objects for each endpoint in the description.

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.Use a ServiceHost object to load a service, configure endpoints, apply security settings, and start listeners to handle incoming requests.

Construtores

ServiceHost()

Inicializa uma nova instância da classe ServiceHost.Initializes a new instance of the ServiceHost class.

ServiceHost(Object, Uri[])

Inicializa uma nova instância da classe ServiceHost com a instância do serviço e seus endereços base especificados.Initializes a new instance of the ServiceHost class with the instance of the service and its base addresses specified.

ServiceHost(Type, Uri[])

Inicializa uma nova instância da classe ServiceHost com o tipo de serviço e seus endereços base especificados.Initializes a new instance of the ServiceHost class with the type of service and its base addresses specified.

Propriedades

Authentication

Obtém o comportamento de autenticação do serviço.Gets the service authentication behavior.

(Herdado de ServiceHostBase)
Authorization

Obtém o comportamento de autorização para o serviço hospedado.Gets the authorization behavior for the service hosted.

(Herdado de ServiceHostBase)
BaseAddresses

Obtém os endereços básicos usados pelo serviço hospedado.Gets the base addresses used by the hosted service.

(Herdado de ServiceHostBase)
ChannelDispatchers

Obtém a coleção de dispatchers de canal usada pelo host de serviço.Gets the collection of channel dispatchers used by the service host.

(Herdado de ServiceHostBase)
CloseTimeout

Obtém ou define o intervalo de tempo permitido para o host de serviço fechar.Gets or sets the interval of time allowed for the service host to close.

(Herdado de ServiceHostBase)
Credentials

Obtém a credencial para o serviço hospedado.Gets the credential for the service hosted.

(Herdado de ServiceHostBase)
DefaultCloseTimeout

Obtém o intervalo de tempo padrão permitido para o fechamento do host de serviço.Gets the default interval of time allowed for the service host to close.

(Herdado de ServiceHostBase)
DefaultOpenTimeout

Obtém o intervalo de tempo padrão permitido para a abertura do host de serviço.Gets the default interval of time allowed for the service host to open.

(Herdado de ServiceHostBase)
Description

Obtém a descrição do serviço hospedado.Gets the description of the service hosted.

(Herdado de ServiceHostBase)
Extensions

Obtém as extensões para o host de serviço atual especificado.Gets the extensions for the current specified service host.

(Herdado de ServiceHostBase)
ImplementedContracts

Recupera os contratos implementados pelo serviço hospedado.Retrieves the contracts implemented by the service hosted.

(Herdado de ServiceHostBase)
IsDisposed

Obtém um valor que indica se o objeto de comunicação foi descartado.Gets a value that indicates whether the communication object has been disposed.

(Herdado de CommunicationObject)
ManualFlowControlLimit

Obtém ou define o limite de controle de fluxo para mensagens recebidas pelo serviço hospedado.Gets or sets the flow control limit for messages received by the service hosted.

(Herdado de ServiceHostBase)
OpenTimeout

Obtém ou define um intervalo de tempo permitido para o host de serviço abrir.Gets or sets the interval of time allowed for the service host to open.

(Herdado de ServiceHostBase)
SingletonInstance

Obtém a instância singleton do serviço hospedado.Gets the singleton instance of the hosted service.

State

Obtém um valor que indica o estado atual do objeto de comunicação.Gets a value that indicates the current state of the communication object.

(Herdado de CommunicationObject)
ThisLock

Obtém o bloqueio mutuamente exclusivo que protege a instância da classe durante uma transição de estado.Gets the mutually exclusive lock that protects the class instance during a state transition.

(Herdado de CommunicationObject)

Métodos

Abort()

Faz com que um objeto de comunicação faça a transição imediata do estado atual para o estado de fechamento.Causes a communication object to transition immediately from its current state into the closing state.

(Herdado de CommunicationObject)
AddBaseAddress(Uri)

Adiciona um endereço básico ao host de serviço.Adds a base address to the service host.

(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.Adds service endpoints for all base addresses in each contract found in the service host with the default binding.

(Herdado de ServiceHostBase)
AddServiceEndpoint(ServiceEndpoint)

Adiciona o ponto de extremidade de serviço especificado para o serviço hospedado.Adds the specified service endpoint to the hosted service.

(Herdado de ServiceHostBase)
AddServiceEndpoint(String, Binding, String)

Adiciona um ponto de extremidade de serviço ao serviço hospedado com um contrato, uma associação e um endereço do ponto de extremidade especificados.Adds a service endpoint to the hosted service with a specified contract, binding, and endpoint address.

(Herdado de ServiceHostBase)
AddServiceEndpoint(String, Binding, String, Uri)

Adiciona um ponto de extremidade de serviço ao serviço hospedado com um contrato especificado, associação, endereço do ponto de extremidade e URI que contém o endereço no qual ele escuta.Adds a service endpoint to the hosted service with a specified contract, binding, endpoint address and URI that contains the address at which it listens.

(Herdado de ServiceHostBase)
AddServiceEndpoint(String, Binding, Uri)

Adiciona um ponto de extremidade de serviço ao serviço hospedado com um contrato, uma associação e um URI especificados que contêm o endereço do ponto de extremidade.Adds a service endpoint to the hosted service with a specified contract, binding, and a URI that contains the endpoint address.

(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 os endereços do ponto de extremidade e de escuta.Adds a service endpoint to the hosted service with the specified contract, binding, and URIs that contain the endpoint and listening addresses.

(Herdado de ServiceHostBase)
AddServiceEndpoint(Type, Binding, String)

Adiciona um ponto de extremidade de serviço ao serviço hospedado com um contrato, uma associação e um endereço do ponto de extremidade especificados.Adds a service endpoint to the hosted service with a specified contract, binding, and endpoint address.

AddServiceEndpoint(Type, Binding, String, Uri)

Adiciona um ponto de extremidade de serviço ao serviço hospedado com um contrato, uma associação, um endereço do ponto de extremidade especificados e um URI no qual o serviço escuta.Adds a service endpoint to the hosted service with a specified contract, binding, an endpoint address, and a URI on which the service listens.

AddServiceEndpoint(Type, Binding, Uri)

Adiciona um ponto de extremidade de serviço ao serviço hospedado com um contrato, uma associação e um URI especificados que contêm o endereço do ponto de extremidade.Adds a service endpoint to the hosted service with a specified contract, binding, and URI that contains the endpoint address.

AddServiceEndpoint(Type, Binding, Uri, Uri)

Adiciona um ponto de extremidade de serviço ao serviço hospedado com uma associação, um URI no qual o serviço escuta, um URI que contém o endereço do ponto de extremidade e um contrato especificados.Adds a service endpoint to the hosted service with a specified contract, binding, a URI that contains the endpoint address, and a URI on which the service listens.

ApplyConfiguration()

Carrega a descrição de serviço do arquivo de configuração e aplica-a ao tempo de execução que está sendo construído.Loads the service description from the configuration file and applies it to the runtime being constructed.

BeginClose(AsyncCallback, Object)

Inicia uma operação assíncrona para fechar um objeto de comunicação.Begins an asynchronous operation to close a communication object.

(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.Begins an asynchronous operation to close a communication object with a specified timeout.

(Herdado de CommunicationObject)
BeginOpen(AsyncCallback, Object)

Inicia uma operação assíncrona para abrir um objeto de comunicação.Begins an asynchronous operation to open a communication object.

(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.Begins an asynchronous operation to open a communication object within a specified interval of time.

(Herdado de CommunicationObject)
Close()

Faz com que um objeto de comunicação faça a transição do estado atual para o estado fechado.Causes a communication object to transition from its current state into the closed state.

(Herdado de CommunicationObject)
Close(TimeSpan)

Faz com que um objeto de comunicação faça a transição do estado atual para o estado fechado dentro de um intervalo de tempo especificado.Causes a communication object to transition from its current state into the closed state within a specified interval of time.

(Herdado de CommunicationObject)
CreateDescription(IDictionary<String,ContractDescription>)

Cria uma descrição do serviço hospedado.Creates a description of the service hosted.

EndClose(IAsyncResult)

Conclui uma operação assíncrona para fechar um objeto de comunicação.Completes an asynchronous operation to close a communication object.

(Herdado de CommunicationObject)
EndOpen(IAsyncResult)

Conclui uma operação assíncrona para abrir um objeto de comunicação.Completes an asynchronous operation to open a communication object.

(Herdado de CommunicationObject)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
Fault()

Faz com que um objeto de comunicação faça a transição do estado atual para o estado com falha.Causes a communication object to transition from its current state into the faulted state.

(Herdado de CommunicationObject)
GetCommunicationObjectType()

Obtém o tipo de objeto de comunicação.Gets the type of communication object.

(Herdado de CommunicationObject)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
IncrementManualFlowControlLimit(Int32)

Aumenta o limite da taxa de fluxo de mensagens para o serviço hospedado por um incremento especificado.Increases the limit on the flow rate of messages to the hosted service by a specified increment.

(Herdado de ServiceHostBase)
InitializeDescription(Object, UriSchemeKeyedCollection)

Inicializa uma descrição do serviço hospedado com base em sua instância e endereços básicos especificados.Initializes a description of the service hosted based on its instance and specified base addresses.

InitializeDescription(Type, UriSchemeKeyedCollection)

Inicializa uma descrição do serviço hospedado com base em seu tipo e endereços básicos especificados.Initializes a description of the service hosted based on its type and specified base addresses.

InitializeDescription(UriSchemeKeyedCollection)

Cria e inicializa o host de serviço com as descrições de contrato e serviço.Creates and initializes the service host with the contract and service descriptions.

(Herdado de ServiceHostBase)
InitializeRuntime()

Inicializa o tempo de execução para o host de serviço.Initializes the runtime for the service host.

(Herdado de ServiceHostBase)
LoadConfigurationSection(ServiceElement)

Carrega o elemento de serviço do arquivo de configuração do serviço hospedado.Loads the service element from the configuration file of the hosted service.

(Herdado de ServiceHostBase)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
OnAbort()

Anula o serviço.Aborts the service.

(Herdado de ServiceHostBase)
OnBeginClose(TimeSpan, AsyncCallback, Object)

Inicia uma operação assíncrona invocada no fechamento do host de serviço.Begins an asynchronous operation invoked on the close of the service host.

(Herdado de ServiceHostBase)
OnBeginOpen(TimeSpan, AsyncCallback, Object)

Inicia uma operação assíncrona invocada na abertura do host de serviço.Begins an asynchronous operation invoked on the opening of the service host.

(Herdado de ServiceHostBase)
OnClose(TimeSpan)

Fecha o serviço hospedado, incluindo seus dispatchers de canal e ouvintes e contextos de instância associados.Closes down the hosted service, including their channel dispatchers and associated instance contexts and listeners.

(Herdado de ServiceHostBase)
OnClosed()

Descarta serviços descartáveis sendo hospedados quando o host de serviço é fechado.Disposes of disposable services that are being hosted when the service host is closed.

OnClosing()

Chamada durante a transição de um objeto de comunicação para o estado de fechamento.Invoked during the transition of a communication object into the closing state.

(Herdado de CommunicationObject)
OnEndClose(IAsyncResult)

Conclui uma operação assíncrona invocada no fechamento do host de serviço.Completes an asynchronous operation invoked on the closing of the service host.

(Herdado de ServiceHostBase)
OnEndOpen(IAsyncResult)

Conclui uma operação assíncrona invocada na abertura do host de serviço.Completes an asynchronous operation invoked on the opening of the service host.

(Herdado de ServiceHostBase)
OnFaulted()

Insere o processamento em um objeto de comunicação depois que ela fez a transição para o estado de fechamento devido à invocação de uma operação fault síncrona.Inserts processing on a communication object after it transitions to the faulted state due to the invocation of a synchronous fault operation.

(Herdado de CommunicationObject)
OnOpen(TimeSpan)

Abre os dispatchers de canal.Opens the channel dispatchers.

(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.Gets the service credentials,service authentication and authorization behavior for the hosted service.

(Herdado de ServiceHostBase)
OnOpening()

Chamada durante a transição de um objeto de comunicação no estado de abertura.Invoked during the transition of a communication object into the opening state.

(Herdado de CommunicationObject)
Open()

Faz com que um objeto de comunicação faça a transição do estado criado para o estado aberto.Causes a communication object to transition from the created state into the opened state.

(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 em um intervalo de tempo especificado.Causes a communication object to transition from the created state into the opened state within a specified interval of time.

(Herdado de CommunicationObject)
ReleasePerformanceCounters()

Libera os contadores de desempenho do dispatcher de serviço e canal para o serviço hospedado.Releases the service and channel dispatcher performance counters for the hosted service.

(Herdado de ServiceHostBase)
SetEndpointAddress(ServiceEndpoint, String)

Define o endereço do ponto de extremidade especificado como o endereço especificado.Sets the endpoint address of the specified endpoint to the specified address.

(Herdado de ServiceHostBase)
ThrowIfDisposed()

Gera uma exceção se o objeto de comunicação é descartado.Throws an exception if the communication object is disposed.

(Herdado de CommunicationObject)
ThrowIfDisposedOrImmutable()

Gera uma exceção se o objeto de comunicação da propriedade State não estiver definido para o estado Created.Throws an exception if the communication object the State property is not set to the Created state.

(Herdado de CommunicationObject)
ThrowIfDisposedOrNotOpen()

Gera uma exceção se o objeto de comunicação não estiver no estado Opened.Throws an exception if the communication object is not in the Opened state.

(Herdado de CommunicationObject)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Eventos

Closed

Ocorre quando um objeto de comunicação entra no estado fechado.Occurs when a communication object transitions into the closed state.

(Herdado de CommunicationObject)
Closing

Ocorre quando um objeto de comunicação faz a transição para o estado fechado.Occurs when a communication object transitions into the closing state.

(Herdado de CommunicationObject)
Faulted

Ocorre quando um objeto de comunicação entra em um estado de falha.Occurs when a communication object transitions into the faulted state.

(Herdado de CommunicationObject)
Opened

Ocorre quando um objeto de comunicação faz a transição para o estado aberto.Occurs when a communication object transitions into the opened state.

(Herdado de CommunicationObject)
Opening

Ocorre quando um objeto de comunicação faz a transição para o estado de abertura.Occurs when a communication object transitions into the opening state.

(Herdado de CommunicationObject)
UnknownMessageReceived

Ocorre quando uma mensagem desconhecida é recebida.Occurs when an unknown message is received.

(Herdado de ServiceHostBase)

Implantações explícitas de interface

IDisposable.Dispose()

Fecha o host de serviço.Closes the service host.

(Herdado de ServiceHostBase)

Aplica-se a