Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase ServiceHostBase

 

Publicado: octubre de 2016

Extienda la clase ServiceHostBase para implementar hosts que exponen los modelos de programación personalizados.

Espacio de nombres:   System.ServiceModel
Ensamblado:  System.ServiceModel (en System.ServiceModel.dll)


public abstract class ServiceHostBase : CommunicationObject, 
	IExtensibleObject<ServiceHostBase>, IDisposable

NombreDescripción
System_CAPS_protmethodServiceHostBase()

Inicializa una nueva instancia de la clase ServiceHostBase.

NombreDescripción
System_CAPS_pubpropertyAuthentication

Obtiene el comportamiento de autenticación de servicio.

System_CAPS_pubpropertyAuthorization

Obtiene el comportamiento de la autorización para el servicio hospedado.

System_CAPS_pubpropertyBaseAddresses

Obtiene las direcciones base utilizadas por el servicio hospedado.

System_CAPS_pubpropertyChannelDispatchers

Obtiene la colección de distribuidores del canal utilizados por el host del servicio.

System_CAPS_pubpropertyCloseTimeout

Obtiene o establece el intervalo de tiempo permitido para que el host del servicio se cierre.

System_CAPS_pubpropertyCredentials

Obtiene la credencial para el servicio hospedado.

System_CAPS_protpropertyDefaultCloseTimeout

Obtiene o establece el intervalo de tiempo predeterminado permitido para que el host del servicio se cierre.(Invalida CommunicationObject.DefaultCloseTimeout).

System_CAPS_protpropertyDefaultOpenTimeout

Obtiene el intervalo de tiempo predeterminado permitido para que el host del servicio se abra.(Invalida CommunicationObject.DefaultOpenTimeout).

System_CAPS_pubpropertyDescription

Obtiene la descripción del servicio hospedado.

System_CAPS_pubpropertyExtensions

Obtiene las extensiones para el host de servicio actual especificado.

System_CAPS_protpropertyImplementedContracts

Recupera los contratos implementados por el servicio hospedado.

System_CAPS_protpropertyIsDisposed

Obtiene un valor que indica si el objeto de comunicación se ha eliminado.(Heredado de CommunicationObject).

System_CAPS_pubpropertyManualFlowControlLimit

Obtiene o establece el límite del control de flujo para los mensajes recibidos por el servicio hospedado.

System_CAPS_pubpropertyOpenTimeout

Obtiene o establece el intervalo de tiempo permitido para que el host del servicio se abra.

System_CAPS_pubpropertyState

Obtiene un valor que indica el estado actual del objeto de comunicación.(Heredado de CommunicationObject).

System_CAPS_protpropertyThisLock

Obtiene el bloqueo mutuamente excluyente que protege la instancia de clase durante una transición de estado.(Heredado de CommunicationObject).

NombreDescripción
System_CAPS_pubmethodAbort()

Provoca que un objeto de comunicación pase inmediatamente de su estado actual al estado de cierre.(Heredado de CommunicationObject).

System_CAPS_protmethodAddBaseAddress(Uri)

Agrega una dirección base al host de servicio.

System_CAPS_pubmethodAddDefaultEndpoints()

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.

System_CAPS_pubmethodAddServiceEndpoint(ServiceEndpoint)

Agrega el punto de conexión de servicio especificado al servicio hospedado.

System_CAPS_pubmethodAddServiceEndpoint(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.

System_CAPS_pubmethodAddServiceEndpoint(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.

System_CAPS_pubmethodAddServiceEndpoint(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.

System_CAPS_pubmethodAddServiceEndpoint(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

System_CAPS_protmethodApplyConfiguration()

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.

System_CAPS_pubmethodBeginClose(AsyncCallback, Object)

Comienza una operación asincrónica para cerrar un objeto de comunicación.(Heredado de CommunicationObject).

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

System_CAPS_pubmethodBeginOpen(AsyncCallback, Object)

Comienza una operación asincrónica para abrir un objeto de comunicación.(Heredado de CommunicationObject).

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

System_CAPS_pubmethodClose()

Provoca que un objeto de comunicación pase de su estado actual al estado cerrado.(Heredado de CommunicationObject).

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

System_CAPS_protmethodCreateDescription(IDictionary<String, ContractDescription>)

Cuando se implementa en una clase derivada, crea la descripción del servicio hospedado.

System_CAPS_pubmethodEndClose(IAsyncResult)

Completa una operación asincrónica para cerrar un objeto de comunicación.(Heredado de CommunicationObject).

System_CAPS_pubmethodEndOpen(IAsyncResult)

Completa una operación asincrónica para abrir un objeto de comunicación.(Heredado de CommunicationObject).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFault()

Provoca que un objeto de comunicación pase de su estado actual al estado de error.(Heredado de CommunicationObject).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_protmethodGetCommunicationObjectType()

Obtiene el tipo de objeto de comunicación.(Heredado de CommunicationObject).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodIncrementManualFlowControlLimit(Int32)

Aumenta el límite en la tasa de flujo de mensajes al servicio hospedado en un incremento especificado.

System_CAPS_protmethodInitializeDescription(UriSchemeKeyedCollection)

Crea e inicializa el host de servicio con las descripciones de servicio y contrato.

System_CAPS_protmethodInitializeRuntime()

Inicializa el tiempo de ejecución para el host de servicio.

System_CAPS_protmethodLoadConfigurationSection(ServiceElement)

Carga el elemento de servicio desde el archivo de configuración o el servicio hospedado.

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodOnAbort()

Anula el servicio.(Invalida CommunicationObject.OnAbort()).

System_CAPS_protmethodOnBeginClose(TimeSpan, AsyncCallback, Object)

Comienza una operación asincrónica invocada en el cierre del host de servicio.(Invalida CommunicationObject.OnBeginClose(TimeSpan, AsyncCallback, Object)).

System_CAPS_protmethodOnBeginOpen(TimeSpan, AsyncCallback, Object)

Comienza una operación asincrónica invocada en la apertura del host del servicio.(Invalida CommunicationObject.OnBeginOpen(TimeSpan, AsyncCallback, Object)).

System_CAPS_protmethodOnClose(TimeSpan)

Cierra el servicio hospedado, incluso sus distribuidores de canal y sus contextos de instancia y agentes de escucha asociados.(Invalida CommunicationObject.OnClose(TimeSpan)).

System_CAPS_protmethodOnClosed()

Libera los recursos utilizados por el host de servicio.(Invalida CommunicationObject.OnClosed()).

System_CAPS_protmethodOnClosing()

Se invoca durante la transición de un objeto de comunicación al estado de cierre.(Heredado de CommunicationObject).

System_CAPS_protmethodOnEndClose(IAsyncResult)

Completa una operación asincrónica invocada en el cierre del host del servicio.(Invalida CommunicationObject.OnEndClose(IAsyncResult)).

System_CAPS_protmethodOnEndOpen(IAsyncResult)

Completa una operación asincrónica invocada en la apertura del host del servicio.(Invalida CommunicationObject.OnEndOpen(IAsyncResult)).

System_CAPS_protmethodOnFaulted()

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

System_CAPS_protmethodOnOpen(TimeSpan)

Abre los distribuidores del canal.(Invalida CommunicationObject.OnOpen(TimeSpan)).

System_CAPS_protmethodOnOpened()

Obtiene las credenciales de servicio, la autenticación de servicio y el comportamiento de autorización del servicio hospedado.(Invalida CommunicationObject.OnOpened()).

System_CAPS_protmethodOnOpening()

Se invoca durante la transición de un objeto de comunicación al estado de abriendo.(Heredado de CommunicationObject).

System_CAPS_pubmethodOpen()

Hace que un objeto de comunicación pase del estado creado al estado abierto.(Heredado de CommunicationObject).

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

System_CAPS_protmethodReleasePerformanceCounters()

Libera el servicio y los contadores de rendimiento de distribuidor de canal para el servicio hospedado.

System_CAPS_pubmethodSetEndpointAddress(ServiceEndpoint, String)

Establece la dirección del punto de conexión especificado en la dirección especificada.

System_CAPS_protmethodThrowIfDisposed()

Produce una excepción si se elimina el objeto de comunicación.(Heredado de CommunicationObject).

System_CAPS_protmethodThrowIfDisposedOrImmutable()

Produce una excepción si en el objeto de comunicación la propiedad State no está establecida en el estado Created.(Heredado de CommunicationObject).

System_CAPS_protmethodThrowIfDisposedOrNotOpen()

Produce una excepción si el objeto de comunicación no está en el estado Opened.(Heredado de CommunicationObject).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

NombreDescripción
System_CAPS_pubeventClosed

Se produce cuando un objeto de comunicación realiza una transición al estado de cerrado.(Heredado de CommunicationObject).

System_CAPS_pubeventClosing

Se produce cuando un objeto de comunicación realiza una transición al estado de cerrando.(Heredado de CommunicationObject).

System_CAPS_pubeventFaulted

Se produce cuando un objeto de comunicación realiza una transición al estado de error.(Heredado de CommunicationObject).

System_CAPS_pubeventOpened

Se produce cuando un objeto de comunicación realiza una transición al estado de abierto.(Heredado de CommunicationObject).

System_CAPS_pubeventOpening

Se produce cuando un objeto de comunicación realiza una transición al estado de abriendo.(Heredado de CommunicationObject).

System_CAPS_pubeventUnknownMessageReceived

Se produce cuando se recibe un mensaje desconocido.

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodIDisposable.Dispose()

Cierra el host de servicio.

Utilice la clase ServiceHostBase para crear hosts que proporcionan un modelo de programación personalizado. El modelo de programación de servicio Windows Communication Foundation (WCF) utiliza la clase ServiceHost.

Nota especial para los usuarios de C++ que deriven de esta clase:

  • Coloque su código de limpieza en (On)(Begin)Close (y/o OnAbort), no en un destructor.

  • Evite los destructores; hacen que el compilador genere automáticamente IDisposable

  • Evite los miembros sin referencia; pueden hacer que el compilador genere automáticamente IDisposable.

  • Evite los finalizadores; pero si incluye uno, debería suprimir la advertencia de creación y llamar a SuppressFinalize(Object) y al propio finalizador de (On)(Begin)Close (y/o OnAbort) para emular lo que habría sido el comportamiento de IDisposable generado automáticamente.

Este ejemplo utiliza la clase ServiceHost, que se deriva de ServiceHostBase

// 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();
    }
  }
}

.NET Framework
Disponible desde 3.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: