NetNamedPipeBinding Classe

Riferimento

Definizione

Spazio dei nomi:: System.ServiceModel

Assembly:: System.ServiceModel.NetNamedPipe.dll

Assembly:: System.ServiceModel.dll

Pacchetto:: System.ServiceModel.NetNamedPipe v6.0.0

Pacchetto:: System.ServiceModel.NetNamedPipe v6.2.0

Pacchetto:: System.ServiceModel.NetNamedPipe v8.0.0

Source:: NetNamedPipeBinding.cs

Source:: NetNamedPipeBinding.cs

Source:: NetNamedPipeBinding.cs

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à: Object

Binding
NetNamedPipeBinding

Attributi: SupportedOSPlatformAttribute

Implementazioni: IBindingRuntimePreferences

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.

Si applica a