ServiceHost Clase

Definición

Proporciona un host para los servicios.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
Herencia
Derivado

Ejemplos

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

Comentarios

Implementa el host utilizado por el modelo de programación del modelo de servicio de Windows Communication Foundation (WCF).Implements the host used by the Windows Communication Foundation (WCF) service model programming model.

Utilice la clase ServiceHost para configurar y exponer un servicio para que lo usen las aplicaciones cliente cuando no está utilizando IIS (Internet Information Services) o WAS (Servicios de activación de Windows) para exponer un servicio.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. Tanto IIS como WAS interactúan con un objeto ServiceHost en su nombre.Both IIS and WAS interact with a ServiceHost object on your behalf.

Para exponer un servicio para que lo usen los autores de las llamadas, WCF requiere una descripción de servicio ServiceDescription completa (representada por la clase).To expose a service for use by callers, WCF requires a complete service description (represented by the ServiceDescription class). La clase ServiceHost crea un ServiceDescription a partir del tipo de servicio e información de configuración y, a continuación, utiliza esa descripción para crear los objetos ChannelDispatcher para cada punto de conexión en la descripción.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.

Utilice un objeto ServiceHost para cargar un servicio, configurar puntos de conexión, aplicar la configuración de seguridad e iniciar los agentes de escucha para administrar las solicitudes entrantes.Use a ServiceHost object to load a service, configure endpoints, apply security settings, and start listeners to handle incoming requests.

Constructores

ServiceHost()

Inicializa una nueva instancia de la clase ServiceHost.Initializes a new instance of the ServiceHost class.

ServiceHost(Object, Uri[])

Inicializa una nueva instancia de la clase ServiceHost con la instancia del servicio y las direcciones base especificadas.Initializes a new instance of the ServiceHost class with the instance of the service and its base addresses specified.

ServiceHost(Type, Uri[])

Inicializa una nueva instancia de la clase ServiceHost con el tipo de servicio y las direcciones base especificadas.Initializes a new instance of the ServiceHost class with the type of service and its base addresses specified.

Propiedades

Authentication

Obtiene el comportamiento de autenticación de servicio.Gets the service authentication behavior.

(Heredado de ServiceHostBase)
Authorization

Obtiene el comportamiento de la autorización para el servicio hospedado.Gets the authorization behavior for the service hosted.

(Heredado de ServiceHostBase)
BaseAddresses

Obtiene las direcciones base utilizadas por el servicio hospedado.Gets the base addresses used by the hosted service.

(Heredado de ServiceHostBase)
ChannelDispatchers

Obtiene la colección de distribuidores del canal utilizados por el host del servicio.Gets the collection of channel dispatchers used by the service host.

(Heredado de ServiceHostBase)
CloseTimeout

Obtiene o establece el intervalo de tiempo permitido para que el host del servicio se cierre.Gets or sets the interval of time allowed for the service host to close.

(Heredado de ServiceHostBase)
Credentials

Obtiene la credencial para el servicio hospedado.Gets the credential for the service hosted.

(Heredado de ServiceHostBase)
DefaultCloseTimeout

Obtiene o establece el intervalo de tiempo predeterminado permitido para que el host del servicio se cierre.Gets the default interval of time allowed for the service host to close.

(Heredado de ServiceHostBase)
DefaultOpenTimeout

Obtiene el intervalo de tiempo predeterminado permitido para que el host del servicio se abra.Gets the default interval of time allowed for the service host to open.

(Heredado de ServiceHostBase)
Description

Obtiene la descripción del servicio hospedado.Gets the description of the service hosted.

(Heredado de ServiceHostBase)
Extensions

Obtiene las extensiones para el host del servicio actual especificado.Gets the extensions for the current specified service host.

(Heredado de ServiceHostBase)
ImplementedContracts

Recupera los contratos implementados por el servicio hospedado.Retrieves the contracts implemented by the service hosted.

(Heredado de ServiceHostBase)
IsDisposed

Obtiene un valor que indica si el objeto de comunicación se ha eliminado.Gets a value that indicates whether the communication object has been disposed.

(Heredado de CommunicationObject)
ManualFlowControlLimit

Obtiene o establece el límite del control de flujo para los mensajes recibidos por el servicio hospedado.Gets or sets the flow control limit for messages received by the service hosted.

(Heredado de ServiceHostBase)
OpenTimeout

Obtiene o establece el intervalo de tiempo permitido para que el host del servicio se abra.Gets or sets the interval of time allowed for the service host to open.

(Heredado de ServiceHostBase)
SingletonInstance

Obtiene la instancia de singleton del servicio hospedado.Gets the singleton instance of the hosted service.

State

Obtiene un valor que indica el estado actual del objeto de comunicación.Gets a value that indicates the current state of the communication object.

(Heredado de CommunicationObject)
ThisLock

Obtiene el bloqueo mutuamente excluyente que protege la instancia de clase durante una transición de estado.Gets the mutually exclusive lock that protects the class instance during a state transition.

(Heredado de CommunicationObject)

Métodos

Abort()

Provoca que un objeto de comunicación pase inmediatamente de su estado actual al estado de cierre.Causes a communication object to transition immediately from its current state into the closing state.

(Heredado de CommunicationObject)
AddBaseAddress(Uri)

Agrega una dirección base al host de servicio.Adds a base address to the service host.

(Heredado de ServiceHostBase)
AddDefaultEndpoints()

Agrega puntos de conexión de servicio para todas las direcciones base en cada contrato encontrado en el host del servicio con el enlace predeterminado.Adds service endpoints for all base addresses in each contract found in the service host with the default binding.

(Heredado de ServiceHostBase)
AddServiceEndpoint(ServiceEndpoint)

Agrega el extremo de servicio especificado al servicio hospedado.Adds the specified service endpoint to the hosted service.

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

Agrega un punto de conexión de servicio al servicio hospedado con un contrato especificado, un enlace y una dirección del punto de conexión.Adds a service endpoint to the hosted service with a specified contract, binding, and endpoint address.

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

Agrega un punto de conexión de servicio al servicio hospedado con un contrato especificado, un enlace, una dirección del punto de conexión y un URI que contiene la dirección en la que realiza escuchas.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.

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

Agrega un punto de conexión de servicio al servicio hospedado con un contrato especificado, un enlace y un URI que contiene la dirección del punto de conexión.Adds a service endpoint to the hosted service with a specified contract, binding, and a URI that contains the endpoint address.

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

Agrega un punto de conexión de servicio al servicio hospedado con un contrato especificado, un enlace y URI que contienen la dirección del punto de conexión y la de escuchaAdds a service endpoint to the hosted service with the specified contract, binding, and URIs that contain the endpoint and listening addresses.

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

Agrega un punto de conexión de servicio al servicio hospedado con un contrato especificado, un enlace y una dirección del punto de conexión.Adds a service endpoint to the hosted service with a specified contract, binding, and endpoint address.

AddServiceEndpoint(Type, Binding, String, Uri)

Agrega un punto de conexión de servicio al servicio hospedado con un contrato especificado, un enlace y una dirección del punto de conexión y un URI en el que escucha el servicio.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)

Agrega un punto de conexión de servicio al servicio hospedado con un contrato especificado, un enlace y un URI que contiene la dirección del punto de conexión.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)

Agrega un punto de conexión de servicio al servicio hospedado con un contrato especificado, un enlace, un URI que contiene la dirección del punto de conexión y uno en el que se escucha el servicio.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()

Carga la descripción de servicio del archivo de configuración y la aplica al tiempo de ejecución que se está construyendo.Loads the service description from the configuration file and applies it to the runtime being constructed.

BeginClose(AsyncCallback, Object)

Comienza una operación asincrónica para cerrar un objeto de comunicación.Begins an asynchronous operation to close a communication object.

(Heredado de CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)

Comienza una operación asincrónica para cerrar un objeto de comunicación con un tiempo de espera especificado.Begins an asynchronous operation to close a communication object with a specified timeout.

(Heredado de CommunicationObject)
BeginOpen(AsyncCallback, Object)

Comienza una operación asincrónica para abrir un objeto de comunicación.Begins an asynchronous operation to open a communication object.

(Heredado de CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)

Comienza una operación asincrónica para abrir un objeto de comunicación dentro de un intervalo de tiempo especificado.Begins an asynchronous operation to open a communication object within a specified interval of time.

(Heredado de CommunicationObject)
Close()

Provoca que un objeto de comunicación pase de su estado actual al estado cerrado.Causes a communication object to transition from its current state into the closed state.

(Heredado de CommunicationObject)
Close(TimeSpan)

Provoca que un objeto de comunicación pase su estado actual al estado cerrado dentro de un intervalo de tiempo especificado.Causes a communication object to transition from its current state into the closed state within a specified interval of time.

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

Crea una descripción del servicio hospedado.Creates a description of the service hosted.

EndClose(IAsyncResult)

Completa una operación asincrónica para cerrar un objeto de comunicación.Completes an asynchronous operation to close a communication object.

(Heredado de CommunicationObject)
EndOpen(IAsyncResult)

Completa una operación asincrónica para abrir un objeto de comunicación.Completes an asynchronous operation to open a communication object.

(Heredado de CommunicationObject)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
Fault()

Provoca que un objeto de comunicación pase de su estado actual al estado de error.Causes a communication object to transition from its current state into the faulted state.

(Heredado de CommunicationObject)
GetCommunicationObjectType()

Obtiene el tipo de objeto de comunicación.Gets the type of communication object.

(Heredado de CommunicationObject)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
IncrementManualFlowControlLimit(Int32)

Aumenta el límite en la tasa de flujo de mensajes al servicio hospedado en un incremento especificado.Increases the limit on the flow rate of messages to the hosted service by a specified increment.

(Heredado de ServiceHostBase)
InitializeDescription(Object, UriSchemeKeyedCollection)

Inicializa una descripción del servicio hospedado dependiendo de su instancia y las direcciones base especificadas.Initializes a description of the service hosted based on its instance and specified base addresses.

InitializeDescription(Type, UriSchemeKeyedCollection)

Inicializa una descripción del servicio hospedado dependiendo de su tipo y las direcciones base especificadas.Initializes a description of the service hosted based on its type and specified base addresses.

InitializeDescription(UriSchemeKeyedCollection)

Crea e inicializa el host del servicio con las descripciones de servicio y contrato.Creates and initializes the service host with the contract and service descriptions.

(Heredado de ServiceHostBase)
InitializeRuntime()

Inicializa el tiempo de ejecución para el host del servicio.Initializes the runtime for the service host.

(Heredado de ServiceHostBase)
LoadConfigurationSection(ServiceElement)

Carga el elemento de servicio desde el archivo de configuración o el servicio hospedado.Loads the service element from the configuration file of the hosted service.

(Heredado de ServiceHostBase)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
OnAbort()

Anula el servicio.Aborts the service.

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

Comienza una operación asincrónica invocada en el cierre del host del servicio.Begins an asynchronous operation invoked on the close of the service host.

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

Comienza una operación asincrónica invocada en la apertura del host del servicio.Begins an asynchronous operation invoked on the opening of the service host.

(Heredado de ServiceHostBase)
OnClose(TimeSpan)

Cierra el servicio hospedado, incluso sus distribuidores de canal y sus contextos de instancia y agentes de escucha asociados.Closes down the hosted service, including their channel dispatchers and associated instance contexts and listeners.

(Heredado de ServiceHostBase)
OnClosed()

Dispone de servicios descartables que se hospedan cuando se cierra el host de servicio.Disposes of disposable services that are being hosted when the service host is closed.

OnClosing()

Se invoca durante la transición de un objeto de comunicación al estado de cierre.Invoked during the transition of a communication object into the closing state.

(Heredado de CommunicationObject)
OnEndClose(IAsyncResult)

Completa una operación asincrónica invocada en el cierre del host del servicio.Completes an asynchronous operation invoked on the closing of the service host.

(Heredado de ServiceHostBase)
OnEndOpen(IAsyncResult)

Completa una operación asincrónica invocada en la apertura del host del servicio.Completes an asynchronous operation invoked on the opening of the service host.

(Heredado de ServiceHostBase)
OnFaulted()

Inserta el procesamiento en un objeto de comunicación después de que éste pase al estado de error debido a la invocación de una operación sincrónica de error.Inserts processing on a communication object after it transitions to the faulted state due to the invocation of a synchronous fault operation.

(Heredado de CommunicationObject)
OnOpen(TimeSpan)

Abre los distribuidores del canal.Opens the channel dispatchers.

(Heredado de ServiceHostBase)
OnOpened()

Obtiene las credenciales de servicio, la autenticación de servicio y el comportamiento de autorización del servicio hospedado.Gets the service credentials,service authentication and authorization behavior for the hosted service.

(Heredado de ServiceHostBase)
OnOpening()

Se invoca durante la transición de un objeto de comunicación al estado de abriendo.Invoked during the transition of a communication object into the opening state.

(Heredado de CommunicationObject)
Open()

Hace que un objeto de comunicación pase del estado creado al estado abierto.Causes a communication object to transition from the created state into the opened state.

(Heredado de CommunicationObject)
Open(TimeSpan)

Hace que un objeto de comunicación pase del estado creado al estado abierto dentro de un intervalo de tiempo especificado.Causes a communication object to transition from the created state into the opened state within a specified interval of time.

(Heredado de CommunicationObject)
ReleasePerformanceCounters()

Libera el servicio y los contadores de rendimiento de distribuidor de canal para el servicio hospedado.Releases the service and channel dispatcher performance counters for the hosted service.

(Heredado de ServiceHostBase)
SetEndpointAddress(ServiceEndpoint, String)

Establece la dirección del extremo especificado en la dirección especificada.Sets the endpoint address of the specified endpoint to the specified address.

(Heredado de ServiceHostBase)
ThrowIfDisposed()

Produce una excepción si se elimina el objeto de comunicación.Throws an exception if the communication object is disposed.

(Heredado de CommunicationObject)
ThrowIfDisposedOrImmutable()

Produce una excepción si en el objeto de comunicación la propiedad State no está establecida en el estado Created.Throws an exception if the communication object the State property is not set to the Created state.

(Heredado de CommunicationObject)
ThrowIfDisposedOrNotOpen()

Produce una excepción si el objeto de comunicación no está en el estado Opened.Throws an exception if the communication object is not in the Opened state.

(Heredado de CommunicationObject)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Eventos

Closed

Se produce cuando un objeto de comunicación realiza una transición al estado de cerrado.Occurs when a communication object transitions into the closed state.

(Heredado de CommunicationObject)
Closing

Se produce cuando un objeto de comunicación realiza una transición al estado de cerrando.Occurs when a communication object transitions into the closing state.

(Heredado de CommunicationObject)
Faulted

Se produce cuando un objeto de comunicación realiza una transición al estado de error.Occurs when a communication object transitions into the faulted state.

(Heredado de CommunicationObject)
Opened

Se produce cuando un objeto de comunicación realiza una transición al estado de abierto.Occurs when a communication object transitions into the opened state.

(Heredado de CommunicationObject)
Opening

Se produce cuando un objeto de comunicación realiza una transición al estado de abriendo.Occurs when a communication object transitions into the opening state.

(Heredado de CommunicationObject)
UnknownMessageReceived

Se produce cuando se recibe un mensaje desconocido.Occurs when an unknown message is received.

(Heredado de ServiceHostBase)

Implementaciones de interfaz explícitas

IDisposable.Dispose()

Cierra el host del servicio.Closes the service host.

(Heredado de ServiceHostBase)

Se aplica a