NetTcpBinding Класс

Ссылка

Определение

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

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

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

Важно!

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

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

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-имени узла службы и номера порта, на котором прослушивается служба. Это хорошо работает, когда клиент выполняет вызовы к разным службам в разных портах или службах размещается в одном процессе и предоставляет общий доступ к порту. Если один клиент вызывает несколько служб, совместно использующих порт, размещенный в разных процессах или размещенных в WAS/IIS, пул на стороне клиента может привести к проблемам, когда подключение к службе A повторно используется для службы B, что приводит к возникновению исключения, прерывание подключения и создание нового канала. Чтобы избежать этой проблемы, используйте CustomBinding и укажите другое свойство ConnectionPoolSettings.GroupName для каждой службы, с которым взаимодействует клиент.

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

NetTcpBinding()	Инициализирует новый экземпляр класса NetTcpBinding.
NetTcpBinding(SecurityMode)	Инициализирует новый экземпляр класса NetTcpBinding с указанным используемый типом безопасности.
NetTcpBinding(SecurityMode, Boolean)	Инициализирует новый экземпляр класса 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

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

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