WebChannelFactory<TChannel> Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Een klasse voor toegang tot Windows Communication Foundation (WCF)-webservices op een client.
generic <typename TChannel>
where TChannel : classpublic ref class WebChannelFactory : System::ServiceModel::ChannelFactory<TChannel>public class WebChannelFactory<TChannel> : System.ServiceModel.ChannelFactory<TChannel> where TChannel : classtype WebChannelFactory<'Channel (requires 'Channel : null)> = class
inherit ChannelFactory<'Channel (requires 'Channel : null)>Public Class WebChannelFactory(Of TChannel)
Inherits ChannelFactory(Of TChannel)Type parameters
- TChannel
Het type kanaal dat moet worden gemaakt.
- Overname
Voorbeelden
De volgende code laat zien hoe u de WebChannelFactory<TChannel> klasse gebruikt om een WCF-service aan te roepen.
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
Zie Basic WCF REST Programming Model Sample voor een volledig codevoorbeeld.
Opmerkingen
Deze klasse is een speciale ChannelFactory klasse die het WebHttpBehavior automatisch toevoegt aan het eindpunt als deze nog niet aanwezig is. Bovendien wordt er een standaardwaarde WebHttpBinding toegevoegd aan het eindpunt als de binding niet expliciet is geconfigureerd en het adres een HTTP- of HTTPS-adres is.
Als alle bewerkingen van het contract geen retourwaarde hebben of een retourwaarde van het type Streamhebben, configureert de WebChannelFactory<TChannel> binding voor het juiste inhoudstype.
Constructors
Eigenschappen
| Name | Description |
|---|---|
| Credentials |
Hiermee haalt u de referenties op die door clients worden gebruikt om een service-eindpunt te communiceren via de kanalen die door de fabriek worden geproduceerd. (Overgenomen van ChannelFactory) |
| DefaultCloseTimeout |
Hiermee wordt het standaardinterval van de tijd opgegeven voor een sluitingsbewerking voltooid. (Overgenomen van ChannelFactory) |
| DefaultOpenTimeout |
Hiermee haalt u het standaardinterval van de tijd op dat een geopende bewerking moet worden voltooid. (Overgenomen van ChannelFactory) |
| Endpoint |
Hiermee haalt u het service-eindpunt op waarnaar de kanalen die door de fabriek worden geproduceerd, verbinding maken. (Overgenomen van ChannelFactory) |
| IsDisposed |
Hiermee wordt een waarde opgehaald die aangeeft of het communicatieobject is verwijderd. (Overgenomen van CommunicationObject) |
| State |
Hiermee wordt een waarde opgehaald die de huidige status van het communicatieobject aangeeft. (Overgenomen van CommunicationObject) |
| ThisLock |
Hiermee haalt u de wederzijds exclusieve vergrendeling op die het klasse-exemplaar beschermt tijdens een statusovergang. (Overgenomen van CommunicationObject) |
Methoden
| Name | Description |
|---|---|
| Abort() |
Zorgt ervoor dat een communicatieobject onmiddellijk van de huidige status overgaat naar de slotstatus. (Overgenomen van CommunicationObject) |
| ApplyConfiguration(String) |
Initialiseert de kanaalfactory met het gedrag van een opgegeven configuratiebestand en met die in het service-eindpunt van de kanaalfactory. (Overgenomen van ChannelFactory) |
| BeginClose(AsyncCallback, Object) |
Hiermee wordt een asynchrone bewerking gestart om een communicatieobject te sluiten. (Overgenomen van CommunicationObject) |
| BeginClose(TimeSpan, AsyncCallback, Object) |
Hiermee wordt een asynchrone bewerking gestart om een communicatieobject met een opgegeven time-out te sluiten. (Overgenomen van CommunicationObject) |
| BeginOpen(AsyncCallback, Object) |
Begint een asynchrone bewerking om een communicatieobject te openen. (Overgenomen van CommunicationObject) |
| BeginOpen(TimeSpan, AsyncCallback, Object) |
Begint een asynchrone bewerking om een communicatieobject binnen een opgegeven tijdsinterval te openen. (Overgenomen van CommunicationObject) |
| Close() |
Zorgt ervoor dat een communicatieobject van de huidige status overgaat naar de gesloten status. (Overgenomen van CommunicationObject) |
| Close(TimeSpan) |
Zorgt ervoor dat een communicatieobject binnen een opgegeven tijdsinterval van de huidige status overgaat naar de gesloten status. (Overgenomen van CommunicationObject) |
| CreateChannel() |
Hiermee maakt u een kanaal van een opgegeven type naar een opgegeven eindpuntadres. (Overgenomen van ChannelFactory<TChannel>) |
| CreateChannel(EndpointAddress, Uri) |
Hiermee maakt u een kanaal dat wordt gebruikt voor het verzenden van berichten naar een service op een specifiek eindpuntadres via een opgegeven transportadres. (Overgenomen van ChannelFactory<TChannel>) |
| CreateChannel(EndpointAddress) |
Hiermee maakt u een kanaal dat wordt gebruikt voor het verzenden van berichten naar een service op een specifiek eindpuntadres. (Overgenomen van ChannelFactory<TChannel>) |
| CreateChannelWithActAsToken(SecurityToken, EndpointAddress, Uri) |
Hiermee maakt u een kanaal dat wordt gebruikt om berichten naar een service te verzenden met een beveiligingstoken op een specifiek eindpuntadres via een opgegeven transportadres. (Overgenomen van ChannelFactory<TChannel>) |
| CreateChannelWithActAsToken(SecurityToken, EndpointAddress) |
Hiermee maakt u een kanaal dat wordt gebruikt om berichten naar een service te verzenden met een beveiligingstoken op een specifiek eindpuntadres. (Overgenomen van ChannelFactory<TChannel>) |
| CreateChannelWithActAsToken(SecurityToken) |
Hiermee maakt u een kanaal dat wordt gebruikt voor het verzenden van berichten naar een service met een actie als beveiligingstoken. (Overgenomen van ChannelFactory<TChannel>) |
| CreateChannelWithIssuedToken(SecurityToken, EndpointAddress, Uri) |
Hiermee maakt u een kanaal dat wordt gebruikt voor het verzenden van berichten naar een service met een uitgegeven beveiligingstoken op een specifiek eindpuntadres via een opgegeven transportadres. (Overgenomen van ChannelFactory<TChannel>) |
| CreateChannelWithIssuedToken(SecurityToken, EndpointAddress) |
Hiermee maakt u een kanaal dat wordt gebruikt voor het verzenden van berichten naar een service met een uitgegeven beveiligingstoken op een specifiek eindpuntadres. (Overgenomen van ChannelFactory<TChannel>) |
| CreateChannelWithIssuedToken(SecurityToken) |
Hiermee maakt u een kanaal dat wordt gebruikt voor het verzenden van berichten naar een service met een uitgegeven beveiligingstoken. (Overgenomen van ChannelFactory<TChannel>) |
| CreateChannelWithOnBehalfOfToken(SecurityToken, EndpointAddress, Uri) |
Hiermee maakt u een kanaal dat wordt gebruikt voor het verzenden van berichten naar een service met een beveiligingstoken namens een specifiek eindpuntadres via een opgegeven transportadres. (Overgenomen van ChannelFactory<TChannel>) |
| CreateChannelWithOnBehalfOfToken(SecurityToken, EndpointAddress) |
Hiermee maakt u een kanaal dat wordt gebruikt voor het verzenden van berichten naar een service met een namens een beveiligingstoken op een specifiek eindpuntadres. (Overgenomen van ChannelFactory<TChannel>) |
| CreateChannelWithOnBehalfOfToken(SecurityToken) |
Hiermee maakt u een kanaal dat wordt gebruikt voor het verzenden van berichten naar een service met een namens het beveiligingstoken. (Overgenomen van ChannelFactory<TChannel>) |
| CreateDescription() |
Hiermee maakt u een beschrijving van het service-eindpunt. (Overgenomen van ChannelFactory<TChannel>) |
| CreateFactory() |
Hiermee wordt de kanaalfactory gebouwd voor het huidige eindpunt van de factory. (Overgenomen van ChannelFactory) |
| EndClose(IAsyncResult) |
Hiermee voltooit u een asynchrone bewerking om een communicatieobject te sluiten. (Overgenomen van CommunicationObject) |
| EndOpen(IAsyncResult) |
Voltooit een asynchrone bewerking om een communicatieobject te openen. (Overgenomen van CommunicationObject) |
| EnsureOpened() |
Hiermee opent u de huidige kanaalfactory als deze nog niet is geopend. (Overgenomen van ChannelFactory) |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| Fault() |
Zorgt ervoor dat een communicatieobject wordt overgezet van de huidige status naar de foutieve status. (Overgenomen van CommunicationObject) |
| GetCommunicationObjectType() |
Hiermee wordt het type communicatieobject opgehaald. (Overgenomen van CommunicationObject) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetProperty<T>() |
Retourneert het aangevraagde getypte object, indien aanwezig, van de juiste laag in de kanaalstack of |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| InitializeEndpoint(Binding, EndpointAddress) |
Initialiseert het service-eindpunt van de kanaalfactory met een opgegeven binding en een opgegeven adres. (Overgenomen van ChannelFactory) |
| InitializeEndpoint(ServiceEndpoint) |
Initialiseert het service-eindpunt van de kanaalfactory met een opgegeven eindpunt. (Overgenomen van ChannelFactory) |
| InitializeEndpoint(String, EndpointAddress) |
Initialiseert het service-eindpunt van de kanaalfactory met een opgegeven adres en configuratie. (Overgenomen van ChannelFactory) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| OnAbort() |
Hiermee wordt de binnenste kanaalfactory van de huidige kanaalfactory beëindigd. (Overgenomen van ChannelFactory) |
| OnBeginClose(TimeSpan, AsyncCallback, Object) |
Hiermee begint u een asynchrone sluitingsbewerking op de binnenkanaalfactory van de huidige kanaalfactory waaraan een statusobject is gekoppeld. (Overgenomen van ChannelFactory) |
| OnBeginOpen(TimeSpan, AsyncCallback, Object) |
Hiermee wordt een asynchrone open bewerking gestart op de binnenkanaalfactory van de huidige kanaalfactory waaraan een statusobject is gekoppeld. (Overgenomen van ChannelFactory) |
| OnClose(TimeSpan) |
Aanroepen sluiten op de binnenste kanaalfactory met een opgegeven time-out voor de voltooiing van de bewerking. (Overgenomen van ChannelFactory) |
| OnClosed() |
Aangeroepen tijdens de overgang van een communicatieobject in de slotstatus. (Overgenomen van CommunicationObject) |
| OnClosing() |
Aangeroepen tijdens de overgang van een communicatieobject in de slotstatus. (Overgenomen van CommunicationObject) |
| OnEndClose(IAsyncResult) |
Hiermee voltooit u een asynchrone sluitingsbewerking op de binnenkanaalfactory van de huidige kanaalfactory. (Overgenomen van ChannelFactory) |
| OnEndOpen(IAsyncResult) |
Hiermee voltooit u een asynchrone open bewerking op de binnenkanaalfactory van de huidige kanaalfactory. (Overgenomen van ChannelFactory) |
| OnFaulted() |
Hiermee wordt de verwerking van een communicatieobject ingevoegd nadat het is overgeschakeld naar de status Met fouten als gevolg van de aanroep van een synchrone foutbewerking. (Overgenomen van CommunicationObject) |
| OnOpen(TimeSpan) |
Aanroepen worden geopend op de binnenste kanaalfactory van de huidige kanaalfactory met een opgegeven time-out voor de voltooiing van de bewerking. (Overgenomen van ChannelFactory) |
| OnOpened() |
Initialiseert een alleen-lezen kopie van het ClientCredentials object voor de kanaalfactory. (Overgenomen van ChannelFactory) |
| OnOpening() |
Deze methode wordt aangeroepen wanneer de WebChannelFactory<TChannel> methode wordt geopend. |
| Open() |
Zorgt ervoor dat een communicatieobject wordt overgezet van de gemaakte status in de geopende status. (Overgenomen van CommunicationObject) |
| Open(TimeSpan) |
Zorgt ervoor dat een communicatieobject binnen een opgegeven tijdsinterval van de gemaakte status overgaat naar de geopende status. (Overgenomen van CommunicationObject) |
| ThrowIfDisposed() |
Genereert een uitzondering als het communicatieobject wordt verwijderd. (Overgenomen van CommunicationObject) |
| ThrowIfDisposedOrImmutable() |
Genereert een uitzondering als het communicatieobject de State eigenschap niet is ingesteld op de Created status. (Overgenomen van CommunicationObject) |
| ThrowIfDisposedOrNotOpen() |
Genereert een uitzondering als het communicatieobject niet de Opened status heeft. (Overgenomen van CommunicationObject) |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |
gebeurtenis
| Name | Description |
|---|---|
| Closed |
Treedt op wanneer een communicatieobject overgaat naar de gesloten status. (Overgenomen van CommunicationObject) |
| Closing |
Treedt op wanneer een communicatieobject overgaat naar de slotstatus. (Overgenomen van CommunicationObject) |
| Faulted |
Treedt op wanneer een communicatieobject overgaat naar de foutieve status. (Overgenomen van CommunicationObject) |
| Opened |
Treedt op wanneer een communicatieobject overgaat naar de geopende status. (Overgenomen van CommunicationObject) |
| Opening |
Treedt op wanneer een communicatieobject overgaat naar de openingsstatus. (Overgenomen van CommunicationObject) |
Expliciete interface-implementaties
| Name | Description |
|---|---|
| IDisposable.Dispose() |
Hiermee sluit u de huidige kanaalfactory. (Overgenomen van ChannelFactory) |