NetNamedPipeBinding クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コンピューター上の通信用に最適化された、セキュリティで保護された信頼性の高いバインディングを提供します。
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 プロパティが既定値から変更され、シリアル化する必要があるかどうかを示す値を返します。 これは、XAML 統合のために WCF によって使用されます。 |
| ShouldSerializeSecurity() |
Security プロパティが既定値から変更され、シリアル化する必要があるかどうかを示す値を返します。 これは、XAML 統合のために WCF によって使用されます。 |
| ShouldSerializeTransactionProtocol() |
TransactionProtocol プロパティが既定値から変更され、シリアル化する必要があるかどうかを示す値を返します。 これは、XAML 統合のために WCF によって使用されます。 |
| ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
明示的なインターフェイスの実装
| 名前 | 説明 |
|---|---|
| IBindingRuntimePreferences.ReceiveSynchronously |
受信要求が同期的または非同期的に処理されるかどうかを示す値を取得します。 |