ServiceHost Clase

Definición

Espacio de nombres:

System.ServiceModel

Ensamblado:

System.ServiceModel.dll

Proporciona un host para los servicios.

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

public class ServiceHost : System.ServiceModel.ServiceHostBase

type ServiceHost = class
    inherit ServiceHostBase

Public Class ServiceHost
Inherits ServiceHostBase

Herencia

Object

CommunicationObject

ServiceHostBase

ServiceHost

Derivado

System.ServiceModel.Security.WSTrustServiceHost

System.ServiceModel.Web.WebServiceHost

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).

Use la ServiceHost clase para configurar y exponer un servicio para que lo usen las aplicaciones cliente cuando no use Internet Information Services (IIS) o Windows Activation Services (WAS) para exponer un servicio. Tanto IIS como WAS interactúan con un objeto ServiceHost en su nombre.

Para exponer un servicio para su uso por parte de los autores de llamadas, WCF requiere una descripción completa del servicio (representada por la ServiceDescription clase ). La ServiceHost clase crea a ServiceDescription partir del tipo de servicio y la información de configuración y, a continuación, usa esa descripción para crear ChannelDispatcher objetos para cada punto de conexión en la descripción.

Use un ServiceHost objeto para cargar un servicio, configurar puntos de conexión, aplicar la configuración de seguridad e iniciar agentes de escucha para controlar las solicitudes entrantes.

Constructores

ServiceHost()	Inicializa una nueva instancia de la clase ServiceHost.
ServiceHost(Object, Uri[])	Inicializa una nueva instancia de la clase ServiceHost con la instancia del servicio y las direcciones base especificadas.
ServiceHost(Type, Uri[])	Inicializa una nueva instancia de la clase ServiceHost con el tipo de servicio y las direcciones base especificadas.

Propiedades

Authentication	Obtiene el comportamiento de autenticación de servicio. (Heredado de ServiceHostBase)
Authorization	Obtiene el comportamiento de la autorización para el servicio hospedado. (Heredado de ServiceHostBase)
BaseAddresses	Obtiene las direcciones base utilizadas por el servicio hospedado. (Heredado de ServiceHostBase)
ChannelDispatchers	Obtiene la colección de distribuidores del canal utilizados por el host del servicio. (Heredado de ServiceHostBase)
CloseTimeout	Obtiene o establece el intervalo de tiempo permitido para que el host del servicio se cierre. (Heredado de ServiceHostBase)
Credentials	Obtiene la credencial para el servicio hospedado. (Heredado de ServiceHostBase)
DefaultCloseTimeout	Obtiene o establece el intervalo de tiempo predeterminado permitido para que el host del servicio se cierre. (Heredado de ServiceHostBase)
DefaultOpenTimeout	Obtiene el intervalo de tiempo predeterminado permitido para que el host del servicio se abra. (Heredado de ServiceHostBase)
Description	Obtiene la descripción del servicio hospedado. (Heredado de ServiceHostBase)
Extensions	Obtiene las extensiones para el host del servicio actual especificado. (Heredado de ServiceHostBase)
ImplementedContracts	Recupera los contratos implementados por el servicio hospedado. (Heredado de ServiceHostBase)
IsDisposed	Obtiene un valor que indica si el objeto de comunicación se ha eliminado. (Heredado de CommunicationObject)
ManualFlowControlLimit	Obtiene o establece el límite del control de flujo para los mensajes recibidos por el servicio hospedado. (Heredado de ServiceHostBase)
OpenTimeout	Obtiene o establece el intervalo de tiempo permitido para que el host del servicio se abra. (Heredado de ServiceHostBase)
SingletonInstance	Obtiene la instancia de singleton del servicio hospedado.
State	Obtiene un valor que indica el estado actual del objeto de comunicación. (Heredado de CommunicationObject)
ThisLock	Obtiene el bloqueo mutuamente excluyente que protege la instancia de clase durante una transición de estado. (Heredado de CommunicationObject)

Métodos

Abort()	Provoca que un objeto de comunicación pase inmediatamente de su estado actual al estado de cierre. (Heredado de CommunicationObject)
AddBaseAddress(Uri)	Agrega una dirección base al host de servicio. (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. (Heredado de ServiceHostBase)
AddServiceEndpoint(ServiceEndpoint)	Agrega el extremo de servicio especificado al servicio hospedado. (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. (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. (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. (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 escucha (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.
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.
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.
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.
ApplyConfiguration()	Carga la descripción de servicio del archivo de configuración y la aplica al tiempo de ejecución que se está construyendo.
ApplyConfiguration()	Carga la información de descripción de servicio del archivo de configuración y la aplica al tiempo de ejecución que se está construyendo. (Heredado de ServiceHostBase)
BeginClose(AsyncCallback, Object)	Comienza una operación asincrónica para cerrar un objeto de comunicación. (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. (Heredado de CommunicationObject)
BeginOpen(AsyncCallback, Object)	Comienza una operación asincrónica para abrir un objeto de comunicación. (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. (Heredado de CommunicationObject)
Close()	Provoca que un objeto de comunicación pase de su estado actual al estado cerrado. (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. (Heredado de CommunicationObject)
CreateDescription(IDictionary<String,ContractDescription>)	Crea una descripción del servicio hospedado.
EndClose(IAsyncResult)	Completa una operación asincrónica para cerrar un objeto de comunicación. (Heredado de CommunicationObject)
EndOpen(IAsyncResult)	Completa una operación asincrónica para abrir un objeto de comunicación. (Heredado de CommunicationObject)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
Fault()	Provoca que un objeto de comunicación pase de su estado actual al estado de error. (Heredado de CommunicationObject)
GetCommunicationObjectType()	Obtiene el tipo de objeto de comunicación. (Heredado de CommunicationObject)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IncrementManualFlowControlLimit(Int32)	Aumenta el límite en la tasa de flujo de mensajes al servicio hospedado en un incremento especificado. (Heredado de ServiceHostBase)
InitializeDescription(Object, UriSchemeKeyedCollection)	Inicializa una descripción del servicio hospedado dependiendo de su instancia y las direcciones base especificadas.
InitializeDescription(Type, UriSchemeKeyedCollection)	Inicializa una descripción del servicio hospedado dependiendo de su tipo y las direcciones base especificadas.
InitializeDescription(UriSchemeKeyedCollection)	Crea e inicializa el host del servicio con las descripciones de servicio y contrato. (Heredado de ServiceHostBase)
InitializeRuntime()	Inicializa el tiempo de ejecución para el host del servicio. (Heredado de ServiceHostBase)
LoadConfigurationSection(ServiceElement)	Carga el elemento de servicio desde el archivo de configuración o el servicio hospedado. (Heredado de ServiceHostBase)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnAbort()	Anula el servicio. (Heredado de ServiceHostBase)
OnBeginClose(TimeSpan, AsyncCallback, Object)	Comienza una operación asincrónica invocada en el cierre del host del servicio. (Heredado de ServiceHostBase)
OnBeginOpen(TimeSpan, AsyncCallback, Object)	Comienza una operación asincrónica invocada en la apertura del host del servicio. (Heredado de ServiceHostBase)
OnClose(TimeSpan)	Cierra el servicio hospedado, incluso sus distribuidores de canal y sus contextos de instancia y agentes de escucha asociados. (Heredado de ServiceHostBase)
OnClosed()	Dispone de servicios descartables que se hospedan cuando se cierra el host de servicio.
OnClosing()	Se invoca durante la transición de un objeto de comunicación al estado de cierre. (Heredado de CommunicationObject)
OnEndClose(IAsyncResult)	Completa una operación asincrónica invocada en el cierre del host del servicio. (Heredado de ServiceHostBase)
OnEndOpen(IAsyncResult)	Completa una operación asincrónica invocada en la apertura del host del servicio. (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. (Heredado de CommunicationObject)
OnOpen(TimeSpan)	Abre los distribuidores del canal. (Heredado de ServiceHostBase)
OnOpened()	Obtiene las credenciales de servicio, la autenticación de servicio y el comportamiento de autorización del servicio hospedado. (Heredado de ServiceHostBase)
OnOpening()	Se invoca durante la transición de un objeto de comunicación al estado de abriendo. (Heredado de CommunicationObject)
Open()	Hace que un objeto de comunicación pase del estado creado al estado abierto. (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. (Heredado de CommunicationObject)
ReleasePerformanceCounters()	Libera el servicio y los contadores de rendimiento de distribuidor de canal para el servicio hospedado. (Heredado de ServiceHostBase)
SetEndpointAddress(ServiceEndpoint, String)	Establece la dirección del punto de conexión especificado en la dirección especificada. (Heredado de ServiceHostBase)
ThrowIfDisposed()	Produce una excepción si se elimina el objeto de comunicación. (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. (Heredado de CommunicationObject)
ThrowIfDisposedOrNotOpen()	Produce una excepción si el objeto de comunicación no está en el estado Opened. (Heredado de CommunicationObject)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Eventos

Closed	Se produce cuando un objeto de comunicación realiza una transición al estado de cerrado. (Heredado de CommunicationObject)
Closing	Se produce cuando un objeto de comunicación realiza una transición al estado de cerrando. (Heredado de CommunicationObject)
Faulted	Se produce cuando un objeto de comunicación realiza una transición al estado de error. (Heredado de CommunicationObject)
Opened	Se produce cuando un objeto de comunicación realiza una transición al estado de abierto. (Heredado de CommunicationObject)
Opening	Se produce cuando un objeto de comunicación realiza una transición al estado de abriendo. (Heredado de CommunicationObject)
UnknownMessageReceived	Se produce cuando se recibe un mensaje desconocido. (Heredado de ServiceHostBase)

Implementaciones de interfaz explícitas

IDisposable.Dispose()

Cierra el host del servicio. (Heredado de ServiceHostBase)