ServiceHostBase Classe
TOC
Réduire la table des matières
Développer la table des matières
Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ServiceHostBase, classe

 

Étend la classe ServiceHostBase pour implémenter des hôtes exposant des modèles de programmation personnalisés.

Espace de noms:   System.ServiceModel
Assembly:  System.ServiceModel (dans System.ServiceModel.dll)


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

NomDescription
System_CAPS_protmethodServiceHostBase()

Initialise une nouvelle instance de la classe ServiceHostBase.

NomDescription
System_CAPS_pubpropertyAuthentication

Obtient le comportement d'authentification du service.

System_CAPS_pubpropertyAuthorization

Obtient le comportement d'autorisation pour le service hébergé.

System_CAPS_pubpropertyBaseAddresses

Obtient les adresses de base utilisées par le service hébergé.

System_CAPS_pubpropertyChannelDispatchers

Obtient la collection de répartiteurs de canal utilisés par l’hôte du service.

System_CAPS_pubpropertyCloseTimeout

Obtient ou définit l'intervalle de temps pendant lequel la fermeture de l'hôte du service est autorisée.

System_CAPS_pubpropertyCredentials

Obtient les informations d'identification du service hébergé.

System_CAPS_protpropertyDefaultCloseTimeout

Obtient l'intervalle de temps par défaut pendant lequel la fermeture de l'hôte du service est autorisée.(Remplace CommunicationObject.DefaultCloseTimeout.)

System_CAPS_protpropertyDefaultOpenTimeout

Obtient l'intervalle de temps par défaut pendant lequel l'ouverture de l'hôte du service est autorisée.(Remplace CommunicationObject.DefaultOpenTimeout.)

System_CAPS_pubpropertyDescription

Obtient la description du service hébergé.

System_CAPS_pubpropertyExtensions

Obtient les extensions pour l'hôte du service actuellement spécifié.

System_CAPS_protpropertyImplementedContracts

Récupère les contrats implémentés par le service hébergé.

System_CAPS_protpropertyIsDisposed

Obtient une valeur qui indique si l'objet de communication a été supprimé.(Hérité de CommunicationObject.)

System_CAPS_pubpropertyManualFlowControlLimit

Obtient ou définit la limite de contrôle de flux pour les messages reçus par le service hébergé.

System_CAPS_pubpropertyOpenTimeout

Obtient ou définit l'intervalle de temps pendant lequel l'ouverture de l'hôte du service est autorisée.

System_CAPS_pubpropertyState

Obtient une valeur qui indique l'état actuel de l'objet de communication.(Hérité de CommunicationObject.)

System_CAPS_protpropertyThisLock

Obtient le verrou mutuellement exclusif qui protège l'instance de classe pendant une transition d'état.(Hérité de CommunicationObject.)

NomDescription
System_CAPS_pubmethodAbort()

Provoque la transition immédiate d'un objet de communication de son état actuel à l'état de fermeture.(Hérité de CommunicationObject.)

System_CAPS_protmethodAddBaseAddress(Uri)

Ajoute une adresse de base à l'hôte du service.

System_CAPS_pubmethodAddDefaultEndpoints()

Ajoute des points de terminaison de service pour toutes les adresses de base dans chaque contrat trouvé dans l’hôte de service avec la liaison par défaut.

System_CAPS_pubmethodAddServiceEndpoint(ServiceEndpoint)

Ajoute le point de terminaison de service spécifié au service hébergé.

System_CAPS_pubmethodAddServiceEndpoint(String, Binding, String)

Ajoute un point de terminaison de service au service hébergé avec un contrat, une liaison et une adresse de point de terminaison spécifiés.

System_CAPS_pubmethodAddServiceEndpoint(String, Binding, String, Uri)

Ajoute un point de terminaison de service au service hébergé avec un contrat, une liaison, une adresse de point de terminaison et un URI spécifiés contenant l’adresse à partir de laquelle il écoute.

System_CAPS_pubmethodAddServiceEndpoint(String, Binding, Uri)

Ajoute un point de terminaison de service au service hébergé avec un contrat, une liaison et un URI contenant l’adresse de point de terminaison spécifiés.

System_CAPS_pubmethodAddServiceEndpoint(String, Binding, Uri, Uri)

Ajoute un point de terminaison de service au service hébergé avec le contrat, la liaison et les URI spécifiés contenant les adresses d’écoute et de point de terminaison.

System_CAPS_protmethodApplyConfiguration()

Charge les informations de description du service à partir du fichier de configuration et les applique au runtime en cours de construction.

System_CAPS_pubmethodBeginClose(AsyncCallback, Object)

Commence une opération asynchrone pour fermer un objet de communication.(Hérité de CommunicationObject.)

System_CAPS_pubmethodBeginClose(TimeSpan, AsyncCallback, Object)

Commence une opération asynchrone pour fermer un objet de communication avec un délai d'attente spécifié.(Hérité de CommunicationObject.)

System_CAPS_pubmethodBeginOpen(AsyncCallback, Object)

Commence une opération asynchrone pour ouvrir un objet de communication.(Hérité de CommunicationObject.)

System_CAPS_pubmethodBeginOpen(TimeSpan, AsyncCallback, Object)

Commence une opération asynchrone pour ouvrir un objet de communication dans un intervalle de temps spécifié.(Hérité de CommunicationObject.)

System_CAPS_pubmethodClose()

Provoque la transition d'un objet de communication de son état actuel à l'état fermé.(Hérité de CommunicationObject.)

System_CAPS_pubmethodClose(TimeSpan)

Provoque la transition d'un objet de communication de son état actuel à l'état fermé dans un intervalle de temps spécifié.(Hérité de CommunicationObject.)

System_CAPS_protmethodCreateDescription(IDictionary<String, ContractDescription>)

En cas d'implémentation dans une classe dérivée, crée la description du service hébergé.

System_CAPS_pubmethodEndClose(IAsyncResult)

Termine une opération asynchrone pour fermer un objet de communication.(Hérité de CommunicationObject.)

System_CAPS_pubmethodEndOpen(IAsyncResult)

Termine une opération asynchrone pour ouvrir un objet de communication.(Hérité de CommunicationObject.)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFault()

Provoque la transition d'un objet de communication de son état actuel à l'état d'erreur.(Hérité de CommunicationObject.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_protmethodGetCommunicationObjectType()

Obtient le type d'objet de communication.(Hérité de CommunicationObject.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodIncrementManualFlowControlLimit(Int32)

Augmente la limite du flux de messages vers le service hébergé d'un incrément spécifié.

System_CAPS_protmethodInitializeDescription(UriSchemeKeyedCollection)

Crée et initialise l'hôte du service à l'aide des descriptions du contrat et du service.

System_CAPS_protmethodInitializeRuntime()

Initialise le runtime pour l'hôte du service.

System_CAPS_protmethodLoadConfigurationSection(ServiceElement)

Charge l'élément de service à partir du fichier de configuration du service hébergé.

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodOnAbort()

Abandonne le service.(Remplace CommunicationObject.OnAbort().)

System_CAPS_protmethodOnBeginClose(TimeSpan, AsyncCallback, Object)

Lance une opération asynchrone appelée à la fermeture de l'hôte du service.(Remplace CommunicationObject.OnBeginClose(TimeSpan, AsyncCallback, Object).)

System_CAPS_protmethodOnBeginOpen(TimeSpan, AsyncCallback, Object)

Lance une opération asynchrone appelée à l'ouverture de l'hôte du service.(Remplace CommunicationObject.OnBeginOpen(TimeSpan, AsyncCallback, Object).)

System_CAPS_protmethodOnClose(TimeSpan)

Ferme le service hébergé, y compris ses répartiteurs de canal et les contextes d'instance et les écouteurs associés.(Remplace CommunicationObject.OnClose(TimeSpan).)

System_CAPS_protmethodOnClosed()

Libère les ressources utilisées par l'hôte du service.(Remplace CommunicationObject.OnClosed().)

System_CAPS_protmethodOnClosing()

Appelé pendant la transition d'un objet de communication à l'état de fermeture.(Hérité de CommunicationObject.)

System_CAPS_protmethodOnEndClose(IAsyncResult)

Exécute une opération asynchrone appelée à la fermeture de l'hôte du service.(Remplace CommunicationObject.OnEndClose(IAsyncResult).)

System_CAPS_protmethodOnEndOpen(IAsyncResult)

Exécute une opération asynchrone appelée à l'ouverture de l'hôte du service.(Remplace CommunicationObject.OnEndOpen(IAsyncResult).)

System_CAPS_protmethodOnFaulted()

Insère le traitement sur un objet de communication après sa transition vers l'état d'erreur en raison de l'appel d'une opération d'erreur synchrone.(Hérité de CommunicationObject.)

System_CAPS_protmethodOnOpen(TimeSpan)

Ouvre les répartiteurs de canal.(Remplace CommunicationObject.OnOpen(TimeSpan).)

System_CAPS_protmethodOnOpened()

Obtient les informations d'identification et le comportement d'autorisation et d'authentification du service pour le service hébergé.(Remplace CommunicationObject.OnOpened().)

System_CAPS_protmethodOnOpening()

Appelé pendant la transition d'un objet de communication à l'état d'ouverture.(Hérité de CommunicationObject.)

System_CAPS_pubmethodOpen()

Provoque la transition d'un objet de communication de l'état créé à l'état ouvert.(Hérité de CommunicationObject.)

System_CAPS_pubmethodOpen(TimeSpan)

Provoque la transition d'un objet de communication de l'état créé à l'état ouvert dans un intervalle de temps spécifié.(Hérité de CommunicationObject.)

System_CAPS_protmethodReleasePerformanceCounters()

Libère les compteurs de performance du service et du répartiteur de canal pour le service hébergé.

System_CAPS_pubmethodSetEndpointAddress(ServiceEndpoint, String)

Définit l'adresse du point de terminaison spécifiée sur l'adresse spécifiée.

System_CAPS_protmethodThrowIfDisposed()

Renvoie une exception si l'objet de communication est supprimé.(Hérité de CommunicationObject.)

System_CAPS_protmethodThrowIfDisposedOrImmutable()

Renvoie une exception si la propriété State de l'objet de communication n'a pas pour valeur l'état Created.(Hérité de CommunicationObject.)

System_CAPS_protmethodThrowIfDisposedOrNotOpen()

Renvoie une exception si l'objet de communication n'est pas dans l'état Opened.(Hérité de CommunicationObject.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

NomDescription
System_CAPS_pubeventClosed

Se produit lorsqu'un objet de communication passe à l'état fermé.(Hérité de CommunicationObject.)

System_CAPS_pubeventClosing

Se produit lorsqu'un objet de communication passe à l'état de fermeture.(Hérité de CommunicationObject.)

System_CAPS_pubeventFaulted

Se produit lorsqu'un objet de communication passe à l'état d'erreur.(Hérité de CommunicationObject.)

System_CAPS_pubeventOpened

Se produit lorsqu'un objet de communication passe à l'état ouvert.(Hérité de CommunicationObject.)

System_CAPS_pubeventOpening

Se produit lorsqu'un objet de communication passe à l'état d'ouverture.(Hérité de CommunicationObject.)

System_CAPS_pubeventUnknownMessageReceived

Se produit lorsqu'un message inconnu est reçu.

Utilisez la classe ServiceHostBase pour créer des hôtes fournissant un modèle de programmation personnalisé. Le modèle de programmation du service Windows Communication Foundation (WCF) utilise la classe ServiceHost.

Remarque spéciale destinée aux utilisateurs C++ managés dérivés de cette classe :

  • Placez votre code de nettoyage dans (On)(Begin)Close (et/ou OnAbort), pas dans un destructeur.

  • Évitez les destructeurs ; ils provoquent la génération automatique de IDisposable par le compilateur.

  • Évitez les membres sans référence ; ils peuvent provoquer la génération automatique de IDisposable par le compilateur.

  • Évitez les finaliseurs ; si vous en incluez un, vous devrez supprimer l'avertissement de génération et appeler SuppressFinalize(Object) et le finaliseur proprement dit à partir de (On)(Begin)Close (et/ou OnAbort) pour émuler ce qui aurait été le comportement IDisposable généré automatiquement.

Cet exemple utilise la classe ServiceHost dérivée 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 depuis 3.0

Tous les membres statiques (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Retour au début
Afficher:
© 2016 Microsoft