NetNamedPipeBinding Klasa

Definicja

Zapewnia bezpieczne i niezawodne powiązania zoptymalizowane pod kątem komunikacji na komputerze.Provides a secure and reliable binding that is optimized for on-machine communication.

public ref class NetNamedPipeBinding : System::ServiceModel::Channels::Binding, System::ServiceModel::Channels::IBindingRuntimePreferences
public class NetNamedPipeBinding : System.ServiceModel.Channels.Binding, System.ServiceModel.Channels.IBindingRuntimePreferences
type NetNamedPipeBinding = class
    inherit Binding
    interface IBindingRuntimePreferences
Public Class NetNamedPipeBinding
Inherits Binding
Implements IBindingRuntimePreferences
Dziedziczenie
NetNamedPipeBinding
Implementuje

Przykłady

Poniższy przykład pokazuje część pliku konfiguracji, która zawiera sekcję dla NetNamedPipeBinding wartości z wartościami ustawionymi na wartości domyślne.The following example shows the part of the configuration file that contains the section for the NetNamedPipeBinding with values set to defaults.

Poniższy przykład pokazuje, jak programowo użyć NetNamedPipeBinding klasy.The following example shows how to programmatically use the NetNamedPipeBinding class.

[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;

}
}

Uwagi

NetNamedPipeBindingGeneruje stos komunikacji w czasie wykonywania domyślnie, który używa zabezpieczeń transportu, potoków nazwanych do dostarczania komunikatów i kodowania komunikatów binarnych.The NetNamedPipeBinding generates a run-time communication stack by default, which uses transport security, named pipes for message delivery, and a binary message encoding. To powiązanie jest odpowiednim wyborem systemu Windows Communication Foundation (WCF) w przypadku komunikacji na komputerze.This binding is an appropriate Windows Communication Foundation (WCF) system-provided choice for on-machine communication. Obsługuje ona również transakcje.It also supports transactions.

Konfiguracja domyślna dla programu NetNamedPipeBinding jest podobna do konfiguracji zapewnianej przez NetTcpBinding program, ale jest prostsze, ponieważ implementacja programu WCF jest przeznaczona tylko do użytku na komputerze i w związku z tym jest mniej narażonych funkcji.The default configuration for the NetNamedPipeBinding is similar to the configuration provided by the NetTcpBinding, but it is simpler because the WCF implementation is only meant for on-machine use and consequently there are fewer exposed features. Najbardziej istotną różnicą jest to, że SecurityMode ustawienie oferuje None tylko Transport Opcje i.The most notable difference is that the SecurityMode setting only offers the None and Transport options. Obsługa zabezpieczeń protokołu SOAP nie jest uwzględnioną opcją.SOAP security support is not an included option. Zachowanie zabezpieczeń można skonfigurować za pomocą opcjonalnego securityMode parametru w NetNamedPipeBinding(NetNamedPipeSecurityMode) konstruktorze.The security behavior is configurable using the optional securityMode parameter in NetNamedPipeBinding(NetNamedPipeSecurityMode) the constructor.

Konstruktory

NetNamedPipeBinding()

Inicjuje nowe wystąpienie klasy NetNamedPipeBinding.Initializes a new instance of the NetNamedPipeBinding class.

NetNamedPipeBinding(NetNamedPipeSecurityMode)

Inicjuje nowe wystąpienie NetNamedPipeBinding klasy z określonym trybem zabezpieczeń.Initializes a new instance of the NetNamedPipeBinding class with a specified security mode.

NetNamedPipeBinding(String)

Inicjuje nowe wystąpienie NetNamedPipeBinding klasy z określoną nazwą konfiguracji.Initializes a new instance of the NetNamedPipeBinding class with a specified configuration name.

Właściwości

CloseTimeout

Pobiera lub ustawia przedział czasu, który ma zostać zamknięty, zanim transport zgłosi wyjątek.Gets or sets the interval of time provided for a connection to close before the transport raises an exception.

(Odziedziczone po Binding)
EnvelopeVersion

Pobiera wersję protokołu SOAP, która jest używana na potrzeby komunikatów przetwarzanych przez to powiązanie.Gets the version of SOAP that is used for messages processed by this binding.

HostNameComparisonMode

Pobiera lub ustawia wartość wskazującą, czy nazwa hosta jest używana do uzyskiwania dostępu do usługi podczas dopasowywania identyfikatora URI.Gets or sets a value that indicates whether the hostname is used to reach the service when matching the URI.

MaxBufferPoolSize

Pobiera lub ustawia maksymalną liczbę bajtów, które są używane do buforowania przychodzących komunikatów w pamięci.Gets or sets the maximum number of bytes that are used to buffer incoming messages in memory.

MaxBufferSize

Pobiera lub ustawia maksymalną liczbę bajtów służącą do buforowania przychodzących komunikatów w pamięci.Gets or sets the maximum number of bytes used to buffer incoming messages in memory.

MaxConnections

Pobiera lub ustawia maksymalną liczbę połączeń przychodzących i wychodzących, które są dozwolone dla punktów końcowych skonfigurowanych dla powiązania nazwanego potoku.Gets or sets the maximum number of connections, both inbound and outbound, that are allowed to endpoints configured with the named pipe binding.

MaxReceivedMessageSize

Pobiera lub ustawia maksymalny rozmiar w bajtach dla odebranego komunikatu, który jest przetwarzany przez powiązanie.Gets or sets the maximum size, in bytes, for a received message that is processed by the binding.

MessageVersion

Pobiera wersję wiadomości używaną przez klientów i usługi skonfigurowane przy użyciu powiązania.Gets the message version used by clients and services configured with the binding.

(Odziedziczone po Binding)
Name

Pobiera lub ustawia nazwę powiązania.Gets or sets the name of the binding.

(Odziedziczone po Binding)
Namespace

Pobiera lub ustawia przestrzeń nazw XML powiązania.Gets or sets the XML namespace of the binding.

(Odziedziczone po Binding)
OpenTimeout

Pobiera lub ustawia przedział czasu, który ma być otwarty, zanim transport zgłosi wyjątek.Gets or sets the interval of time provided for a connection to open before the transport raises an exception.

(Odziedziczone po Binding)
ReaderQuotas

Pobiera lub ustawia ograniczenia złożoności komunikatów protokołu SOAP, które mogą być przetwarzane przez punkty końcowe skonfigurowane za pomocą tego powiązania.Gets or sets constraints on the complexity of SOAP messages that can be processed by endpoints configured with this binding.

ReceiveTimeout

Pobiera lub ustawia przedział czasu, przez jaki połączenie może pozostawać nieaktywne, podczas którego nie są odbierane żadne komunikaty aplikacji przed porzuceniem.Gets or sets the interval of time that a connection can remain inactive, during which no application messages are received, before it is dropped.

(Odziedziczone po Binding)
Scheme

Pobiera schemat transportu URI dla kanałów i odbiorników skonfigurowanych przy użyciu tego powiązania.Gets the URI transport scheme for the channels and listeners that are configured with this binding.

Security

Pobiera obiekt, który określa typ zabezpieczeń używany z usługami skonfigurowanymi przy użyciu tego powiązania.Gets an object that specifies the type of security used with services configured with this binding.

SendTimeout

Pobiera lub ustawia przedział czasu przewidziany na zakończenie operacji zapisu przed wykroczeniem przez transport wyjątku.Gets or sets the interval of time provided for a write operation to complete before the transport raises an exception.

(Odziedziczone po Binding)
TransactionFlow

Pobiera lub ustawia wartość określającą, czy transakcje powinny być przepływane do usługi.Gets or sets a value that determines whether transactions should be flowed to the service.

TransactionProtocol

Pobiera lub ustawia protokół transakcji używany przez usługę do przepływu transakcji.Gets or sets the transactions protocol used by the service to flow transactions.

TransferMode

Pobiera lub ustawia wartość wskazującą, czy Usługa skonfigurowana przy użyciu powiązania używa strumieniowo (w jednym lub obu kierunkach) lub w trybie buforowanym transferu komunikatów.Gets or sets a value that indicates whether the service configured with the binding uses streamed (in one or both directions) or buffered modes of message transfer.

Metody

BuildChannelFactory<TChannel>(BindingParameterCollection)

Kompiluje stos fabryki kanałów na kliencie, który tworzy określony typ kanału, który spełnia funkcje określone przez kolekcję parametrów powiązań.Builds the channel factory stack on the client that creates a specified type of channel and that satisfies the features specified by a collection of binding parameters.

(Odziedziczone po Binding)
BuildChannelFactory<TChannel>(Object[])

Kompiluje stos fabryki kanałów na kliencie, który tworzy określony typ kanału, który spełnia funkcje określone przez tablicę obiektów.Builds the channel factory stack on the client that creates a specified type of channel and that satisfies the features specified by an object array.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)

Kompiluje odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia funkcje określone przez kolekcję parametrów powiązań.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified by a collection of binding parameters.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Object[])

Kompiluje odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)

Kompiluje odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, Object[])

Kompiluje odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)

Kompiluje odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)

Kompiluje odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])

Kompiluje odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])

Kompiluje odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Odziedziczone po Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)

Zwraca wartość wskazującą, czy bieżące powiązanie może utworzyć stos fabryki kanałów na kliencie, który spełnia wymagania kolekcji określonych parametrów powiązania.Returns a value that indicates whether the current binding can build a channel factory stack on the client that satisfies the collection of binding parameters specified.

(Odziedziczone po Binding)
CanBuildChannelFactory<TChannel>(Object[])

Zwraca wartość wskazującą, czy bieżące powiązanie może skompilować stos fabryki kanałów na kliencie, który spełnia wymagania określone przez tablicę obiektów.Returns a value that indicates whether the current binding can build a channel factory stack on the client that satisfies the requirements specified by an object array.

(Odziedziczone po Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)

Zwraca wartość wskazującą, czy bieżące powiązanie może kompilować stos odbiornika kanałów w usłudze, która spełnia kryteria kolekcji określonych parametrów powiązania.Returns a value that indicates whether the current binding can build a channel listener stack on the service that satisfies the collection of binding parameters specified.

(Odziedziczone po Binding)
CanBuildChannelListener<TChannel>(Object[])

Zwraca wartość wskazującą, czy bieżące powiązanie może kompilować stos odbiornika kanałów w usłudze, która spełnia kryteria określone w tablicy obiektów.Returns a value that indicates whether the current binding can build a channel listener stack on the service that satisfies the criteria specified in an array of objects.

(Odziedziczone po Binding)
CreateBindingElements()

Tworzy kolekcję z elementami powiązania dla powiązania.Creates a collection with the binding elements for the binding.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetProperty<T>(BindingParameterCollection)

Zwraca żądany obiekt typu, jeśli jest obecny, z odpowiedniej warstwy w stosie powiązań.Returns a typed object requested, if present, from the appropriate layer in the binding stack.

(Odziedziczone po Binding)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ShouldSerializeMaxConnections()

Zwraca wartość wskazującą, czy MaxConnections Właściwość została zmieniona z wartości domyślnej i powinna być serializowana.Returns a value that indicates whether the MaxConnections property has changed from its default value and should be serialized.

ShouldSerializeName()

Zwraca czy nazwa powiązania powinna być serializowana.Returns whether the name of the binding should be serialized.

(Odziedziczone po Binding)
ShouldSerializeNamespace()

Zwraca czy przestrzeń nazw powiązania powinna być serializowana.Returns whether the namespace of the binding should be serialized.

(Odziedziczone po Binding)
ShouldSerializeReaderQuotas()

Zwraca wartość wskazującą, czy ReaderQuotas Właściwość została zmieniona z wartości domyślnej i powinna być serializowana.Returns a value that indicates whether the ReaderQuotas property has changed from its default value and should be serialized. Jest on używany przez funkcję WCF dla integracji XAML.This is used by WCF for XAML integration.

ShouldSerializeSecurity()

Zwraca wartość wskazującą, czy Security Właściwość została zmieniona z wartości domyślnej i powinna być serializowana.Returns a value that indicates whether the Security property has changed from its default value and should be serialized. Jest on używany przez funkcję WCF dla integracji XAML.This is used by WCF for XAML integration.

ShouldSerializeTransactionProtocol()

Zwraca wartość wskazującą, czy TransactionProtocol Właściwość została zmieniona z wartości domyślnej i powinna być serializowana.Returns a value that indicates whether the TransactionProtocol property has changed from its default value and should be serialized. Jest on używany przez funkcję WCF dla integracji XAML.This is used by WCF for XAML integration.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

IBindingRuntimePreferences.ReceiveSynchronously

Pobiera wartość wskazującą, czy żądania przychodzące są obsługiwane synchronicznie, czy asynchronicznie.Gets a value that indicates whether incoming requests are handled synchronously or asynchronously.

Dotyczy