NetTcpBinding Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Pengikatan yang aman dan andal yang cocok untuk komunikasi lintas komputer.
public ref class NetTcpBinding : System::ServiceModel::Channels::Binding
public ref class NetTcpBinding : System::ServiceModel::Channels::Binding, System::ServiceModel::Channels::IBindingRuntimePreferences
public class NetTcpBinding : System.ServiceModel.Channels.Binding
public class NetTcpBinding : System.ServiceModel.Channels.Binding, System.ServiceModel.Channels.IBindingRuntimePreferences
type NetTcpBinding = class
inherit Binding
type NetTcpBinding = class
inherit Binding
interface IBindingRuntimePreferences
Public Class NetTcpBinding
Inherits Binding
Public Class NetTcpBinding
Inherits Binding
Implements IBindingRuntimePreferences
- Warisan
- Turunan
- Penerapan
Contoh
Contoh ini menunjukkan cara membuat NetTcpBinding, mengatur mode keamanan dan jenis kredensial transportasi.
NetTcpBinding binding = new NetTcpBinding();
binding.Security.Mode = SecurityMode.Transport;
binding.Security.Transport.ClientCredentialType = TcpClientCredentialType.Certificate;
Keterangan
NetTcpBinding menghasilkan tumpukan komunikasi run-time secara default, yang menggunakan keamanan transportasi, TCP untuk pengiriman pesan, dan pengodean pesan biner. Pengikatan ini adalah pilihan yang disediakan sistem Windows Communication Foundation (WCF) yang sesuai untuk berkomunikasi melalui Intranet.
Konfigurasi default untuk NetTcpBinding lebih cepat daripada konfigurasi yang disediakan oleh WSHttpBinding, tetapi hanya ditujukan untuk komunikasi WCF. Perilaku keamanan dapat dikonfigurasi menggunakan parameter opsional securityMode di konstruktor. Penggunaan WS-ReliableMessaging dapat dikonfigurasi menggunakan parameter opsional reliableSessionEnabled . Tetapi pesan yang dapat diandalkan nonaktif secara default. Lebih umum lagi, pengikatan yang disediakan sistem HTTP seperti WSHttpBinding dan BasicHttpBinding dikonfigurasi untuk mengaktifkan semuanya secara default, sedangkan NetTcpBinding pengikatan menonaktifkan semuanya secara default sehingga Anda harus ikut serta untuk mendapatkan dukungan, misalnya, untuk salah satu spesifikasi WS-*. Ini berarti bahwa konfigurasi default untuk TCP lebih cepat dalam bertukar pesan antar titik akhir daripada yang dikonfigurasi untuk pengikatan HTTP secara default.
Warning
NetTcpBinding menggunakan pengumpulan koneksi TCP berdasarkan nama DNS host layanan dan nomor port yang didengarkan layanan. Ini berfungsi dengan baik ketika klien melakukan panggilan ke layanan yang berbeda pada port yang berbeda, atau layanan dihosting dalam satu proses dan berbagi port. Jika satu klien memanggil beberapa layanan yang berbagi port yang dihosting dalam proses yang berbeda, atau WAS/IIS dihosting, kumpulan sisi klien dapat menyebabkan masalah di mana koneksi ke Layanan A digunakan kembali untuk Layanan B, mengakibatkan pengecualian dilemparkan, koneksi dibatalkan, dan saluran baru yang dibuat. Untuk menghindari masalah ini, gunakan CustomBinding dan tentukan ConnectionPoolSettings.GroupName yang berbeda untuk setiap layanan yang berkomunikasi dengan klien.
Konstruktor
| Nama | Deskripsi |
|---|---|
| NetTcpBinding() |
Menginisialisasi instans baru dari kelas NetTcpBinding. |
| NetTcpBinding(SecurityMode, Boolean) |
Menginisialisasi instans NetTcpBinding baru kelas dengan jenis keamanan yang digunakan ditentukan dan dengan nilai yang menunjukkan apakah sesi yang andal diaktifkan secara eksplisit. |
| NetTcpBinding(SecurityMode) |
Menginisialisasi instans NetTcpBinding baru kelas dengan jenis keamanan yang digunakan yang ditentukan. |
| NetTcpBinding(String) |
Menginisialisasi instans NetTcpBinding baru kelas dengan nama konfigurasi tertentu. |
Properti
| Nama | Deskripsi |
|---|---|
| CloseTimeout |
Mendapatkan atau mengatur interval waktu yang disediakan agar koneksi ditutup sebelum transportasi menimbulkan pengecualian. (Diperoleh dari Binding) |
| EnvelopeVersion |
Mendapatkan versi SOAP yang digunakan untuk pesan yang diproses oleh pengikatan ini. |
| HostNameComparisonMode |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah nama host digunakan untuk menjangkau layanan saat mencocokkan URI. |
| ListenBacklog |
Mendapatkan atau mengatur jumlah maksimum permintaan koneksi antrean yang dapat tertunda. |
| MaxBufferPoolSize |
Mendapatkan atau mengatur ukuran maksimum, dalam byte, yang diizinkan untuk kumpulan buffer yang menyimpan pesan TCP yang diproses oleh pengikatan. |
| MaxBufferSize |
Mendapatkan atau menetapkan nilai yang menentukan ukuran maksimum, dalam byte, dari buffer yang digunakan untuk menyimpan pesan dalam memori. |
| MaxConnections |
Mendapatkan atau menetapkan nilai yang mengontrol jumlah maksimum koneksi yang akan dikumpulkan untuk penggunaan kembali berikutnya pada klien dan jumlah maksimum koneksi yang diizinkan untuk dikirim ke server yang tertunda. |
| MaxReceivedMessageSize |
Mendapatkan atau mengatur ukuran maksimum, dalam byte, untuk pesan yang diterima yang diproses oleh pengikatan. |
| MessageVersion |
Mendapatkan versi pesan yang digunakan oleh klien dan layanan yang dikonfigurasi dengan pengikatan. (Diperoleh dari Binding) |
| Name |
Mendapatkan atau mengatur nama pengikatan. (Diperoleh dari Binding) |
| Namespace |
Mendapatkan atau mengatur namespace XML pengikatan. (Diperoleh dari Binding) |
| OpenTimeout |
Mendapatkan atau mengatur interval waktu yang disediakan agar koneksi terbuka sebelum transportasi menimbulkan pengecualian. (Diperoleh dari Binding) |
| PortSharingEnabled |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah berbagi port TCP diaktifkan untuk koneksi yang dikonfigurasi dengan pengikatan ini. |
| ReaderQuotas |
Mendapatkan atau menetapkan batasan pada kompleksitas pesan SOAP yang dapat diproses oleh titik akhir yang dikonfigurasi dengan pengikatan ini. |
| ReceiveTimeout |
Mendapatkan atau mengatur interval waktu koneksi dapat tetap tidak aktif, di mana tidak ada pesan aplikasi yang diterima, sebelum dihilangkan. (Diperoleh dari Binding) |
| ReliableSession |
Mendapatkan objek yang menunjukkan apakah sesi yang andal dibuat di antara titik akhir saluran. |
| Scheme |
Mengembalikan skema URI untuk transportasi. |
| Security |
Mendapatkan objek yang menentukan jenis keamanan yang digunakan dengan layanan yang dikonfigurasi dengan pengikatan ini. |
| SendTimeout |
Mendapatkan atau mengatur interval waktu yang disediakan agar operasi tulis selesai sebelum transportasi menimbulkan pengecualian. (Diperoleh dari Binding) |
| TransactionFlow |
Mendapatkan atau menetapkan nilai yang menentukan apakah alur transaksi diaktifkan. |
| TransactionProtocol |
Mendapatkan atau mengatur protokol transaksi yang digunakan oleh layanan untuk mengalirkan transaksi. |
| TransferMode |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah layanan yang dikonfigurasi dengan pengikatan menggunakan mode transfer pesan yang dialirkan atau di-buffer (atau keduanya). |
Metode
| Nama | Deskripsi |
|---|---|
| BuildChannelFactory<TChannel>(BindingParameterCollection) |
Membangun tumpukan pabrik saluran pada klien yang membuat jenis saluran tertentu dan yang memenuhi fitur yang ditentukan oleh kumpulan parameter pengikatan. (Diperoleh dari Binding) |
| BuildChannelFactory<TChannel>(Object[]) |
Membangun tumpukan pabrik saluran pada klien yang membuat jenis saluran tertentu dan yang memenuhi fitur yang ditentukan oleh array objek. (Diperoleh dari Binding) |
| BuildChannelListener<TChannel>(BindingParameterCollection) |
Membangun pendengar saluran pada layanan yang menerima jenis saluran tertentu dan yang memenuhi fitur yang ditentukan oleh kumpulan parameter pengikatan. (Diperoleh dari Binding) |
| BuildChannelListener<TChannel>(Object[]) |
Membangun pendengar saluran pada layanan yang menerima jenis saluran tertentu dan yang memenuhi fitur yang ditentukan. (Diperoleh dari Binding) |
| BuildChannelListener<TChannel>(Uri, BindingParameterCollection) |
Membangun pendengar saluran pada layanan yang menerima jenis saluran tertentu dan yang memenuhi fitur yang ditentukan. (Diperoleh dari Binding) |
| BuildChannelListener<TChannel>(Uri, Object[]) |
Membangun pendengar saluran pada layanan yang menerima jenis saluran tertentu dan yang memenuhi fitur yang ditentukan. (Diperoleh dari Binding) |
| BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) |
Membangun pendengar saluran pada layanan yang menerima jenis saluran tertentu dan yang memenuhi fitur yang ditentukan. (Diperoleh dari Binding) |
| BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) |
Membangun pendengar saluran pada layanan yang menerima jenis saluran tertentu dan yang memenuhi fitur yang ditentukan. (Diperoleh dari Binding) |
| BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) |
Membangun pendengar saluran pada layanan yang menerima jenis saluran tertentu dan yang memenuhi fitur yang ditentukan. (Diperoleh dari Binding) |
| BuildChannelListener<TChannel>(Uri, String, Object[]) |
Membangun pendengar saluran pada layanan yang menerima jenis saluran tertentu dan yang memenuhi fitur yang ditentukan. (Diperoleh dari Binding) |
| CanBuildChannelFactory<TChannel>(BindingParameterCollection) |
Mengembalikan nilai yang menunjukkan apakah pengikatan saat ini dapat membangun tumpukan pabrik saluran pada klien yang memenuhi kumpulan parameter pengikatan yang ditentukan. (Diperoleh dari Binding) |
| CanBuildChannelFactory<TChannel>(Object[]) |
Mengembalikan nilai yang menunjukkan apakah pengikatan saat ini dapat membangun tumpukan pabrik saluran pada klien yang memenuhi persyaratan yang ditentukan oleh array objek. (Diperoleh dari Binding) |
| CanBuildChannelListener<TChannel>(BindingParameterCollection) |
Mengembalikan nilai yang menunjukkan apakah pengikatan saat ini dapat membangun tumpukan pendengar saluran pada layanan yang memenuhi kumpulan parameter pengikatan yang ditentukan. (Diperoleh dari Binding) |
| CanBuildChannelListener<TChannel>(Object[]) |
Mengembalikan nilai yang menunjukkan apakah pengikatan saat ini dapat membangun tumpukan pendengar saluran pada layanan yang memenuhi kriteria yang ditentukan dalam array objek. (Diperoleh dari Binding) |
| CreateBindingElements() |
Membuat koleksi dengan elemen pengikatan untuk pengikatan. |
| Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
| GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
| GetProperty<T>(BindingParameterCollection) |
Mengembalikan objek jenis yang diminta, jika ada, dari lapisan yang sesuai dalam tumpukan pengikatan. (Diperoleh dari Binding) |
| GetType() |
Mendapatkan Type instans saat ini. (Diperoleh dari Object) |
| MemberwiseClone() |
Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object) |
| ShouldSerializeListenBacklog() |
Mengembalikan nilai yang menunjukkan apakah ListenBacklog properti telah berubah dari nilai defaultnya dan harus diserialisasikan. |
| ShouldSerializeMaxConnections() |
Mengembalikan nilai yang menunjukkan apakah MaxConnections properti telah berubah dari nilai defaultnya dan harus diserialisasikan. |
| ShouldSerializeName() |
Mengembalikan apakah nama pengikatan harus diserialisasikan. (Diperoleh dari Binding) |
| ShouldSerializeNamespace() |
Mengembalikan apakah namespace pengikatan harus diserialisasikan. (Diperoleh dari Binding) |
| ShouldSerializeReaderQuotas() |
Mengembalikan nilai yang menunjukkan apakah ReaderQuotas properti telah berubah dari nilai defaultnya dan harus diserialisasikan. |
| ShouldSerializeReliableSession() |
Mengembalikan nilai yang menunjukkan apakah ReliableSession properti telah berubah dari nilai defaultnya dan harus diserialisasikan. |
| ShouldSerializeSecurity() |
Mengembalikan nilai yang menunjukkan apakah Security properti telah berubah dari nilai defaultnya dan harus diserialisasikan. |
| ShouldSerializeTransactionProtocol() |
Mengembalikan nilai yang menunjukkan apakah TransactionProtocol properti telah berubah dari nilai defaultnya dan harus diserialisasikan. |
| ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
Implementasi Antarmuka Eksplisit
| Nama | Deskripsi |
|---|---|
| IBindingRuntimePreferences.ReceiveSynchronously |
Mendapatkan nilai yang menunjukkan apakah permintaan masuk ditangani secara sinkron atau asinkron. |