NetNamedPipeBinding Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет безопасную и надежную привязку, оптимизированную для обмена данными на компьютере.
public ref class NetNamedPipeBinding : System::ServiceModel::Channels::Binding
public ref class NetNamedPipeBinding : System::ServiceModel::Channels::Binding, System::ServiceModel::Channels::IBindingRuntimePreferences
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public class NetNamedPipeBinding : System.ServiceModel.Channels.Binding
public class NetNamedPipeBinding : System.ServiceModel.Channels.Binding, System.ServiceModel.Channels.IBindingRuntimePreferences
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
type NetNamedPipeBinding = class
inherit Binding
type NetNamedPipeBinding = class
inherit Binding
interface IBindingRuntimePreferences
Public Class NetNamedPipeBinding
Inherits Binding
Public Class NetNamedPipeBinding
Inherits Binding
Implements IBindingRuntimePreferences
- Наследование
- Атрибуты
- Реализации
Примеры
В следующем примере показана часть файла конфигурации, которая содержит раздел для NetNamedPipeBinding значения, заданные по умолчанию.
В следующем примере показано, как программно использовать NetNamedPipeBinding класс.
[ServiceContract(Namespace = "http://UE.Samples")]
public interface ICalculator
{
[OperationContract]
double Add(double n1, double n2);
}
// Service class which implements the service contract.
public class CalculatorService : ICalculator
{
public double Add(double n1, double n2)
{
return n1 + n2;
}
public static void Main()
{
Uri baseAddress = new Uri("http://localhost:8000/uesamples/service");
string address = "net.pipe://localhost/uesamples/calc";
// Create a ServiceHost for the CalculatorService type and provide the base address.
using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress))
{
NetNamedPipeBinding binding = new NetNamedPipeBinding(NetNamedPipeSecurityMode.None);
serviceHost.AddServiceEndpoint(typeof(ICalculator), binding, address);
// Add a mex endpoint
ServiceMetadataBehavior smb = new ServiceMetadataBehavior();
smb.HttpGetEnabled = true;
smb.HttpGetUrl = new Uri("http://localhost:8001/uesamples");
serviceHost.Description.Behaviors.Add(smb);
long maxBufferPoolSize = binding.MaxBufferPoolSize;
int maxBufferSize = binding.MaxBufferSize;
int maxConnections = binding.MaxConnections;
long maxReceivedMessageSize =
binding.MaxReceivedMessageSize;
NetNamedPipeSecurity security = binding.Security;
string scheme = binding.Scheme;
XmlDictionaryReaderQuotas readerQuotas =
binding.ReaderQuotas;
BindingElementCollection bCollection = binding.CreateBindingElements();
HostNameComparisonMode hostNameComparisonMode =
binding.HostNameComparisonMode;
bool TransactionFlow = binding.TransactionFlow;
TransactionProtocol transactionProtocol =
binding.TransactionProtocol;
EnvelopeVersion envelopeVersion =
binding.EnvelopeVersion;
TransferMode transferMode =
binding.TransferMode;
serviceHost.Open();
Console.WriteLine("The service is ready.");
Console.WriteLine("Press <ENTER> to terminate service.");
Console.WriteLine();
Console.ReadLine();
serviceHost.Close();
}
}
static void SnippetReceiveSynchronously ()
{
NetNamedPipeBinding binding = new NetNamedPipeBinding();
IBindingRuntimePreferences s =
binding.GetProperty<IBindingRuntimePreferences>
(new BindingParameterCollection());
bool receiveSynchronously = s.ReceiveSynchronously;
}
}
Комментарии
По NetNamedPipeBinding умолчанию создается стек связи во время выполнения, который использует безопасность транспорта, именованные каналы для доставки сообщений и кодировку двоичного сообщения. Эта привязка — это подходящий системный вариант Windows Communication Foundation (WCF) для связи на компьютере. Она также поддерживает транзакции.
Конфигурация по умолчанию аналогична конфигурации NetNamedPipeBinding , предоставленной этой NetTcpBindingконфигурацией, но проще, так как реализация WCF предназначена только для использования на компьютере и, следовательно, меньше доступных функций. Наиболее заметным отличием является то, что SecurityMode параметр предлагает None только параметры и Transport параметры. Поддержка безопасности SOAP не включена. Поведение безопасности настраивается с помощью необязательного securityMode параметра в NetNamedPipeBinding(NetNamedPipeSecurityMode) конструкторе.
Конструкторы
| Имя | Описание |
|---|---|
| NetNamedPipeBinding() |
Инициализирует новый экземпляр класса NetNamedPipeBinding. |
| NetNamedPipeBinding(NetNamedPipeSecurityMode) |
Инициализирует новый экземпляр NetNamedPipeBinding класса с указанным режимом безопасности. |
| NetNamedPipeBinding(String) |
Инициализирует новый экземпляр NetNamedPipeBinding класса с указанным именем конфигурации. |
Свойства
| Имя | Описание |
|---|---|
| CloseTimeout |
Возвращает или задает интервал времени, предоставленный для закрытия соединения перед тем, как транспорт вызывает исключение. (Унаследовано от Binding) |
| EnvelopeVersion |
Возвращает версию SOAP, которая используется для сообщений, обработанных этой привязкой. |
| HostNameComparisonMode |
Возвращает или задает значение, указывающее, используется ли имя узла для достижения службы при сопоставлении URI. |
| MaxBufferPoolSize |
Возвращает или задает максимальное количество байтов, используемых для буферизации входящих сообщений в памяти. |
| MaxBufferSize |
Возвращает или задает максимальное количество байтов, используемых для буферизации входящих сообщений в памяти. |
| MaxConnections |
Возвращает или задает максимальное количество подключений, входящих и исходящих подключений, которые разрешены конечным точкам, настроенным с помощью именованной привязки канала. |
| MaxReceivedMessageSize |
Возвращает или задает максимальный размер в байтах для полученного сообщения, обрабатываемого привязкой. |
| MessageVersion |
Возвращает версию сообщения, используемую клиентами и службами, настроенными с привязкой. (Унаследовано от Binding) |
| Name |
Возвращает или задает имя привязки. (Унаследовано от Binding) |
| Namespace |
Возвращает или задает пространство имен XML привязки. (Унаследовано от Binding) |
| OpenTimeout |
Возвращает или задает интервал времени, предоставленный для открытия подключения, прежде чем транспорт вызывает исключение. (Унаследовано от Binding) |
| ReaderQuotas |
Возвращает или задает ограничения сложности сообщений SOAP, которые могут обрабатываться конечными точками, настроенными с помощью этой привязки. |
| ReceiveTimeout |
Возвращает или задает интервал времени, в течение которого соединение не может оставаться неактивным, в течение которого сообщения приложения не будут получены до удаления. (Унаследовано от Binding) |
| 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) |
| ShouldSerializeMaxConnections() |
Возвращает значение, указывающее, изменилось ли MaxConnections свойство со значения по умолчанию и должно быть сериализовано. |
| ShouldSerializeName() |
Возвращает, следует ли сериализовать имя привязки. (Унаследовано от Binding) |
| ShouldSerializeNamespace() |
Возвращает, следует ли сериализовать пространство имен привязки. (Унаследовано от Binding) |
| ShouldSerializeReaderQuotas() |
Возвращает значение, указывающее, изменилось ли ReaderQuotas свойство со значения по умолчанию и должно быть сериализовано. Это используется WCF для интеграции XAML. |
| ShouldSerializeSecurity() |
Возвращает значение, указывающее, изменилось ли Security свойство со значения по умолчанию и должно быть сериализовано. Это используется WCF для интеграции XAML. |
| ShouldSerializeTransactionProtocol() |
Возвращает значение, указывающее, изменилось ли TransactionProtocol свойство со значения по умолчанию и должно быть сериализовано. Это используется WCF для интеграции XAML. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
Явные реализации интерфейса
| Имя | Описание |
|---|---|
| IBindingRuntimePreferences.ReceiveSynchronously |
Возвращает значение, указывающее, обрабатываются ли входящие запросы синхронно или асинхронно. |