NetTcpBinding Класс

Определение

Пространство имен:: System.ServiceModel

Сборки:: System.ServiceModel.dll, System.ServiceModel.NetTcp.dll

Сборка:: System.ServiceModel.NetTcp.dll

Сборка:: System.ServiceModel.dll

Пакеты:: System.ServiceModel.NetTcp v10.0.652802, System.ServiceModel.Primitives v10.0.652802

Пакет:: System.ServiceModel.NetTcp v10.0.652802

Исходный код:: NetTcpBinding.cs

Исходный код:: NetTcpBinding.cs

Исходный код:: NetTcpBinding.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Безопасная надежная привязка, подходящая для обмена данными между компьютерами.

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

Наследование: Object

Binding
NetTcpBinding

Производный: System.ServiceModel.NetTcpContextBinding

Реализации: IBindingRuntimePreferences

Примеры

В этом примере показано, как создать NetTcpBindingрежим безопасности и тип учетных данных транспорта.

NetTcpBinding binding = new NetTcpBinding();
binding.Security.Mode = SecurityMode.Transport;
binding.Security.Transport.ClientCredentialType = TcpClientCredentialType.Certificate;

По NetTcpBinding умолчанию создается стек обмена данными во время выполнения, который использует транспортную безопасность, TCP для доставки сообщений и кодировку двоичных сообщений. Эта привязка — это подходящий системный вариант Windows Communication Foundation (WCF) для обмена данными по интрасети.

Конфигурация по умолчанию NetTcpBinding быстрее, чем конфигурация, предоставляемая этим WSHttpBindingпараметром, но предназначена только для обмена данными WCF. Поведение безопасности настраивается с помощью необязательного securityMode параметра в конструкторе. Использование WS-ReliableMessaging настраивается с помощью необязательного reliableSessionEnabled параметра. Но надежная передача сообщений отключена по умолчанию. Как правило, привязки, предоставляемые системой HTTP, такие как WSHttpBinding и BasicHttpBinding настроены для включения вещей по умолчанию, в то время NetTcpBinding как привязка отключает вещи по умолчанию, чтобы получить поддержку, например для одной из спецификаций WS-* . Это означает, что конфигурация по умолчанию для TCP быстрее обмениваются сообщениями между конечными точками, чем настроенная для привязок HTTP по умолчанию.

Предупреждение

Используется NetTcpBinding пул tcp-подключений на основе DNS-имени узла службы и номера порта, в котором служба прослушивается. Это хорошо работает, когда клиент выполняет вызовы к разным службам в разных портах или службах размещаются в одном процессе и совместно используют порт. Если один клиент вызывает несколько служб, которым предоставляется общий доступ к порту, размещенному в разных процессах, или размещено В/IIS, пул на стороне клиента может привести к проблемам, когда подключение к службе A повторно используется для службы B, что приводит к возникновению исключения, прерыванию соединения и созданию нового канала. Чтобы избежать этой проблемы, используйте CustomBinding и укажите другое имя ConnectionPoolSettings.GroupName для каждой службы, с которым клиент взаимодействует.

Конструкторы

Имя	Описание
NetTcpBinding()	Инициализирует новый экземпляр класса NetTcpBinding.
NetTcpBinding(SecurityMode, Boolean)	Инициализирует новый экземпляр NetTcpBinding класса с заданным типом безопасности, указанным и значением, указывающим, включены ли надежные сеансы явным образом.
NetTcpBinding(SecurityMode)	Инициализирует новый экземпляр NetTcpBinding класса с заданным типом безопасности.
NetTcpBinding(String)	Инициализирует новый экземпляр NetTcpBinding класса с указанным именем конфигурации.

Свойства

Имя	Описание
CloseTimeout	Возвращает или задает интервал времени, предоставленный для закрытия соединения перед тем, как транспорт вызывает исключение. (Унаследовано от Binding)
EnvelopeVersion	Возвращает версию SOAP, которая используется для сообщений, обработанных этой привязкой.
HostNameComparisonMode	Возвращает или задает значение, указывающее, используется ли имя узла для достижения службы при сопоставлении URI.
ListenBacklog	Возвращает или задает максимальное количество запросов на подключение в очереди, которые могут быть ожидающими.
MaxBufferPoolSize	Возвращает или задает максимальный размер в байтах, разрешенный для буферного пула, в котором хранятся TCP-сообщения, обработанные привязкой.
MaxBufferSize	Возвращает или задает значение, указывающее максимальный размер буфера, используемого для хранения сообщений в памяти.
MaxConnections	Возвращает или задает значение, которое управляет максимальным количеством подключений, которые будут использоваться для последующего повторного использования на клиенте, и максимальное количество подключений, разрешенных для ожидания отправки на сервере.
MaxReceivedMessageSize	Возвращает или задает максимальный размер в байтах для полученного сообщения, обрабатываемого привязкой.
MessageVersion	Возвращает версию сообщения, используемую клиентами и службами, настроенными с привязкой. (Унаследовано от Binding)
Name	Возвращает или задает имя привязки. (Унаследовано от Binding)
Namespace	Возвращает или задает пространство имен XML привязки. (Унаследовано от Binding)
OpenTimeout	Возвращает или задает интервал времени, предоставленный для открытия подключения, прежде чем транспорт вызывает исключение. (Унаследовано от Binding)
PortSharingEnabled	Возвращает или задает значение, указывающее, включен ли общий доступ к TCP-порту для подключения, настроенного с этой привязкой.
ReaderQuotas	Возвращает или задает ограничения сложности сообщений SOAP, которые могут обрабатываться конечными точками, настроенными с помощью этой привязки.
ReceiveTimeout	Возвращает или задает интервал времени, в течение которого соединение не может оставаться неактивным, в течение которого сообщения приложения не будут получены до удаления. (Унаследовано от Binding)
ReliableSession	Возвращает объект, указывающий, установлен ли надежный сеанс между конечными точками канала.
Scheme	Возвращает схему URI для транспорта.
Security	Возвращает объект, указывающий тип безопасности, используемый службами, настроенными с этой привязкой.
SendTimeout	Возвращает или задает интервал времени, предоставленный для выполнения операции записи перед тем, как транспорт вызывает исключение. (Унаследовано от Binding)
TransactionFlow	Возвращает или задает значение, определяющее, включен ли поток транзакций.
TransactionProtocol	Возвращает или задает протокол транзакций, используемый службой для потоковой транзакции.
TransferMode	Возвращает или задает значение, указывающее, используется ли служба, настроенная с привязкой, использует потоковый или буферный (или оба) режима передачи сообщений.

Методы

Имя	Описание
BuildChannelFactory<TChannel>(BindingParameterCollection)	Создает стек фабрики каналов на клиенте, который создает указанный тип канала и удовлетворяет функциям, указанным в коллекции параметров привязки. (Унаследовано от Binding)
BuildChannelFactory<TChannel>(Object[])	Создает стек фабрики каналов на клиенте, который создает указанный тип канала и удовлетворяет функциям, указанным массивом объектов. (Унаследовано от Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)	Создает прослушиватель каналов в службе, которая принимает указанный тип канала и удовлетворяет функциям, указанным в коллекции параметров привязки. (Унаследовано от Binding)
BuildChannelListener<TChannel>(Object[])	Создает прослушиватель каналов в службе, которая принимает указанный тип канала и удовлетворяет указанным функциям. (Унаследовано от Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)	Создает прослушиватель каналов в службе, которая принимает указанный тип канала и удовлетворяет указанным функциям. (Унаследовано от Binding)
BuildChannelListener<TChannel>(Uri, Object[])	Создает прослушиватель каналов в службе, которая принимает указанный тип канала и удовлетворяет указанным функциям. (Унаследовано от Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)	Создает прослушиватель каналов в службе, которая принимает указанный тип канала и удовлетворяет указанным функциям. (Унаследовано от Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)	Создает прослушиватель каналов в службе, которая принимает указанный тип канала и удовлетворяет указанным функциям. (Унаследовано от Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])	Создает прослушиватель каналов в службе, которая принимает указанный тип канала и удовлетворяет указанным функциям. (Унаследовано от Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])	Создает прослушиватель каналов в службе, которая принимает указанный тип канала и удовлетворяет указанным функциям. (Унаследовано от Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)	Возвращает значение, указывающее, может ли текущая привязка создавать стек фабрики каналов на клиенте, который удовлетворяет коллекции указанных параметров привязки. (Унаследовано от Binding)
CanBuildChannelFactory<TChannel>(Object[])	Возвращает значение, указывающее, может ли текущая привязка создавать стек фабрики каналов на клиенте, удовлетворяющим требованиям, заданным массивом объектов. (Унаследовано от Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)	Возвращает значение, указывающее, может ли текущая привязка создать стек прослушивателя каналов в службе, которая удовлетворяет коллекции указанных параметров привязки. (Унаследовано от Binding)
CanBuildChannelListener<TChannel>(Object[])	Возвращает значение, указывающее, может ли текущая привязка создавать стек прослушивателя каналов в службе, удовлетворяющей критериям, указанным в массиве объектов. (Унаследовано от Binding)
CreateBindingElements()	Создает коллекцию с элементами привязки для привязки.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetProperty<T>(BindingParameterCollection)	Возвращает типизированный объект, запрошенный, если он присутствует, из соответствующего слоя в стеке привязки. (Унаследовано от Binding)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ShouldSerializeListenBacklog()	Возвращает значение, указывающее, изменилось ли ListenBacklog свойство со значения по умолчанию и должно быть сериализовано.
ShouldSerializeMaxConnections()	Возвращает значение, указывающее, изменилось ли MaxConnections свойство со значения по умолчанию и должно быть сериализовано.
ShouldSerializeName()	Возвращает, следует ли сериализовать имя привязки. (Унаследовано от Binding)
ShouldSerializeNamespace()	Возвращает, следует ли сериализовать пространство имен привязки. (Унаследовано от Binding)
ShouldSerializeReaderQuotas()	Возвращает значение, указывающее, изменилось ли ReaderQuotas свойство со значения по умолчанию и должно быть сериализовано.
ShouldSerializeReliableSession()	Возвращает значение, указывающее, изменилось ли ReliableSession свойство со значения по умолчанию и должно быть сериализовано.
ShouldSerializeSecurity()	Возвращает значение, указывающее, изменилось ли Security свойство со значения по умолчанию и должно быть сериализовано.
ShouldSerializeTransactionProtocol()	Возвращает значение, указывающее, изменилось ли TransactionProtocol свойство со значения по умолчанию и должно быть сериализовано.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Явные реализации интерфейса

Имя	Описание
IBindingRuntimePreferences.ReceiveSynchronously	Возвращает значение, указывающее, обрабатываются ли входящие запросы синхронно или асинхронно.

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?