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 |
Возвращает значение, указывающее, синхронно или асинхронно обрабатываются входящие запросы. |