WebChannelFactory<TChannel> Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Třída pro přístup k webovým službám wcf (Windows Communication Foundation) na klientovi.
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)Parametry typu
- TChannel
Typ kanálu, který chcete vytvořit.
- Dědičnost
Příklady
Následující kód ukazuje, jak pomocí WebChannelFactory<TChannel> třídy volat službu 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
Úplný příklad kódu naleznete v ukázce základního programovacího modelu REST WCF.
Poznámky
Tato třída je speciální ChannelFactory , která automaticky přidá WebHttpBehavior do koncového bodu, pokud ještě není k dispozici. Kromě toho přidá do koncového bodu výchozí hodnotu WebHttpBinding , pokud vazba není explicitně nakonfigurovaná a adresa je HTTP nebo HTTPS.
Pokud všechny operace kontraktu nemají žádnou návratovou hodnotu nebo mají návratovou hodnotu typu Stream, WebChannelFactory<TChannel> nakonfiguruje vazbu pro příslušný typ obsahu.
Konstruktory
| WebChannelFactory<TChannel>() |
Inicializuje novou instanci WebChannelFactory<TChannel> třídy. |
| WebChannelFactory<TChannel>(Binding) |
Inicializuje novou instanci WebChannelFactory<TChannel> třídy. |
| WebChannelFactory<TChannel>(Binding, Uri) |
Inicializuje novou instanci WebChannelFactory<TChannel> třídy se zadanou vazbou a Uri. |
| WebChannelFactory<TChannel>(ServiceEndpoint) |
Inicializuje novou instanci WebChannelFactory<TChannel> třídy. |
| WebChannelFactory<TChannel>(String) |
Inicializuje novou instanci WebChannelFactory<TChannel> třídy. |
| WebChannelFactory<TChannel>(String, Uri) |
Inicializuje novou instanci WebChannelFactory<TChannel> třídy se zadanou konfigurací koncového bodu a Uri. |
| WebChannelFactory<TChannel>(Type) |
Inicializuje novou instanci WebChannelFactory<TChannel> třídy. |
| WebChannelFactory<TChannel>(Uri) |
Inicializuje novou instanci WebChannelFactory<TChannel> třídy se zadaným Uri. |
Vlastnosti
| Credentials |
Získá přihlašovací údaje používané klienty ke komunikaci koncového bodu služby přes kanály vytvořené továrnou. (Zděděno od ChannelFactory) |
| DefaultCloseTimeout |
Získá výchozí interval času zadaný pro dokončení zavřené operace. (Zděděno od ChannelFactory) |
| DefaultOpenTimeout |
Získá výchozí interval času zadaný pro dokončení otevřené operace. (Zděděno od ChannelFactory) |
| Endpoint |
Získá koncový bod služby, ke kterému se kanály vytvořené propojením továrny. (Zděděno od ChannelFactory) |
| IsDisposed |
Získá hodnotu, která označuje, zda komunikační objekt byl odstraněn. (Zděděno od CommunicationObject) |
| State |
Získá hodnotu, která označuje aktuální stav komunikačního objektu. (Zděděno od CommunicationObject) |
| ThisLock |
Získá vzájemně vylučující zámek, který chrání instanci třídy během přechodu stavu. (Zděděno od CommunicationObject) |
Metody
| Abort() |
Způsobí, že komunikační objekt přejde okamžitě z aktuálního stavu do konečného stavu. (Zděděno od CommunicationObject) |
| ApplyConfiguration(String) |
Inicializuje objekt pro vytváření kanálů s chováním poskytovaným zadaným konfiguračním souborem a s těmi v koncovém bodu služby objektu pro vytváření kanálů. (Zděděno od ChannelFactory) |
| BeginClose(AsyncCallback, Object) |
Zahájí asynchronní operaci uzavření komunikačního objektu. (Zděděno od CommunicationObject) |
| BeginClose(TimeSpan, AsyncCallback, Object) |
Zahájí asynchronní operaci uzavření komunikačního objektu se zadaným časovým limitem. (Zděděno od CommunicationObject) |
| BeginOpen(AsyncCallback, Object) |
Zahájí asynchronní operaci otevření komunikačního objektu. (Zděděno od CommunicationObject) |
| BeginOpen(TimeSpan, AsyncCallback, Object) |
Zahájí asynchronní operaci otevření komunikačního objektu v zadaném časovém intervalu. (Zděděno od CommunicationObject) |
| Close() |
Způsobí přechod komunikačního objektu z aktuálního stavu do uzavřeného stavu. (Zděděno od CommunicationObject) |
| Close(TimeSpan) |
Způsobí, že komunikační objekt přejde z aktuálního stavu do uzavřeného stavu v zadaném časovém intervalu. (Zděděno od CommunicationObject) |
| CreateChannel() |
Vytvoří kanál zadaného typu na zadanou adresu koncového bodu. (Zděděno od ChannelFactory<TChannel>) |
| CreateChannel(EndpointAddress) |
Vytvoří kanál, který se používá k odesílání zpráv do služby na konkrétní adrese koncového bodu. (Zděděno od ChannelFactory<TChannel>) |
| CreateChannel(EndpointAddress, Uri) |
Vytvoří kanál, který se používá k odesílání zpráv do služby na konkrétní adrese koncového bodu prostřednictvím zadané přenosové adresy. (Zděděno od ChannelFactory<TChannel>) |
| CreateChannelWithActAsToken(SecurityToken) |
Vytvoří kanál, který se používá k odesílání zpráv do služby pomocí tokenu zabezpečení. (Zděděno od ChannelFactory<TChannel>) |
| CreateChannelWithActAsToken(SecurityToken, EndpointAddress) |
Vytvoří kanál, který se používá k odesílání zpráv do služby s tokenem zabezpečení na konkrétní adrese koncového bodu. (Zděděno od ChannelFactory<TChannel>) |
| CreateChannelWithActAsToken(SecurityToken, EndpointAddress, Uri) |
Vytvoří kanál, který se používá k odesílání zpráv do služby s tokenem zabezpečení na konkrétní adrese koncového bodu prostřednictvím zadané přenosové adresy. (Zděděno od ChannelFactory<TChannel>) |
| CreateChannelWithIssuedToken(SecurityToken) |
Vytvoří kanál, který se používá k odesílání zpráv do služby s vydaným tokenem zabezpečení. (Zděděno od ChannelFactory<TChannel>) |
| CreateChannelWithIssuedToken(SecurityToken, EndpointAddress) |
Vytvoří kanál, který se používá k odesílání zpráv do služby s vydaným tokenem zabezpečení na konkrétní adrese koncového bodu. (Zděděno od ChannelFactory<TChannel>) |
| CreateChannelWithIssuedToken(SecurityToken, EndpointAddress, Uri) |
Vytvoří kanál, který se používá k odesílání zpráv do služby s vydaným tokenem zabezpečení na konkrétní adrese koncového bodu prostřednictvím zadané přenosové adresy. (Zděděno od ChannelFactory<TChannel>) |
| CreateChannelWithOnBehalfOfToken(SecurityToken) |
Vytvoří kanál, který se používá k odesílání zpráv službě jménem tokenu zabezpečení. (Zděděno od ChannelFactory<TChannel>) |
| CreateChannelWithOnBehalfOfToken(SecurityToken, EndpointAddress) |
Vytvoří kanál, který se používá k odesílání zpráv službě jménem tokenu zabezpečení na konkrétní adrese koncového bodu. (Zděděno od ChannelFactory<TChannel>) |
| CreateChannelWithOnBehalfOfToken(SecurityToken, EndpointAddress, Uri) |
Vytvoří kanál, který se používá k odesílání zpráv službě jménem tokenu zabezpečení na konkrétní adrese koncového bodu prostřednictvím zadané přenosové adresy. (Zděděno od ChannelFactory<TChannel>) |
| CreateDescription() |
Vytvoří popis koncového bodu služby. (Zděděno od ChannelFactory<TChannel>) |
| CreateFactory() |
Vytvoří objekt pro vytváření kanálů pro aktuální koncový bod továrny. (Zděděno od ChannelFactory) |
| EndClose(IAsyncResult) |
Dokončí asynchronní operaci pro zavření komunikačního objektu. (Zděděno od CommunicationObject) |
| EndOpen(IAsyncResult) |
Dokončí asynchronní operaci pro otevření komunikačního objektu. (Zděděno od CommunicationObject) |
| EnsureOpened() |
Otevře aktuální objekt pro vytváření kanálů, pokud ještě není otevřen. (Zděděno od ChannelFactory) |
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| Fault() |
Způsobí přechod komunikačního objektu z aktuálního stavu do chybného stavu. (Zděděno od CommunicationObject) |
| GetCommunicationObjectType() |
Získá typ komunikačního objektu. (Zděděno od CommunicationObject) |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetProperty<T>() |
Vrátí požadovaný typ objektu z příslušné vrstvy v zásobníku kanálu nebo |
| GetType() |
Type Získá aktuální instanci. (Zděděno od Object) |
| InitializeEndpoint(Binding, EndpointAddress) |
Inicializuje koncový bod služby objektu pro vytváření kanálů se zadanou vazbou a adresou. (Zděděno od ChannelFactory) |
| InitializeEndpoint(ServiceEndpoint) |
Inicializuje koncový bod služby objektu pro vytváření kanálů se zadaným koncovým bodem. (Zděděno od ChannelFactory) |
| InitializeEndpoint(String, EndpointAddress) |
Inicializuje koncový bod služby objektu pro vytváření kanálů se zadanou adresou a konfigurací. (Zděděno od ChannelFactory) |
| MemberwiseClone() |
Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object) |
| OnAbort() |
Ukončí továrnu vnitřního kanálu aktuální továrny kanálu. (Zděděno od ChannelFactory) |
| OnBeginClose(TimeSpan, AsyncCallback, Object) |
Zahájí asynchronní operaci uzavření ve vnitřní továrně kanálu aktuální továrny kanálu, která má přidružený stavový objekt. (Zděděno od ChannelFactory) |
| OnBeginOpen(TimeSpan, AsyncCallback, Object) |
Zahájí asynchronní otevřenou operaci ve vnitřní továrně kanálu aktuální továrny kanálu, která má přidružený objekt stavu. (Zděděno od ChannelFactory) |
| OnClose(TimeSpan) |
Volání zavřená továrnu vnitřního kanálu se zadaným časovým limitem pro dokončení operace. (Zděděno od ChannelFactory) |
| OnClosed() |
Vyvoláno během přechodu komunikačního objektu do konečného stavu. (Zděděno od CommunicationObject) |
| OnClosing() |
Vyvoláno během přechodu komunikačního objektu do konečného stavu. (Zděděno od CommunicationObject) |
| OnEndClose(IAsyncResult) |
Dokončí asynchronní operaci uzavření ve vnitřní továrně kanálu aktuální továrny kanálu. (Zděděno od ChannelFactory) |
| OnEndOpen(IAsyncResult) |
Dokončí asynchronní otevřenou operaci ve vnitřní továrně kanálu aktuální továrny kanálu. (Zděděno od ChannelFactory) |
| OnFaulted() |
Vloží zpracování na komunikační objekt poté, co přejde do chybného stavu kvůli vyvolání synchronní operace selhání. (Zděděno od CommunicationObject) |
| OnOpen(TimeSpan) |
Volání otevřená v objektu pro vytvoření vnitřního kanálu aktuální továrny kanálu se zadaným časovým limitem pro dokončení operace. (Zděděno od ChannelFactory) |
| OnOpened() |
Inicializuje kopii objektu ClientCredentials jen pro čtení pro objekt pro vytváření kanálů. (Zděděno od ChannelFactory) |
| OnOpening() |
Tato metoda se volá při WebChannelFactory<TChannel> otevření. |
| Open() |
Způsobí přechod komunikačního objektu z vytvořeného stavu do otevřeného stavu. (Zděděno od CommunicationObject) |
| Open(TimeSpan) |
Způsobí přechod komunikačního objektu z vytvořeného stavu do otevřeného stavu v zadaném časovém intervalu. (Zděděno od CommunicationObject) |
| ThrowIfDisposed() |
Vyvolá výjimku, pokud je objekt komunikace odstraněn. (Zděděno od CommunicationObject) |
| ThrowIfDisposedOrImmutable() |
Vyvolá výjimku, pokud komunikační objekt State , který vlastnost není nastavena Created na stav. (Zděděno od CommunicationObject) |
| ThrowIfDisposedOrNotOpen() |
Vyvolá výjimku, pokud komunikační objekt není ve Opened stavu. (Zděděno od CommunicationObject) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
událost
| Closed |
Nastane, když komunikační objekt přejde do uzavřeného stavu. (Zděděno od CommunicationObject) |
| Closing |
Nastane, když komunikační objekt přejde do konečného stavu. (Zděděno od CommunicationObject) |
| Faulted |
Nastane, když komunikační objekt přejde do chybného stavu. (Zděděno od CommunicationObject) |
| Opened |
Nastane, když komunikační objekt přejde do otevřeného stavu. (Zděděno od CommunicationObject) |
| Opening |
Nastane, když komunikační objekt přejde do otevřeného stavu. (Zděděno od CommunicationObject) |
Explicitní implementace rozhraní
| IDisposable.Dispose() |
Zavře aktuální objekt pro vytváření kanálů. (Zděděno od ChannelFactory) |