ChannelFactory Sınıf

Tanım

Ad Alanı:

System.ServiceModel

Bütünleştirilmiş Kod:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v8.0.0

Kaynak:

ChannelFactory.cs

İstemciler tarafından hizmet uç noktalarına ileti göndermek için kullanılan kanalları oluşturur ve yönetir.

public ref class ChannelFactory abstract : System::ServiceModel::Channels::CommunicationObject, IAsyncDisposable, IDisposable, System::ServiceModel::Channels::IChannelFactory

public abstract class ChannelFactory : System.ServiceModel.Channels.CommunicationObject, IAsyncDisposable, IDisposable, System.ServiceModel.Channels.IChannelFactory

type ChannelFactory = class
    inherit CommunicationObject
    interface IDisposable
    interface IChannelFactory
    interface ICommunicationObject
    interface IAsyncDisposable

Public MustInherit Class ChannelFactory
Inherits CommunicationObject
Implements IAsyncDisposable, IChannelFactory, IDisposable

Devralma

Object

CommunicationObject

ChannelFactory

Türetilmiş

System.ServiceModel.ChannelFactory<TChannel>

Uygulamalar

IDisposable IChannelFactory ICommunicationObject IAsyncDisposable

Örnekler

Aşağıdaki kod örneği, kanal nesnesini fabrika tarafından oluşturmadan önce program aracılığıyla istemci davranışının nasıl ekleyebileceğinizi gösterir.

public class Client
{
  public static void Main()
  {
    try
    {
      // Picks up configuration from the config file.
      ChannelFactory<ISampleServiceChannel> factory
        = new ChannelFactory<ISampleServiceChannel>("WSHttpBinding_ISampleService");

      // Add the client side behavior programmatically to all created channels.
      factory.Endpoint.Behaviors.Add(new EndpointBehaviorMessageInspector());

      ISampleServiceChannel wcfClientChannel = factory.CreateChannel();

      // Making calls.
      Console.WriteLine("Enter the greeting to send: ");
      string greeting = Console.ReadLine();
      Console.WriteLine("The service responded: " + wcfClientChannel.SampleMethod(greeting));

      Console.WriteLine("Press ENTER to exit:");
      Console.ReadLine();

      // Done with service.
      wcfClientChannel.Close();
      Console.WriteLine("Done!");
    }
    catch (TimeoutException timeProblem)
    {
      Console.WriteLine("The service operation timed out. " + timeProblem.Message);
      Console.Read();
    }
    catch (FaultException<SampleFault> fault)
    {
      Console.WriteLine("SampleFault fault occurred: {0}", fault.Detail.FaultMessage);
      Console.Read();
    }
    catch (CommunicationException commProblem)
    {
      Console.WriteLine("There was a communication problem. " + commProblem.Message);
      Console.Read();
    }
  }

Public Class Client
  Public Shared Sub Main()
    Try
      ' Picks up configuration from the config file.
      Dim factory As New ChannelFactory(Of ISampleServiceChannel)("WSHttpBinding_ISampleService")

      ' Add the client side behavior programmatically to all created channels.
      factory.Endpoint.Behaviors.Add(New EndpointBehaviorMessageInspector())

      Dim wcfClientChannel As ISampleServiceChannel = factory.CreateChannel()

      ' Making calls.
      Console.WriteLine("Enter the greeting to send: ")
            Dim greeting As String = Console.ReadLine()
      Console.WriteLine("The service responded: " & wcfClientChannel.SampleMethod(greeting))

      Console.WriteLine("Press ENTER to exit:")
      Console.ReadLine()

      ' Done with service. 
      wcfClientChannel.Close()
      Console.WriteLine("Done!")
    Catch timeProblem As TimeoutException
      Console.WriteLine("The service operation timed out. " & timeProblem.Message)
      Console.Read()
    Catch fault As FaultException(Of SampleFault)
      Console.WriteLine("SampleFault fault occurred: {0}", fault.Detail.FaultMessage)
      Console.Read()
    Catch commProblem As CommunicationException
      Console.WriteLine("There was a communication problem. " & commProblem.Message)
      Console.Read()
    End Try
  End Sub

Açıklamalar

IChannelFactory arabirimini uygulayan kanal fabrikaları ve ilişkili kanalları genellikle iletişim deseninin başlatıcıları tarafından kullanılır. IChannelListener arabirimini uygulayan dinleyici fabrikaları ve ilişkili dinleyicileri, kanalların iletişim için kabul edildiği mekanizmaları sağlar.

Bu sınıf kanal modelinin değil hizmet modelinin bir parçasıdır. CreateFactory yöntemi, hizmet uç noktası için IChannelFactory oluşturma araçları sağlar. Meta verileri veya ilkeyi kullanmadan hizmette arabirim sözleşmesine bağlı olan bir istemci oluşturmak için kullanın.

Not

ChannelFactory.Credentials.Windows.AllowedImpersonationLevel TokenImpersonationLevel.Anonymous olarak ayarlamak, kimliğe bürünme düzeyinden bağımsız olarak her zaman anonim oturum açmayla sonuçlanıyor.

Bu sınıftan türetilen Yönetilen C++ kullanıcıları için özel not:

• Temizleme kodunuzu bir yıkıcıya değil (On)(Begin)Close (ve/veya OnAbort) içine yerleştirin.

• Yıkıcılardan kaçının; derleyicinin IDisposableotomatik olarak oluşturmasına neden olurlar.

• Başvuru olmayan üyelerden kaçının; derleyicinin IDisposableotomatik olarak oluşturmasına neden olabilirler.

• Sonlandırıcı kullanmaktan kaçının; ancak bir tane eklerseniz, otomatik olarak oluşturulan IDisposable davranışına öykünmek için derleme uyarısını gizlemeniz ve SuppressFinalize(Object) ve sonlandırıcının kendisini (On)(Begin)Close (ve/veya OnAbort) öğesinden çağırmanız gerekir.

Program aracılığıyla davranış eklerken, davranış herhangi bir kanal oluşturulmadan önce ChannelFactory uygun Behaviors özelliğine eklenir. Kod örneği için örnek bölüme bakın.

Oluşturucular

ChannelFactory()

ChannelFactory sınıfının yeni bir örneğini başlatır.

Özellikler

Credentials	İstemciler tarafından fabrika tarafından üretilen kanallar üzerinden hizmet uç noktası iletişim kurmak için kullanılan kimlik bilgilerini alır.
DefaultCloseTimeout	Kapatma işleminin tamamlanması için sağlanan varsayılan zaman aralığını alır.
DefaultOpenTimeout	Açık işlemin tamamlanması için sağlanan varsayılan zaman aralığını alır.
Endpoint	Fabrika tarafından üretilen kanalların bağlandığı hizmet uç noktasını alır.
IsDisposed	İletişim nesnesinin atılıp atılmadığını gösteren bir değer alır. (Devralındığı yer: CommunicationObject)
State	İletişim nesnesinin geçerli durumunu gösteren bir değer alır. (Devralındığı yer: CommunicationObject)
ThisLock	Durum geçişi sırasında sınıf örneğini koruyan birbirini dışlayan kilidi alır. (Devralındığı yer: CommunicationObject)

Yöntemler

Abort()	İletişim nesnesinin geçerli durumundan kapanış durumuna hemen geçmesine neden olur. (Devralındığı yer: CommunicationObject)
BeginClose(AsyncCallback, Object)	İletişim nesnesini kapatmak için zaman uyumsuz bir işlem başlatır. (Devralındığı yer: CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	Belirtilen zaman aşımına sahip bir iletişim nesnesini kapatmak için zaman uyumsuz bir işlem başlatır. (Devralındığı yer: CommunicationObject)
BeginOpen(AsyncCallback, Object)	İletişim nesnesini açmak için zaman uyumsuz bir işlem başlatır. (Devralındığı yer: CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	Belirli bir zaman aralığı içinde bir iletişim nesnesini açmak için zaman uyumsuz bir işlem başlatır. (Devralındığı yer: CommunicationObject)
Close()	İletişim nesnesinin geçerli durumundan kapalı duruma geçmesine neden olur. (Devralındığı yer: CommunicationObject)
Close(TimeSpan)	Bir iletişim nesnesinin belirli bir zaman aralığı içinde geçerli durumundan kapalı duruma geçmesine neden olur. (Devralındığı yer: CommunicationObject)
CreateDescription()	Türetilmiş bir sınıfta uygulandığında, kanal fabrikasıyla ilişkili hizmet uç noktasının açıklamasını oluşturur.
CreateFactory()	Fabrikanın geçerli uç noktası için kanal fabrikasını oluşturur.
EndClose(IAsyncResult)	bir iletişim nesnesini kapatmak için zaman uyumsuz bir işlemi tamamlar. (Devralındığı yer: CommunicationObject)
EndOpen(IAsyncResult)	İletişim nesnesini açmak için zaman uyumsuz bir işlemi tamamlar. (Devralındığı yer: CommunicationObject)
EnsureOpened()	Henüz açılmamışsa geçerli kanal fabrikasını açar.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
Fault()	İletişim nesnesinin geçerli durumundan hatalı duruma geçmesine neden olur. (Devralındığı yer: CommunicationObject)
GetCommunicationObjectType()	İletişim nesnesinin türünü alır. (Devralındığı yer: CommunicationObject)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetProperty<T>()	Kanal yığınındaki uygun katmandan istenen türü belirtilen nesneyi veya yoksa null döndürür.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
InitializeEndpoint(Binding, EndpointAddress)	Kanal fabrikasının hizmet uç noktasını belirtilen bağlama ve adresle başlatır.
InitializeEndpoint(ServiceEndpoint)	Kanal fabrikasının hizmet uç noktasını belirtilen uç noktayla başlatır.
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
OnAbort()	Geçerli kanal fabrikasının iç kanal fabrikasını sonlandırır.
OnBeginClose(TimeSpan, AsyncCallback, Object)	İlişkili bir durum nesnesi olan geçerli kanal fabrikasının iç kanal fabrikasında zaman uyumsuz bir kapatma işlemi başlatır.
OnBeginOpen(TimeSpan, AsyncCallback, Object)	İlişkili bir durum nesnesi olan geçerli kanal fabrikasının iç kanal fabrikasında zaman uyumsuz bir açma işlemi başlatır.
OnClose(TimeSpan)	çağrıları, işlemin tamamlanması için belirtilen zaman aşımıyla iç kanal fabrikasında kapatır.
OnClosed()	bir iletişim nesnesinin kapanış durumuna geçişi sırasında çağrılır. (Devralındığı yer: CommunicationObject)
OnClosing()	bir iletişim nesnesinin kapanış durumuna geçişi sırasında çağrılır. (Devralındığı yer: CommunicationObject)
OnEndClose(IAsyncResult)	Geçerli kanal fabrikasının iç kanal fabrikasında zaman uyumsuz kapatma işlemini tamamlar.
OnEndOpen(IAsyncResult)	Geçerli kanal fabrikasının iç kanal fabrikasında zaman uyumsuz bir açma işlemini tamamlar.
OnFaulted()	Zaman uyumlu hata işleminin çağrılması nedeniyle hatalı duruma geçtikten sonra bir iletişim nesnesine işleme ekler. (Devralındığı yer: CommunicationObject)
OnOpen(TimeSpan)	İşlemin tamamlanması için belirtilen zaman aşımı ile geçerli kanal fabrikasının iç kanal fabrikasında açık çağrılar.
OnOpened()	Kanal fabrikası için ClientCredentials nesnesinin salt okunur bir kopyasını başlatır.
OnOpening()	Geçerli kanal için iç kanal fabrikasını oluşturur.
Open()	Bir iletişim nesnesinin oluşturulan durumdan açık duruma geçmesine neden olur. (Devralındığı yer: CommunicationObject)
Open(TimeSpan)	Bir iletişim nesnesinin belirli bir zaman aralığı içinde oluşturulan durumdan açık duruma geçmesine neden olur. (Devralındığı yer: CommunicationObject)
ThrowIfDisposed()	İletişim nesnesi atılırsa bir özel durum oluşturur. (Devralındığı yer: CommunicationObject)
ThrowIfDisposedOrImmutable()	State özelliği iletişim nesnesi Created durumuna ayarlanmadıysa bir özel durum oluşturur. (Devralındığı yer: CommunicationObject)
ThrowIfDisposedOrNotOpen()	İletişim nesnesi Opened durumunda değilse bir özel durum oluşturur. (Devralındığı yer: CommunicationObject)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Ekinlikler

Closed	bir iletişim nesnesi kapalı duruma geçtiğinde gerçekleşir. (Devralındığı yer: CommunicationObject)
Closing	bir iletişim nesnesi kapatma durumuna geçtiğinde gerçekleşir. (Devralındığı yer: CommunicationObject)
Faulted	bir iletişim nesnesi hatalı duruma geçtiğinde gerçekleşir. (Devralındığı yer: CommunicationObject)
Opened	bir iletişim nesnesi açık duruma geçtiğinde gerçekleşir. (Devralındığı yer: CommunicationObject)
Opening	bir iletişim nesnesi açma durumuna geçtiğinde gerçekleşir. (Devralındığı yer: CommunicationObject)

Belirtik Arabirim Kullanımları

IAsyncDisposable.DisposeAsync()	İstemciler tarafından hizmet uç noktalarına ileti göndermek için kullanılan kanalları oluşturur ve yönetir.
IDisposable.Dispose()	Geçerli kanal fabrikasını kapatır.

Uzantı Metotları

ConfigureAwait(IAsyncDisposable, Boolean)

Zaman uyumsuz bir atılabilir öğeden döndürülen görevlerde awaits işleminin nasıl gerçekleştirileceğini yapılandırılır.