ClientBase<TChannel> Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Hizmetleri çağırabilen Windows Communication Foundation (WCF) istemci nesneleri oluşturmak için kullanılan temel uygulamayı sağlar.
generic <typename TChannel>
where TChannel : classpublic ref class ClientBase abstract : System::ServiceModel::ICommunicationObject
generic <typename TChannel>
where TChannel : classpublic ref class ClientBase abstract : IAsyncDisposable, IDisposable, System::ServiceModel::ICommunicationObject
generic <typename TChannel>
where TChannel : classpublic ref class ClientBase abstract : IDisposable, System::ServiceModel::ICommunicationObject
public abstract class ClientBase<TChannel> : System.ServiceModel.ICommunicationObject where TChannel : class
public abstract class ClientBase<TChannel> : IAsyncDisposable, IDisposable, System.ServiceModel.ICommunicationObject where TChannel : class
public abstract class ClientBase<TChannel> : IDisposable, System.ServiceModel.ICommunicationObject where TChannel : class
type ClientBase<'Channel (requires 'Channel : null)> = class
interface ICommunicationObject
type ClientBase<'Channel (requires 'Channel : null)> = class
interface ICommunicationObject
interface IDisposable
interface IAsyncDisposable
type ClientBase<'Channel (requires 'Channel : null)> = class
interface ICommunicationObject
interface IDisposable
Public MustInherit Class ClientBase(Of TChannel)
Implements ICommunicationObject
Public MustInherit Class ClientBase(Of TChannel)
Implements IAsyncDisposable, ICommunicationObject, IDisposable
Public MustInherit Class ClientBase(Of TChannel)
Implements ICommunicationObject, IDisposable
Tür Parametreleri
- TChannel
Hizmete bağlanmak için kullanılacak kanal.
- Devralma
-
ClientBase<TChannel>
- Türetilmiş
- Uygulamalar
Örnekler
Aşağıdaki kod örneği , ServiceModel Meta Veri Yardımcı Programı Aracı'nın (Svcutil.exe) sınıfı bir WCF istemci sınıfı oluşturmak için nasıl genişletir ClientBase<TChannel> gösterir.
public partial class SampleServiceClient : System.ServiceModel.ClientBase<ISampleService>, ISampleService
{
public SampleServiceClient()
{
}
public SampleServiceClient(string endpointConfigurationName) :
base(endpointConfigurationName)
{
}
public SampleServiceClient(string endpointConfigurationName, string remoteAddress) :
base(endpointConfigurationName, remoteAddress)
{
}
public SampleServiceClient(string endpointConfigurationName, System.ServiceModel.EndpointAddress remoteAddress) :
base(endpointConfigurationName, remoteAddress)
{
}
public SampleServiceClient(System.ServiceModel.Channels.Binding binding, System.ServiceModel.EndpointAddress remoteAddress) :
base(binding, remoteAddress)
{
}
public string SampleMethod(string msg)
{
return base.Channel.SampleMethod(msg);
}
}
<System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "3.0.0.0")> _
Partial Public Class SampleServiceClient
Inherits System.ServiceModel.ClientBase(Of ISampleService)
Implements ISampleService
Public Sub New()
End Sub
Public Sub New(ByVal endpointConfigurationName As String)
MyBase.New(endpointConfigurationName)
End Sub
Public Sub New(ByVal endpointConfigurationName As String, ByVal remoteAddress As String)
MyBase.New(endpointConfigurationName, remoteAddress)
End Sub
Public Sub New(ByVal endpointConfigurationName As String, _
ByVal remoteAddress As System.ServiceModel.EndpointAddress)
MyBase.New(endpointConfigurationName, remoteAddress)
End Sub
Public Sub New(ByVal binding As System.ServiceModel.Channels.Binding, _
ByVal remoteAddress As System.ServiceModel.EndpointAddress)
MyBase.New(binding, remoteAddress)
End Sub
Public Function SampleMethod(ByVal msg As String) As String Implements ISampleService.SampleMethod
Return MyBase.Channel.SampleMethod(msg)
End Function
End Class
Açıklamalar
Sınıfını ClientBase<TChannel> genişleterek bir hizmete bağlanmak için kullanılabilecek özel bir WCF istemci nesnesi oluşturun. Genellikle WCF istemci temel sınıfı, sizin adınıza ServiceModel Meta Veri Yardımcı Programı Aracı (Svcutil.exe) gibi bir araç tarafından genişletilir. Örnek için Örnek bölümüne bakın.
sınıfı, ClientBase<TChannel> nesneleri arabirimlerin ve sınıfın kullanımına tercih eden geliştiriciler tarafından hızlı ve System.ServiceModel.ChannelFactory<TChannel> kolay bir şekilde kullanılabilir. Her durumda bu sınıf, sınıfın ve arabiriminin System.ServiceModel.ChannelFactory<TChannel> yöntemlerini ve işlevselliğini sarmalar veya System.ServiceModel.IClientChannel kullanıma sunar.
sınıfını System.ServiceModel.ServiceHost kullanırken olduğu gibi, herhangi bir çağrı yapmadan veya çağırmadan Openönce sınıfını oluşturabilir ve uç nokta, kanal fabrikası veya güvenlik bilgilerini değiştirebilirsiniz. Daha fazla bilgi için bkz . WCF İstemcisi'ne Genel Bakış ve WCF İstemcisi Kullanarak Hizmetlere Erişme.
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 otomatik olarak oluşturmasına IDisposableneden olur.
Başvuru olmayan üyelerden kaçının: derleyicinin otomatik olarak oluşturmasına IDisposableneden olabilirler.
Sonlandırıcılardan kaçının; ancak bir tane eklerseniz, otomatik olarak oluşturulan IDisposable davranışın ne olduğunu öykünmek için derleme uyarısını ve çağrısını SuppressFinalize(Object) ve sonlandırıcıyı (On)(Begin)Close (ve/veya OnAbort) öğesinden gizlemeniz gerekir.
Oluşturucular
ClientBase<TChannel>() |
Uygulama yapılandırma dosyasından ClientBase<TChannel> varsayılan hedef uç noktayı kullanarak sınıfının yeni bir örneğini başlatır. |
ClientBase<TChannel>(Binding, EndpointAddress) |
Belirtilen bağlamayı ve hedef adresi kullanarak sınıfın yeni bir örneğini ClientBase<TChannel> başlatır. |
ClientBase<TChannel>(InstanceContext) |
çift yönlü konuşmada ClientBase<TChannel> geri çağırma nesnesi olarak kullanarak |
ClientBase<TChannel>(InstanceContext, Binding, EndpointAddress) |
ClientBase<TChannel> sınıfının yeni bir örneğini başlatır. |
ClientBase<TChannel>(InstanceContext, ServiceEndpoint) |
Belirtilen InstanceContext ve ServiceEndpoint nesnelerini kullanarak sınıfının yeni bir örneğini ClientBase<TChannel> başlatır. |
ClientBase<TChannel>(InstanceContext, String) |
Belirtilen geri çağırma hizmeti ve uç nokta yapılandırma bilgilerini kullanarak sınıfının yeni bir örneğini ClientBase<TChannel> başlatır. |
ClientBase<TChannel>(InstanceContext, String, EndpointAddress) |
ClientBase<TChannel> sınıfının yeni bir örneğini başlatır. |
ClientBase<TChannel>(InstanceContext, String, String) |
ClientBase<TChannel> sınıfının yeni bir örneğini başlatır. |
ClientBase<TChannel>(ServiceEndpoint) |
Belirtilen ServiceEndpointöğesini kullanarak sınıfının yeni bir örneğini ClientBase<TChannel> başlatır. |
ClientBase<TChannel>(String) |
tarafından |
ClientBase<TChannel>(String, EndpointAddress) |
Belirtilen hedef adresi ve uç nokta bilgilerini kullanarak sınıfın yeni bir örneğini ClientBase<TChannel> başlatır. |
ClientBase<TChannel>(String, String) |
ClientBase<TChannel> sınıfının yeni bir örneğini başlatır. |
Özellikler
CacheSetting |
Önbellek ayarını alır veya ayarlar. |
Channel |
Çeşitli yapılandırılmış hizmet uç noktalarına ileti göndermek için kullanılan iç kanalı alır. |
ChannelFactory |
Temel alınan ChannelFactory<TChannel> nesneyi alır. |
ClientCredentials |
bir işlemi çağırmak için kullanılan istemci kimlik bilgilerini alır. |
Endpoint |
WCF istemcisinin bağlanabileceği hizmet için hedef uç noktayı alır. |
InnerChannel |
Temel alınan IClientChannel uygulamayı alır. |
State |
Nesnenin geçerli durumunu ClientBase<TChannel> alır. |
Yöntemler
Abort() |
Nesnenin ClientBase<TChannel> geçerli durumundan kapalı duruma hemen geçişine neden olur. |
Close() |
Nesnenin ClientBase<TChannel> geçerli durumundan kapalı duruma geçmesine neden olur. |
CloseAsync() |
Hizmetleri çağırabilen Windows Communication Foundation (WCF) istemci nesneleri oluşturmak için kullanılan temel uygulamayı sağlar. |
CreateChannel() |
Hizmete yeni bir kanal döndürür. |
DisplayInitializationUI() |
İç kanala, kullanmadan önce kanalı başlatmak için gerekliyse bir kullanıcı arabirimi görüntülemesini bildirir. |
Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
GetDefaultValueForInitialization<T>() |
C# dilinde varsayılan anahtar sözcüğün davranışını çoğaltır. |
GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
InvokeAsync(ClientBase<TChannel>.BeginOperationDelegate, Object[], ClientBase<TChannel>.EndOperationDelegate, SendOrPostCallback, Object) |
Olay tabanlı zaman uyumsuz deseni uygulamak için destek sağlar. Bu düzen hakkında daha fazla bilgi için bkz. Olay Tabanlı Zaman Uyumsuz Desene Genel Bakış. |
MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
Open() |
Nesnenin ClientBase<TChannel> oluşturulan durumdan açık duruma geçmesine neden olur. |
OpenAsync() |
Hizmetleri çağırabilen Windows Communication Foundation (WCF) istemci nesneleri oluşturmak için kullanılan temel uygulamayı sağlar. |
ToString() |
Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object) |
Belirtik Arabirim Kullanımları
IAsyncDisposable.DisposeAsync() |
Hizmetleri çağırabilen Windows Communication Foundation (WCF) istemci nesneleri oluşturmak için kullanılan temel uygulamayı sağlar. |
ICommunicationObject.BeginClose(AsyncCallback, Object) |
kapatmak için ClientBase<TChannel>zaman uyumsuz bir işlem başlatır. |
ICommunicationObject.BeginClose(TimeSpan, AsyncCallback, Object) |
belirtilen zaman aşımı ile kapatmak ClientBase<TChannel> için zaman uyumsuz bir işlem başlatır. |
ICommunicationObject.BeginOpen(AsyncCallback, Object) |
Nesneyi açmak ClientBase<TChannel> için zaman uyumsuz bir işlem başlatır. |
ICommunicationObject.BeginOpen(TimeSpan, AsyncCallback, Object) |
Nesneyi belirli bir zaman aralığı içinde açmak ClientBase<TChannel> için zaman uyumsuz bir işlem başlatır. |
ICommunicationObject.Close() |
İletişim nesnesinin geçerli durumundan kapalı duruma geçmesine neden olur. |
ICommunicationObject.Close(TimeSpan) |
Nesnenin ClientBase<TChannel> geçerli durumundan kapalı duruma geçmesine neden olur. |
ICommunicationObject.Closed |
Nesne geçerli durumundan kapalı duruma geçtiğinde ClientBase<TChannel> çağrılan olay işleyicisi. |
ICommunicationObject.Closing |
Nesne geçerli durumundan kapalı duruma geçtiğinde ClientBase<TChannel> çağrılan olay işleyicisi. |
ICommunicationObject.EndClose(IAsyncResult) |
Nesneyi kapatmak için zaman uyumsuz bir işlemi tamamlar ClientBase<TChannel> . |
ICommunicationObject.EndOpen(IAsyncResult) |
Nesneyi açmak için zaman uyumsuz bir işlemi tamamlar ClientBase<TChannel> . |
ICommunicationObject.Faulted |
Nesne üzerinde bir işlem gerçekleştirirken bir hata oluştuğunda çağrılan olay işleyicisi ClientBase<TChannel> . |
ICommunicationObject.Open() |
Bir iletişim nesnesinin oluşturulan durumdan açık duruma geçmesine neden olur. |
ICommunicationObject.Open(TimeSpan) |
Nesnenin ClientBase<TChannel> belirli bir süre içinde oluşturulan durumdan açık duruma geçmesine neden olur. |
ICommunicationObject.Opened |
Nesne oluşturulan durumdan açık duruma geçtiğinde ClientBase<TChannel> çağrılan olay işleyicisi. |
ICommunicationObject.Opening |
Nesne oluşturulan durumdan açık duruma geçtiğinde ClientBase<TChannel> çağrılan olay işleyicisi. |
IDisposable.Dispose() |
yönteminin Dispose() açık uygulaması. |
Uzantı Metotları
CloseHelperAsync(ICommunicationObject, TimeSpan) |
Hizmetleri çağırabilen Windows Communication Foundation (WCF) istemci nesneleri oluşturmak için kullanılan temel uygulamayı sağlar. |
OpenHelperAsync(ICommunicationObject, TimeSpan) |
Hizmetleri çağırabilen Windows Communication Foundation (WCF) istemci nesneleri oluşturmak için kullanılan temel uygulamayı sağlar. |
ConfigureAwait(IAsyncDisposable, Boolean) |
Zaman uyumsuz bir atılabilir öğeden döndürülen görevlerde awaits işleminin nasıl gerçekleştirildiğini yapılandırılır. |
Şunlara uygulanır
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin