WebChannelFactory<TChannel> Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Classe permettant d’accéder aux services web Windows Communication Foundation (WCF) sur un client.
generic <typename TChannel>
where TChannel : classpublic ref class WebChannelFactory : System::ServiceModel::ChannelFactory<TChannel>generic <typename TChannel>
public ref class WebChannelFactory : System::ServiceModel::ChannelFactory<TChannel>public class WebChannelFactory<TChannel> : System.ServiceModel.ChannelFactory<TChannel> where TChannel : classpublic class WebChannelFactory<TChannel> : System.ServiceModel.ChannelFactory<TChannel>type WebChannelFactory<'Channel (requires 'Channel : null)> = class
inherit ChannelFactory<'Channel (requires 'Channel : null)>type WebChannelFactory<'Channel> = class
inherit ChannelFactory<'Channel>Public Class WebChannelFactory(Of TChannel)
Inherits ChannelFactory(Of TChannel)Paramètres de type
- TChannel
Type de canal à créer.
- Héritage
Exemples
Le code suivant montre comment utiliser la WebChannelFactory<TChannel> classe pour appeler un service WCF.
Uri baseAddress = new Uri("http://localhost:8000");
WebServiceHost host = new WebServiceHost(typeof(Service), baseAddress);
try
{
host.Open();
WebChannelFactory<IService> cf = new WebChannelFactory<IService>(baseAddress);
IService channel = cf.CreateChannel();
string s;
Console.WriteLine("Calling EchoWithGet via HTTP GET: ");
s = channel.EchoWithGet("Hello, world");
Console.WriteLine(" Output: {0}", s);
Console.WriteLine("");
Console.WriteLine("Calling EchoWithPost via HTTP POST: ");
s = channel.EchoWithPost("Hello, world");
Console.WriteLine(" Output: {0}", s);
Console.WriteLine("");
}
catch (CommunicationException ex)
{
Console.WriteLine("An exception occurred: " + ex.Message);
}
Dim baseAddress As New Uri("http://localhost:8000")
Dim host As New WebServiceHost(GetType(Service), baseAddress)
Try
host.Open()
Dim cf As New WebChannelFactory(Of IService)(baseAddress)
Dim channel As IService = cf.CreateChannel()
Dim s As String
Console.WriteLine("Calling EchoWithGet via HTTP GET: ")
s = channel.EchoWithGet("Hello, world")
Console.WriteLine(" Output: 0}", s)
Console.WriteLine("")
Console.WriteLine("Calling EchoWithPost via HTTP POST: ")
s = channel.EchoWithPost("Hello, world")
Console.WriteLine(" Output: 0}", s)
Console.WriteLine("")
Catch ex As CommunicationException
Console.WriteLine("An exception occurred: " + ex.Message)
End Try
Pour obtenir un exemple de code complet, consultez l’exemple de modèle de programmation REST WCF de base.
Remarques
Cette classe est un ChannelFactory spécial qui ajoute automatiquement le WebHttpBehavior au point de terminaison s'il n'est pas déjà présent. En outre, il ajoute un WebHttpBinding par défaut au point de terminaison si la liaison n’est pas configurée explicitement et si l’adresse est de type HTTP ou HTTPS.
Si toutes les opérations du contrat n'ont aucune valeur de retour ou une valeur de retour de type Stream, le WebChannelFactory<TChannel> configure la liaison pour le type de contenu approprié.
Constructeurs
Propriétés
| Credentials |
Obtient les informations d'identification utilisées par les clients pour communiquer un point de terminaison de service sur les canaux générés par la fabrique. (Hérité de ChannelFactory) |
| DefaultCloseTimeout |
Obtient l'intervalle de temps par défaut fourni pour terminer une opération de fermeture. (Hérité de ChannelFactory) |
| DefaultOpenTimeout |
Obtient l'intervalle de temps par défaut fourni pour terminer une opération d'ouverture. (Hérité de ChannelFactory) |
| Endpoint |
Obtient le point de terminaison du service auquel se connectent les canaux générés par la fabrique. (Hérité de ChannelFactory) |
| IsDisposed |
Obtient une valeur qui indique si l'objet de communication a été supprimé. (Hérité de CommunicationObject) |
| State |
Obtient une valeur qui indique l'état actuel de l'objet de communication. (Hérité de CommunicationObject) |
| ThisLock |
Obtient le verrou mutuellement exclusif qui protège l'instance de classe pendant une transition d'état. (Hérité de CommunicationObject) |
Méthodes
| Abort() |
Provoque la transition immédiate d'un objet de communication de son état actuel à l'état de fermeture. (Hérité de CommunicationObject) |
| ApplyConfiguration(String) |
Initialise la fabrique de canal avec les comportements fournis par un fichier de configuration spécifié et avec ceux définis dans le point de terminaison du service de la fabrique de canal. (Hérité de ChannelFactory) |
| BeginClose(AsyncCallback, Object) |
Commence une opération asynchrone pour fermer un objet de communication. (Hérité de CommunicationObject) |
| BeginClose(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) |
| BeginOpen(AsyncCallback, Object) |
Commence une opération asynchrone pour ouvrir un objet de communication. (Hérité de CommunicationObject) |
| BeginOpen(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) |
| Close() |
Provoque la transition d'un objet de communication de son état actuel à l'état fermé. (Hérité de CommunicationObject) |
| Close(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) |
| CreateChannel() |
Crée un canal d'un type spécifié à une adresse de point de terminaison spécifiée. (Hérité de ChannelFactory<TChannel>) |
| CreateChannel(EndpointAddress) |
Crée un canal utilisé pour envoyer des messages à un service à une adresse de point de terminaison spécifique. (Hérité de ChannelFactory<TChannel>) |
| CreateChannel(EndpointAddress, Uri) |
Crée un canal utilisé pour envoyer des messages à un service à une adresse de point de terminaison spécifique via une adresse de transport spécifiée. (Hérité de ChannelFactory<TChannel>) |
| CreateChannelWithActAsToken(SecurityToken) |
Crée un canal utilisé pour envoyer des messages à un service agissant comme un jeton de sécurité. (Hérité de ChannelFactory<TChannel>) |
| CreateChannelWithActAsToken(SecurityToken, EndpointAddress) |
Crée un canal utilisé pour envoyer des messages à un service agissant comme un jeton de sécurité à une adresse de point de terminaison spécifique. (Hérité de ChannelFactory<TChannel>) |
| CreateChannelWithActAsToken(SecurityToken, EndpointAddress, Uri) |
Crée un canal utilisé pour envoyer des messages à un service agissant comme un jeton de sécurité à une adresse de point de terminaison spécifique via une adresse de transport spécifiée. (Hérité de ChannelFactory<TChannel>) |
| CreateChannelWithIssuedToken(SecurityToken) |
Crée un canal utilisé pour envoyer des messages à un service agissant comme un jeton de sécurité émis. (Hérité de ChannelFactory<TChannel>) |
| CreateChannelWithIssuedToken(SecurityToken, EndpointAddress) |
Crée un canal utilisé pour envoyer des messages à un service avec un jeton de sécurité émis à une adresse de point de terminaison spécifique. (Hérité de ChannelFactory<TChannel>) |
| CreateChannelWithIssuedToken(SecurityToken, EndpointAddress, Uri) |
Crée un canal utilisé pour envoyer des messages à un service avec un jeton de sécurité émis à une adresse de point de terminaison spécifique via une adresse de transport spécifiée. (Hérité de ChannelFactory<TChannel>) |
| CreateChannelWithOnBehalfOfToken(SecurityToken) |
Crée un canal utilisé pour envoyer des messages à un service agissant pour le compte d'un jeton de sécurité. (Hérité de ChannelFactory<TChannel>) |
| CreateChannelWithOnBehalfOfToken(SecurityToken, EndpointAddress) |
Crée un canal utilisé pour envoyer des messages à un service agissant pour le compte d'un jeton de sécurité à une adresse de point de terminaison spécifique. (Hérité de ChannelFactory<TChannel>) |
| CreateChannelWithOnBehalfOfToken(SecurityToken, EndpointAddress, Uri) |
Crée un canal utilisé pour envoyer des messages à un service agissant pour le compte du jeton de sécurité à une adresse de point de terminaison spécifique via une adresse de transport spécifiée. (Hérité de ChannelFactory<TChannel>) |
| CreateDescription() |
Crée une description du point de terminaison de service. (Hérité de ChannelFactory<TChannel>) |
| CreateFactory() |
Génère la fabrique de canal pour le point de terminaison actif de la fabrique. (Hérité de ChannelFactory) |
| EndClose(IAsyncResult) |
Termine une opération asynchrone pour fermer un objet de communication. (Hérité de CommunicationObject) |
| EndOpen(IAsyncResult) |
Termine une opération asynchrone pour ouvrir un objet de communication. (Hérité de CommunicationObject) |
| EnsureOpened() |
Ouvre la fabrique de canal active si elle n'est pas encore ouverte. (Hérité de ChannelFactory) |
| Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
| Fault() |
Provoque la transition d'un objet de communication de son état actuel à l'état d'erreur. (Hérité de CommunicationObject) |
| GetCommunicationObjectType() |
Obtient le type d'objet de communication. (Hérité de CommunicationObject) |
| GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
| GetProperty<T>() |
Retourne l'objet typé demandé (s'il existe) depuis la couche appropriée de la pile des canaux, ou la valeur |
| GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
| InitializeEndpoint(Binding, EndpointAddress) |
Initialise le point de terminaison du service de la fabrique de canal avec une liaison et une adresse spécifiées. (Hérité de ChannelFactory) |
| InitializeEndpoint(ServiceEndpoint) |
Initialise le point de terminaison du service de la fabrication de canal avec un point de terminaison spécifié. (Hérité de ChannelFactory) |
| InitializeEndpoint(String, EndpointAddress) |
Initialise le point de terminaison du service de la fabrique de canal avec une adresse et une configuration spécifiées. (Hérité de ChannelFactory) |
| MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
| OnAbort() |
Ferme la fabrication de canal interne de la fabrication de canal active. (Hérité de ChannelFactory) |
| OnBeginClose(TimeSpan, AsyncCallback, Object) |
Amorce une opération de fermeture asynchrone sur la fabrique de canal interne de la fabrique active à laquelle est associé un objet d'état. (Hérité de ChannelFactory) |
| OnBeginOpen(TimeSpan, AsyncCallback, Object) |
Amorce une opération d'ouverture asynchrone sur la fabrique de canal interne de la fabrique active à laquelle est associé un objet d'état. (Hérité de ChannelFactory) |
| OnClose(TimeSpan) |
Appelle la fermeture sur la fabrique de canal interne avec un délai d'attente spécifié pour l'achèvement de l'opération. (Hérité de ChannelFactory) |
| OnClosed() |
Appelé pendant la transition d'un objet de communication à l'état de fermeture. (Hérité de CommunicationObject) |
| OnClosing() |
Appelé pendant la transition d'un objet de communication à l'état de fermeture. (Hérité de CommunicationObject) |
| OnEndClose(IAsyncResult) |
Clôture une opération de fermeture asynchrone sur la fabrique de canal interne de la fabrique de canal actuelle. (Hérité de ChannelFactory) |
| OnEndOpen(IAsyncResult) |
Clôture une opération d'ouverture asynchrone sur la fabrique de canal interne de la fabrique de canal actuelle. (Hérité de ChannelFactory) |
| OnFaulted() |
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) |
| OnOpen(TimeSpan) |
Appelle l'ouverture sur la fabrique de canal interne de la fabrique active avec un délai d'attente spécifié pour l'achèvement de l'opération. (Hérité de ChannelFactory) |
| OnOpened() |
Initialise une copie en lecture seule de l'objet ClientCredentials pour la fabrique de canal. (Hérité de ChannelFactory) |
| OnOpening() |
Cette méthode est appelée lorsque le WebChannelFactory<TChannel> est ouvert. |
| Open() |
Provoque la transition d'un objet de communication de l'état créé à l'état ouvert. (Hérité de CommunicationObject) |
| Open(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) |
| ThrowIfDisposed() |
Renvoie une exception si l'objet de communication est supprimé. (Hérité de CommunicationObject) |
| ThrowIfDisposedOrImmutable() |
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) |
| ThrowIfDisposedOrNotOpen() |
Renvoie une exception si l'objet de communication n'est pas dans l'état Opened. (Hérité de CommunicationObject) |
| ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
Événements
| Closed |
Se produit lorsqu'un objet de communication passe à l'état fermé. (Hérité de CommunicationObject) |
| Closing |
Se produit lorsqu'un objet de communication passe à l'état de fermeture. (Hérité de CommunicationObject) |
| Faulted |
Se produit lorsqu'un objet de communication passe à l'état d'erreur. (Hérité de CommunicationObject) |
| Opened |
Se produit lorsqu'un objet de communication passe à l'état ouvert. (Hérité de CommunicationObject) |
| Opening |
Se produit lorsqu'un objet de communication passe à l'état d'ouverture. (Hérité de CommunicationObject) |
Implémentations d’interfaces explicites
| IDisposable.Dispose() |
Ferme la fabrication de canal active. (Hérité de ChannelFactory) |