ServiceHost Classe

Definizione

Spazio dei nomi:

System.ServiceModel

Assembly:

System.ServiceModel.dll

Fornisce un host di servizi.

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

public class ServiceHost : System.ServiceModel.ServiceHostBase

type ServiceHost = class
    inherit ServiceHostBase

Public Class ServiceHost
Inherits ServiceHostBase

Ereditarietà

Object

CommunicationObject

ServiceHostBase

ServiceHost

Derivato

System.ServiceModel.Security.WSTrustServiceHost

System.ServiceModel.Web.WebServiceHost

Esempio

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

Commenti

Implementa l'host usato dal modello di programmazione del modello di servizio Windows Communication Foundation (WCF).

Usare la ServiceHost classe per configurare ed esporre un servizio da usare dalle applicazioni client quando non si usa Internet Information Services (IIS) o Windows Activation Services (WAS) per esporre un servizio. Sia IIS sia WAS interagiscono automaticamente con un oggetto ServiceHost.

Per esporre un servizio da usare dai chiamanti, WCF richiede una descrizione completa del ServiceDescription servizio (rappresentata dalla classe). La ServiceHost classe crea un oggetto ServiceDescription dal tipo di servizio e dalle informazioni di configurazione e quindi usa tale descrizione per creare ChannelDispatcher oggetti per ogni endpoint nella descrizione.

Usare un oggetto per caricare un ServiceHost servizio, configurare gli endpoint, applicare le impostazioni di sicurezza e avviare i listener per gestire le richieste in ingresso.

Costruttori

ServiceHost()	Inizializza una nuova istanza della classe ServiceHost.
ServiceHost(Object, Uri[])	Consente di inizializzare una nuova istanza della classe ServiceHost con l'istanza del servizio e i relativi indirizzi di base specificati.
ServiceHost(Type, Uri[])	Consente di inizializzare una nuova istanza della classe ServiceHost con il tipo di servizio e i relativi indirizzi di base specificati.

Proprietà

Authentication	Ottiene il comportamento di autenticazione. (Ereditato da ServiceHostBase)
Authorization	Ottiene il comportamento dell'autorizzazione per il servizio ospitato. (Ereditato da ServiceHostBase)
BaseAddresses	Ottiene gli indirizzi di base utilizzati dal servizio ospitato. (Ereditato da ServiceHostBase)
ChannelDispatchers	Ottiene la raccolta di ChannelDispatcher utilizzati dall'host del servizio. (Ereditato da ServiceHostBase)
CloseTimeout	Ottiene o imposta l'intervallo di tempo consentito per la chiusura dell'host del servizio. (Ereditato da ServiceHostBase)
Credentials	Ottiene le credenziali per il servizio ospitato. (Ereditato da ServiceHostBase)
DefaultCloseTimeout	Ottiene l'intervallo di tempo predefinito consentito per la chiusura dell'host del servizio. (Ereditato da ServiceHostBase)
DefaultOpenTimeout	Ottiene l'intervallo di tempo predefinito consentito per l'apertura dell'host del servizio. (Ereditato da ServiceHostBase)
Description	Ottiene la descrizione del servizio ospitato. (Ereditato da ServiceHostBase)
Extensions	Ottiene le estensioni per l'host del servizio specificato corrente. (Ereditato da ServiceHostBase)
ImplementedContracts	Recupera i contratti implementati dal servizio ospitato. (Ereditato da ServiceHostBase)
IsDisposed	Ottiene un valore che indica se l'oggetto di comunicazione è stato eliminato. (Ereditato da CommunicationObject)
ManualFlowControlLimit	Ottiene o imposta il limite di controllo di flusso per i messaggi ricevuti dal servizio ospitato. (Ereditato da ServiceHostBase)
OpenTimeout	Ottiene o imposta l'intervallo di tempo consentito per l'apertura dell'host del servizio. (Ereditato da ServiceHostBase)
SingletonInstance	Consente di ottenere l'istanza singleton del servizio ospitato.
State	Ottiene un valore che indica lo stato corrente dell'oggetto di comunicazione. (Ereditato da CommunicationObject)
ThisLock	Ottiene il blocco a esclusione reciproca che protegge l'istanza della classe durante una transizione di stato. (Ereditato da CommunicationObject)

Metodi

Abort()	Determina la transizione immediata di un oggetto di comunicazione dallo stato corrente allo stato di chiusura. (Ereditato da CommunicationObject)
AddBaseAddress(Uri)	Aggiunge un indirizzo di base all'host del servizio. (Ereditato da ServiceHostBase)
AddDefaultEndpoints()	Aggiunge endpoint di servizio per tutti gli indirizzi di base in ogni contratto trovato nell'host del servizio con l'associazione predefinita. (Ereditato da ServiceHostBase)
AddServiceEndpoint(ServiceEndpoint)	Aggiunge l'endpoint del servizio specificato al servizio ospitato. (Ereditato da ServiceHostBase)
AddServiceEndpoint(String, Binding, String)	Consente di aggiungere al servizio ospitato un endpoint di servizio con il contratto, l'associazione e l'indirizzo endpoint specificati. (Ereditato da ServiceHostBase)
AddServiceEndpoint(String, Binding, String, Uri)	Aggiunge un endpoint di servizio al servizio ospitato con il contratto, l'associazione e l'indirizzo endpoint specificati nonché l'URI contenente l'indirizzo su cui è in ascolto. (Ereditato da ServiceHostBase)
AddServiceEndpoint(String, Binding, Uri)	Consente di aggiungere al servizio ospitato un endpoint di servizio con il contratto, l'associazione e l'URI contenente l'indirizzo endpoint specificati. (Ereditato da ServiceHostBase)
AddServiceEndpoint(String, Binding, Uri, Uri)	Aggiunge al servizio ospitato un endpoint di servizio con il contratto, l'associazione e gli URI contenenti gli indirizzi endpoint e di ascolto specificati. (Ereditato da ServiceHostBase)
AddServiceEndpoint(Type, Binding, String)	Consente di aggiungere al servizio ospitato un endpoint di servizio con il contratto, l'associazione e l'indirizzo endpoint specificati.
AddServiceEndpoint(Type, Binding, String, Uri)	Aggiunge al servizio ospitato un endpoint di servizio con il contratto, l'associazione e l'indirizzo endpoint specificati nonché l'URI su cui il servizio è in ascolto.
AddServiceEndpoint(Type, Binding, Uri)	Aggiunge al servizio ospitato un endpoint di servizio con il contratto, l'associazione e l'URI contenente l'indirizzo endpoint specificati.
AddServiceEndpoint(Type, Binding, Uri, Uri)	Consente di aggiungere al servizio ospitato un endpoint di servizio con il contratto, l'associazione e l'URI contenente l'indirizzo endpoint specificati nonché l'URI su cui il servizio è in ascolto.
ApplyConfiguration()	Carica la descrizione del servizio dal file di configurazione e la applica al runtime che viene creato.
ApplyConfiguration()	Carica le informazioni di descrizione del servizio dal file di configurazione e le applica al runtime che viene creato. (Ereditato da ServiceHostBase)
BeginClose(AsyncCallback, Object)	Consente di iniziare un'operazione asincrona finalizzata a chiudere un oggetto di comunicazione. (Ereditato da CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	Consente di iniziare un'operazione asincrona finalizzata a chiudere un oggetto di comunicazione entro un determinato intervallo di tempo. (Ereditato da CommunicationObject)
BeginOpen(AsyncCallback, Object)	Consente di iniziare un'operazione asincrona finalizzata ad aprire un oggetto di comunicazione. (Ereditato da CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	Consente di iniziare un'operazione asincrona finalizzata ad aprire un oggetto di comunicazione entro un determinato intervallo di tempo. (Ereditato da CommunicationObject)
Close()	Comporta la transizione di un oggetto di comunicazione dallo stato corrente allo stato di chiusura. (Ereditato da CommunicationObject)
Close(TimeSpan)	Determina la transizione di un oggetto di comunicazione dallo stato corrente allo stato Closed entro un intervallo di tempo specificato. (Ereditato da CommunicationObject)
CreateDescription(IDictionary<String,ContractDescription>)	Consente di creare una descrizione del servizio ospitato.
EndClose(IAsyncResult)	Consente di completare un'operazione asincrona finalizzata a chiudere un oggetto di comunicazione. (Ereditato da CommunicationObject)
EndOpen(IAsyncResult)	Consente di completare un'operazione asincrona finalizzata ad aprire un oggetto di comunicazione. (Ereditato da CommunicationObject)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Fault()	Determina la transizione di un oggetto di comunicazione dallo stato corrente allo stato Faulted. (Ereditato da CommunicationObject)
GetCommunicationObjectType()	Ottiene il tipo di oggetto di comunicazione. (Ereditato da CommunicationObject)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IncrementManualFlowControlLimit(Int32)	Aumenta il limite sulla velocità di flusso dei messaggi verso il servizio ospitato in base a un incremento specificato. (Ereditato da ServiceHostBase)
InitializeDescription(Object, UriSchemeKeyedCollection)	Consente di inizializzare una descrizione del servizio ospitato in base all'istanza e agli indirizzi di base specificati.
InitializeDescription(Type, UriSchemeKeyedCollection)	Consente di inizializzare una descrizione del servizio ospitato in base al tipo e agli indirizzi di base specificati.
InitializeDescription(UriSchemeKeyedCollection)	Crea e inizializza l'host del servizio con le descrizioni del contratto e del servizio. (Ereditato da ServiceHostBase)
InitializeRuntime()	Inizializza il runtime per l'host del servizio. (Ereditato da ServiceHostBase)
LoadConfigurationSection(ServiceElement)	Carica l'elemento del servizio dal file di configurazione del servizio ospitato. (Ereditato da ServiceHostBase)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnAbort()	Interrompe il servizio. (Ereditato da ServiceHostBase)
OnBeginClose(TimeSpan, AsyncCallback, Object)	Avvia un'operazione asincrona richiamata durante la chiusura dell'host del servizio. (Ereditato da ServiceHostBase)
OnBeginOpen(TimeSpan, AsyncCallback, Object)	Avvia un'operazione asincrona richiamata all'apertura dell'host del servizio. (Ereditato da ServiceHostBase)
OnClose(TimeSpan)	Chiude il servizio ospitato, compresi i ChannelDispatcher e i contesti di istanza e i listener associati. (Ereditato da ServiceHostBase)
OnClosed()	Elimina i servizi eliminabili ospitati quando l'host del servizio viene chiuso.
OnClosing()	Viene chiamato durante la transizione di un oggetto di comunicazione allo stato di chiusura. (Ereditato da CommunicationObject)
OnEndClose(IAsyncResult)	Completa un'operazione asincrona richiamata alla chiusura dell'host del servizio. (Ereditato da ServiceHostBase)
OnEndOpen(IAsyncResult)	Completa un'operazione asincrona richiamata all'apertura dell'host del servizio. (Ereditato da ServiceHostBase)
OnFaulted()	Inserisce l'elaborazione in un oggetto di comunicazione dopo che ha eseguito la transizione allo stato Faulted in seguito alla chiamata di un'operazione di errore sincrona. (Ereditato da CommunicationObject)
OnOpen(TimeSpan)	Apre i ChannelDispatcher. (Ereditato da ServiceHostBase)
OnOpened()	Ottiene le credenziali e l'autenticazione del servizio e il comportamento dell'autorizzazione per il servizio ospitato. (Ereditato da ServiceHostBase)
OnOpening()	Viene chiamato durante la transizione di un oggetto di comunicazione allo stato Opening. (Ereditato da CommunicationObject)
Open()	Comporta la transizione di un oggetto di comunicazione dallo stato di creazione allo stato di apertura. (Ereditato da CommunicationObject)
Open(TimeSpan)	Comporta la transizione di un oggetto di comunicazione dallo stato di creazione allo stato di apertura entro un determinato intervallo di tempo. (Ereditato da CommunicationObject)
ReleasePerformanceCounters()	Rilascia i contatori delle prestazioni del servizio e dei ChannelDispatcher per il servizio ospitato. (Ereditato da ServiceHostBase)
SetEndpointAddress(ServiceEndpoint, String)	Imposta l'indirizzo dell'endpoint specificato sul valore specificato. (Ereditato da ServiceHostBase)
ThrowIfDisposed()	Se l'oggetto di comunicazione è stato eliminato, genera un'eccezione. (Ereditato da CommunicationObject)
ThrowIfDisposedOrImmutable()	Se la proprietà State dell'oggetto di comunicazione non è impostata su Created, genera un'eccezione. (Ereditato da CommunicationObject)
ThrowIfDisposedOrNotOpen()	Se l'oggetto di comunicazione non si trova nello stato Opened, genera un'eccezione. (Ereditato da CommunicationObject)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Eventi

Closed	Si verifica quando un oggetto di comunicazione esegue la transizione allo stato Closed. (Ereditato da CommunicationObject)
Closing	Si verifica quando un oggetto di comunicazione esegue la transizione allo stato Closing. (Ereditato da CommunicationObject)
Faulted	Si verifica quando un oggetto di comunicazione esegue la transizione allo stato Faulted. (Ereditato da CommunicationObject)
Opened	Si verifica quando un oggetto di comunicazione esegue la transizione allo stato Opened. (Ereditato da CommunicationObject)
Opening	Si verifica quando un oggetto di comunicazione esegue la transizione allo stato Opening. (Ereditato da CommunicationObject)
UnknownMessageReceived	Si verifica quando viene ricevuto un messaggio sconosciuto. (Ereditato da ServiceHostBase)

Implementazioni dell'interfaccia esplicita

IDisposable.Dispose()

Chiude l'host del servizio. (Ereditato da ServiceHostBase)