NetNamedPipeBinding Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce un'associazione protetta e affidabile, ottimizzata per la comunicazione su computer.
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
- Ereditarietà
- Attributi
- Implementazioni
Esempio
Nell'esempio seguente viene illustrata la parte del file di configurazione che contiene la sezione per NetNamedPipeBinding con i valori impostati sulle impostazioni predefinite.
Nell'esempio seguente viene illustrato come utilizzare la classe NetNamedPipeBinding a livello di codice.
[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;
}
}
Commenti
L'associazione NetNamedPipeBinding genera per impostazione predefinita uno stack di comunicazione di runtime che usa la sicurezza del trasporto, le named pipe per il recapito dei messaggi e una codifica dei messaggi binaria. Questa associazione rappresenta una scelta fornita dal sistema Windows Communication Foundation (WCF) appropriata per la comunicazione su computer. Supporta inoltre le transazioni.
La configurazione predefinita per NetNamedPipeBinding è simile alla configurazione fornita da NetTcpBinding, ma è più semplice poiché l'implementazione WCF è destinata solo all'utilizzo su computer e le funzionalità esposte sono di conseguenza minori. La differenza più evidente è che per l'impostazione di SecurityMode sono disponibili solo le opzioni None e Transport. Il supporto della sicurezza SOAP non è incluso fra le opzioni. Il comportamento di sicurezza può essere configurato utilizzando il parametro facoltativo securityMode
nel costruttore NetNamedPipeBinding(NetNamedPipeSecurityMode).
Costruttori
NetNamedPipeBinding() |
Inizializza una nuova istanza della classe NetNamedPipeBinding. |
NetNamedPipeBinding(NetNamedPipeSecurityMode) |
Inizializza una nuova istanza della classe NetNamedPipeBinding con una modalità di sicurezza specificata. |
NetNamedPipeBinding(String) |
Inizializza una nuova istanza della classe NetNamedPipeBinding con un nome di configurazione specificato. |
Proprietà
CloseTimeout |
Ottiene o imposta l'intervallo di tempo fornito per la chiusura di una connessione prima che il trasporto generi un'eccezione. (Ereditato da Binding) |
EnvelopeVersion |
Consente di ottenere la versione di SOAP utilizzata per i messaggi elaborati da questa associazione. |
HostNameComparisonMode |
Ottiene o imposta un valore che indica se viene utilizzato il nome host per raggiungere il servizio in caso di corrispondenza dell'URI. |
MaxBufferPoolSize |
Ottiene o imposta il numero massimo di byte utilizzato per memorizzare messaggi in ingresso in memoria. |
MaxBufferSize |
Ottiene o imposta il numero massimo di byte utilizzati per memorizzare messaggi in ingresso in memoria. |
MaxConnections |
Ottiene o imposta il numero massimo di connessioni, in ingresso e in uscita, consentite per gli endpoint configurati con l'associazione con named pipe. |
MaxReceivedMessageSize |
Ottiene o imposta la dimensione massima in byte di un messaggio ricevuto che viene elaborato dall'associazione. |
MessageVersion |
Ottiene la versione del messaggio utilizzata dai client e dai servizi configurati con l'associazione. (Ereditato da Binding) |
Name |
Ottiene o imposta il nome dell'associazione. (Ereditato da Binding) |
Namespace |
Ottiene o imposta lo spazio dei nomi XML dell'associazione. (Ereditato da Binding) |
OpenTimeout |
Ottiene o imposta l'intervallo di tempo fornito per l'apertura di una connessione prima che il trasporto generi un'eccezione. (Ereditato da Binding) |
ReaderQuotas |
Ottiene o imposta vincoli sulla complessità dei messaggi SOAP che possono essere elaborati dagli endpoint configurati con questa associazione. |
ReceiveTimeout |
Ottiene o imposta l'intervallo di tempo durante il quale una connessione rimane inattiva, senza ricevere messaggi dell'applicazione, prima di essere rilasciata. (Ereditato da Binding) |
Scheme |
Ottiene lo schema di trasporto URI per i canali e i listener configurati con questa associazione. |
Security |
Ottiene un oggetto che specifica il tipo di sicurezza utilizzato con i servizi configurati con questa associazione. |
SendTimeout |
Ottiene o imposta l'intervallo di tempo fornito per il completamento di un'operazione di scrittura prima che il trasporto generi un'eccezione. (Ereditato da Binding) |
TransactionFlow |
Ottiene o imposta un valore che determina se le transazioni devono essere propagate al servizio. |
TransactionProtocol |
Ottiene o imposta il protocollo delle transazioni utilizzato dal servizio per il flusso delle transazioni. |
TransferMode |
Ottiene o imposta un valore che indica se il servizio configurato con l'associazione utilizza modalità di trasferimento messaggi con flusso (in una o in entrambe le direzioni) o con memorizzazione nel buffer. |
Metodi
BuildChannelFactory<TChannel>(BindingParameterCollection) |
Compila lo stack della channel factory nel client che crea un tipo specificato di canale e che soddisfa le funzionalità specificate da una raccolta di parametri di associazione. (Ereditato da Binding) |
BuildChannelFactory<TChannel>(Object[]) |
Compila lo stack della channel factory nel client che crea un tipo specificato di canale e che soddisfa le funzionalità specificate da una matrice di oggetti. (Ereditato da Binding) |
BuildChannelListener<TChannel>(BindingParameterCollection) |
Compila il listener del canale nel servizio che accetta un tipo specificato di canale e che soddisfa le funzionalità specificate da una raccolta di parametri di associazione. (Ereditato da Binding) |
BuildChannelListener<TChannel>(Object[]) |
Compila il listener del canale sul servizio che accetta un tipo di canale specificato e che presenta le funzionalità specificate. (Ereditato da Binding) |
BuildChannelListener<TChannel>(Uri, BindingParameterCollection) |
Compila il listener del canale sul servizio che accetta un tipo di canale specificato e che presenta le funzionalità specificate. (Ereditato da Binding) |
BuildChannelListener<TChannel>(Uri, Object[]) |
Compila il listener del canale sul servizio che accetta un tipo di canale specificato e che presenta le funzionalità specificate. (Ereditato da Binding) |
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) |
Compila il listener del canale sul servizio che accetta un tipo di canale specificato e che presenta le funzionalità specificate. (Ereditato da Binding) |
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) |
Compila il listener del canale sul servizio che accetta un tipo di canale specificato e che presenta le funzionalità specificate. (Ereditato da Binding) |
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) |
Compila il listener del canale sul servizio che accetta un tipo di canale specificato e che presenta le funzionalità specificate. (Ereditato da Binding) |
BuildChannelListener<TChannel>(Uri, String, Object[]) |
Compila il listener del canale sul servizio che accetta un tipo di canale specificato e che presenta le funzionalità specificate. (Ereditato da Binding) |
CanBuildChannelFactory<TChannel>(BindingParameterCollection) |
Restituisce un valore che indica se l'associazione corrente può compilare uno stack della channel factory nel client che soddisfa la raccolta dei parametri di associazione specificati. (Ereditato da Binding) |
CanBuildChannelFactory<TChannel>(Object[]) |
Restituisce un valore che indica se l'associazione corrente può compilare uno stack della channel factory nel client che soddisfa i requisiti specificati da una matrice di oggetti. (Ereditato da Binding) |
CanBuildChannelListener<TChannel>(BindingParameterCollection) |
Restituisce un valore che indica se l'associazione corrente può compilare uno stack del channel listener nel servizio che soddisfa la raccolta dei parametri di associazione specificati. (Ereditato da Binding) |
CanBuildChannelListener<TChannel>(Object[]) |
Restituisce un valore che indica se l'associazione corrente può compilare uno stack del channel listener nel servizio che soddisfa i criteri specificati in una matrice di oggetti. (Ereditato da Binding) |
CreateBindingElements() |
Consente di creare una raccolta contenente gli elementi dell'associazione. |
Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
GetProperty<T>(BindingParameterCollection) |
Se presente, restituisce un oggetto tipizzato richiesto dal livello appropriato nello stack dell'associazione. (Ereditato da Binding) |
GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
ShouldSerializeMaxConnections() |
Restituisce un valore che indica se la proprietà MaxConnections è cambiata rispetto al valore predefinito e deve essere serializzata. |
ShouldSerializeName() |
Indica se il nome dell'associazione deve essere serializzato. (Ereditato da Binding) |
ShouldSerializeNamespace() |
Indica se lo spazio dei nomi dell'associazione deve essere serializzato. (Ereditato da Binding) |
ShouldSerializeReaderQuotas() |
Restituisce un valore che indica se la proprietà ReaderQuotas è cambiata rispetto al valore predefinito e deve essere serializzata. Viene utilizzato da WCF per l'integrazione XAML. |
ShouldSerializeSecurity() |
Restituisce un valore che indica se la proprietà Security è cambiata rispetto al valore predefinito e deve essere serializzata. Viene utilizzato da WCF per l'integrazione XAML. |
ShouldSerializeTransactionProtocol() |
Restituisce un valore che indica se la proprietà TransactionProtocol è cambiata rispetto al valore predefinito e deve essere serializzata. Viene utilizzato da WCF per l'integrazione XAML. |
ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Implementazioni dell'interfaccia esplicita
IBindingRuntimePreferences.ReceiveSynchronously |
Ottiene un valore che indica se le richieste in entrata vengono gestite in modo sincrono o in modo asincrono. |