EndpointAddress EndpointAddress EndpointAddress EndpointAddress Class

Définition

Fournit une adresse réseau unique permettant à un client de communiquer avec un point de terminaison de service.Provides a unique network address that a client uses to communicate with a service endpoint.

public ref class EndpointAddress
public class EndpointAddress
type EndpointAddress = class
Public Class EndpointAddress
Héritage
EndpointAddressEndpointAddressEndpointAddressEndpointAddress

Exemples

using System;
using System.Configuration;
using System.Collections.Generic;
using System.ServiceModel;
using System.ServiceModel.Channels;
using System.ServiceModel.Description;

using System.Text;

namespace Microsoft.WCF.Documentation
{
  class HostApplication
  {

    static void Main()
    {
      HostApplication app = new HostApplication();
      app.Run();
    }

    private void Run()
    {

            // Get base address from app settings in configuration
            Uri baseAddress = new Uri(ConfigurationManager.AppSettings["baseAddress"]);

            //Create new address headers for special services and add them to an array
            AddressHeader addressHeader1 = AddressHeader.CreateAddressHeader(
                "specialservice1", "http://localhost:8000/service", 1);
            AddressHeader addressHeader2 = AddressHeader.CreateAddressHeader(
                "specialservice2", "http://localhost:8000/service", 2);

            // Enumerate address headers and their properties from the array.
            AddressHeader[] addressHeaders = new AddressHeader[2] { addressHeader1, addressHeader2 };
            foreach (AddressHeader addressHeader in addressHeaders)
            {
                Console.WriteLine("AddressHeader - namespace:\t\t{0}", addressHeader.Namespace);
                Console.WriteLine("              - name:\t\t\t{0}", addressHeader.Name);
                Console.WriteLine("              - value:\t\t\t{0}", addressHeader.GetValue<int>());
                Console.WriteLine("              - type:\t\t\t{0}", addressHeader.GetType());
                Console.WriteLine("              - hashcode:\t\t{0}", addressHeader.GetHashCode());
                Console.WriteLine("              - equals addressHeader1:\t{0}", addressHeader.Equals(addressHeader1));
             //   Console.WriteLine("              - Is SOAP1.1 supported:\t{0}", addressHeader.ToMessageHeader().IsMessageVersionSupported(MessageVersion.WSAddressingSoap10));
                Console.WriteLine();
            }
            Console.WriteLine();

            //Add the array of address headers to an endpoint address
            EndpointAddress endpointAddress = new EndpointAddress(
                        new Uri("http://localhost:8003/servicemodelsamples/service"), addressHeaders);

            //Create a "special" service endpoint that uses the endpointAddress.
            string WSHttpBindingName = "Binding1";
            ServiceEndpoint specialServiceEndpoint = new ServiceEndpoint(
                ContractDescription.GetContract(typeof(CalculatorService)), new WSHttpBinding(WSHttpBindingName), endpointAddress
                );

            // Create a ServiceHost for the CalculatorService type that uses the base address.
            ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress);

            //Add the specialServiceEndpoint to the serviceHost.
            serviceHost.Description.Endpoints.Add(specialServiceEndpoint);

            // Enumerate the service endpoints and some of their properties from the serviceHost.
            Console.WriteLine("Service endpoints:");
            ServiceDescription desc = serviceHost.Description;
            foreach (ServiceEndpoint endpoint in desc.Endpoints)
            {
                Console.WriteLine("Endpoint - address:  {0}", endpoint.Address);
                Console.WriteLine("         - binding name:\t\t{0}", endpoint.Binding.Name);
                // Console.WriteLine("         - binding name:\t\t{0}", endpoint.);
                Console.WriteLine("         - contract name:\t\t{0}", endpoint.Contract.Name);
                Console.WriteLine("         - contains addressHeader1:\t{0}", endpoint.Address.Headers.Contains(addressHeader1));
                Console.WriteLine("         - count of address headers:\t{0}", endpoint.Address.Headers.Count);
                Console.WriteLine();
            }

            Console.WriteLine();

            // Open the ServiceHostBase to create listeners and start listening for messages.
            serviceHost.Open();

            // The service can now be accessed.
            Console.WriteLine("The service is ready.");
            Console.WriteLine("Press <ENTER> to terminate service.");
            Console.WriteLine();
            Console.ReadLine();

            // Close the ServiceHostBase to shutdown the service.
            serviceHost.Close();

        }
    }
  }

Remarques

Une adresse de point de terminaison identifie de manière unique le point de terminaison d'un service.An endpoint address uniquely identifies the endpoint for a service.

L'adresse de point de terminaison appartient au point de terminaison de service, lequel contient également la liaison, le contrat et les comportements pour le point de terminaison.The endpoint address belongs to the service endpoint, which also contains the binding, contract and behaviors for the endpoint.

Le EndpointAddress contient un URI et des propriétés d’adresse qui incluent une identité, des éléments WSDL et une collection d’en-têtes facultatifs.The EndpointAddress contains a URI and address properties that include an identity, WSDL elements, and a collection of optional headers. Les en-têtes facultatifs sont utilisés pour fournir des informations d'adressage supplémentaires plus détaillées pour identifier le point de terminaison ou interagir avec lui.The optional headers are used to provide additional, more detailed addressing information to identify or interact with the endpoint. Par exemple, ils peuvent être utilisés pour indiquer quelle instance d'un service doit être utilisée pour traiter un message entrant d'un utilisateur particulier lorsque plusieurs instances sont disponibles.For example, they can be used to indicate which instance of a service is to be used to process an incoming message from a particular user when multiple instances are available.

L'adresse du point de terminaison pour un service peut être spécifiée de manière impérative en utilisant le code ou de façon déclarative par la configuration.The endpoint address for a service can be specified either imperatively using code or declaratively through configuration. La définition de points de terminaison dans le code est généralement peu pratique car les liaisons et les adresses pour un service déployé sont en général différentes de celles utilisées au cours du développement du service.Defining endpoints in code is usually not practical because the bindings and addresses for a deployed service are typically different from those used while the service is being developed. Il est plus pratique de définir des points de terminaison de service à l’aide de la configuration.It is more practical to define service endpoints using configuration.

EndpointAddress n'implémente pas l'interface ISerializable et n'est donc pas sérialisable.EndpointAddress does not implement the ISerializable interface and so is not serializable. Pour qu'un point de terminaison soit exposé dans le cadre d'un contrat de service, il doit être sérialisable et être également conforme au protocole d'adressage (WS-Addressing) de service Web.For an endpoint to be exposed as part of a service contract it must be serializable and it must also be compliant with the Web Service Addressing (WS-Addressing) protocol. Les points de terminaison sérialisables qui sont conformes avec la version 1.0 et la version d'août 2004 de WS-Addressing sont fournis, respectivement, par les classes EndpointAddress10 et EndpointAddressAugust2004.Serializable endpoints that are compliant with version 1.0 and the August 2004 version of WS-Addressing are provided, respectively, by the EndpointAddress10 and EndpointAddressAugust2004 classes.

Constructeurs

EndpointAddress(String) EndpointAddress(String) EndpointAddress(String) EndpointAddress(String)

Initialise une nouvelle instance de la classe EndpointAddress avec une chaîne URI spécifiée.Initializes a new instance of the EndpointAddress class with a specified URI string.

EndpointAddress(Uri, AddressHeader[]) EndpointAddress(Uri, AddressHeader[]) EndpointAddress(Uri, AddressHeader[]) EndpointAddress(Uri, AddressHeader[])

Initialise une nouvelle instance de la classe EndpointAddress avec un URI et des en-têtes spécifiés.Initializes a new instance of the EndpointAddress class with a specified URI and headers.

EndpointAddress(Uri, EndpointIdentity, AddressHeaderCollection) EndpointAddress(Uri, EndpointIdentity, AddressHeaderCollection) EndpointAddress(Uri, EndpointIdentity, AddressHeaderCollection) EndpointAddress(Uri, EndpointIdentity, AddressHeaderCollection)

Initialise une nouvelle instance de la classe EndpointAddress avec un URI, une identité et une collection d'en-têtes spécifiés.Initializes a new instance of the EndpointAddress class with a specified URI, identity, and header collection.

EndpointAddress(Uri, EndpointIdentity, AddressHeaderCollection, XmlDictionaryReader, XmlDictionaryReader) EndpointAddress(Uri, EndpointIdentity, AddressHeaderCollection, XmlDictionaryReader, XmlDictionaryReader) EndpointAddress(Uri, EndpointIdentity, AddressHeaderCollection, XmlDictionaryReader, XmlDictionaryReader) EndpointAddress(Uri, EndpointIdentity, AddressHeaderCollection, XmlDictionaryReader, XmlDictionaryReader)

Initialise une nouvelle instance de la classe EndpointAddress avec un URI, une identité, une collection d'en-têtes, et des lecteurs de métadonnées et d'extension spécifiés.Initializes a new instance of the EndpointAddress class with a specified URI, identity, header collection, and metadata and extension readers.

EndpointAddress(Uri, EndpointIdentity, AddressHeader[]) EndpointAddress(Uri, EndpointIdentity, AddressHeader[]) EndpointAddress(Uri, EndpointIdentity, AddressHeader[]) EndpointAddress(Uri, EndpointIdentity, AddressHeader[])

Initialise une nouvelle instance de la classe EndpointAddress avec un URI, une identité et des en-têtes spécifiés.Initializes a new instance of the EndpointAddress class with a specified URI, identity, and headers.

Propriétés

AnonymousUri AnonymousUri AnonymousUri AnonymousUri

Obtient une représentation de version indépendante de l'URI anonyme.Gets a version-neutral representation of the anonymous URI.

Headers Headers Headers Headers

Obtient la collection d’en-têtes d’adresse des points de terminaison que le générateur peut créer.Gets the collection of address headers for the endpoints that the builder can create.

Identity Identity Identity Identity

Obtient l'identité pour le point de terminaison utilisé pour l'authentifier.Gets the identity for the endpoint used to authenticate it.

IsAnonymous IsAnonymous IsAnonymous IsAnonymous

Obtient une valeur qui indique si le point de terminaison est anonyme.Gets a value that indicates whether the endpoint is anonymous.

IsNone IsNone IsNone IsNone

Obtient une valeur qui indique si l'URI pour le point de terminaison est la propriété NoneUri.Gets a value that indicates whether the URI for the endpoint is the NoneUri.

NoneUri NoneUri NoneUri NoneUri

Obtient un URI de version indépendante utilisé pour l'adresse d'un point de terminaison auquel un message ne doit pas être envoyé.Gets a version-neutral URI used for the address of an endpoint to which a message must not be sent.

Uri Uri Uri Uri

Obtient l'URI pour le point de terminaison.Gets the URI for the endpoint.

Méthodes

ApplyTo(Message) ApplyTo(Message) ApplyTo(Message) ApplyTo(Message)

Assigne l'URI et les propriétés de l'adresse de point de terminaison aux valeurs des en-têtes d'un message spécifié.Assigns the URI and properties of the endpoint address to the values of the headers of a specified message.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Retourne une valeur qui indique si un objet spécifié est équivalent à l'adresse actuelle du point de terminaison.Returns a value that indicates whether a specified object is equivalent to the current endpoint address.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fournit un code de hachage unique pour l'adresse du point de terminaison actuel.Provides a unique hash code for the current endpoint address.

GetReaderAtExtensions() GetReaderAtExtensions() GetReaderAtExtensions() GetReaderAtExtensions()

Obtient le lecteur de dictionnaire XML qui fournit l'accès aux extensions.Gets the XML dictionary reader that provides access to the extensions.

GetReaderAtMetadata() GetReaderAtMetadata() GetReaderAtMetadata() GetReaderAtMetadata()

Obtient le lecteur de dictionnaire XML qui fournit l'accès aux métadonnées pour un point de terminaison.Gets the XML dictionary reader that provides access to the metadata for an endpoint.

GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
ReadFrom(AddressingVersion, XmlDictionaryReader) ReadFrom(AddressingVersion, XmlDictionaryReader) ReadFrom(AddressingVersion, XmlDictionaryReader) ReadFrom(AddressingVersion, XmlDictionaryReader)

Lit une adresse de point de terminaison pour une version d'adresse spécifiée à partir d'un lecteur de dictionnaire XML spécifié.Reads an endpoint address for a specified address version from a specified XML dictionary reader.

ReadFrom(AddressingVersion, XmlDictionaryReader, XmlDictionaryString, XmlDictionaryString) ReadFrom(AddressingVersion, XmlDictionaryReader, XmlDictionaryString, XmlDictionaryString) ReadFrom(AddressingVersion, XmlDictionaryReader, XmlDictionaryString, XmlDictionaryString) ReadFrom(AddressingVersion, XmlDictionaryReader, XmlDictionaryString, XmlDictionaryString)

Lit une adresse de point de terminaison pour une version d'adresse spécifiée avec un nom qualifié spécifié à partir d'un lecteur de dictionnaire XML spécifié.Reads an endpoint address for a specified address version with a specified qualified name from a specified XML dictionary reader.

ReadFrom(AddressingVersion, XmlReader) ReadFrom(AddressingVersion, XmlReader) ReadFrom(AddressingVersion, XmlReader) ReadFrom(AddressingVersion, XmlReader)

Lit une adresse de point de terminaison pour une version d'adresse spécifiée à partir d'un lecteur XML spécifié.Reads an endpoint address for a specified address version from a specified XML reader.

ReadFrom(AddressingVersion, XmlReader, String, String) ReadFrom(AddressingVersion, XmlReader, String, String) ReadFrom(AddressingVersion, XmlReader, String, String) ReadFrom(AddressingVersion, XmlReader, String, String)

Lit une adresse de point de terminaison pour une version d'adresse spécifiée avec un nom qualifié spécifié à partir d'un lecteur XML spécifié.Reads an endpoint address for a specified address version with a specified qualified name from a specified XML reader.

ReadFrom(XmlDictionaryReader) ReadFrom(XmlDictionaryReader) ReadFrom(XmlDictionaryReader) ReadFrom(XmlDictionaryReader)

Lit une adresse de point de terminaison à partir d'un lecteur de dictionnaire XML spécifié.Reads an endpoint address from a specified XML dictionary reader.

ReadFrom(XmlDictionaryReader, XmlDictionaryString, XmlDictionaryString) ReadFrom(XmlDictionaryReader, XmlDictionaryString, XmlDictionaryString) ReadFrom(XmlDictionaryReader, XmlDictionaryString, XmlDictionaryString) ReadFrom(XmlDictionaryReader, XmlDictionaryString, XmlDictionaryString)

Lit une adresse de point de terminaison avec un nom qualifié spécifié à partir d'un lecteur de dictionnaire XML spécifié.Reads an endpoint address with a specified qualified name from a specified XML dictionary reader.

ToString() ToString() ToString() ToString()

Retourne une représentation sous forme de chaîne canonique de l'URI contenu dans l'adresse de point de terminaison.Returns a canonical string representation of the URI that is contained in the endpoint address.

WriteContentsTo(AddressingVersion, XmlDictionaryWriter) WriteContentsTo(AddressingVersion, XmlDictionaryWriter) WriteContentsTo(AddressingVersion, XmlDictionaryWriter) WriteContentsTo(AddressingVersion, XmlDictionaryWriter)

Enregistre tous les nœuds enfants du nœud sur le writer de dictionnaire XML spécifié.Saves all the child nodes of the node to the XML dictionary writer specified.

WriteContentsTo(AddressingVersion, XmlWriter) WriteContentsTo(AddressingVersion, XmlWriter) WriteContentsTo(AddressingVersion, XmlWriter) WriteContentsTo(AddressingVersion, XmlWriter)

Enregistre tous les nœuds enfants du nœud sur le writer XML spécifié.Saves all the child nodes of the node to the XML writer specified.

WriteTo(AddressingVersion, XmlDictionaryWriter) WriteTo(AddressingVersion, XmlDictionaryWriter) WriteTo(AddressingVersion, XmlDictionaryWriter) WriteTo(AddressingVersion, XmlDictionaryWriter)

Enregistre l'adresse de point de terminaison actuelle d'une version spécifiée sur un writer de dictionnaire XML spécifié.Saves the current endpoint address of a specified version to a specified XML dictionary writer.

WriteTo(AddressingVersion, XmlDictionaryWriter, XmlDictionaryString, XmlDictionaryString) WriteTo(AddressingVersion, XmlDictionaryWriter, XmlDictionaryString, XmlDictionaryString) WriteTo(AddressingVersion, XmlDictionaryWriter, XmlDictionaryString, XmlDictionaryString) WriteTo(AddressingVersion, XmlDictionaryWriter, XmlDictionaryString, XmlDictionaryString)

Enregistre l'adresse de point de terminaison actuelle d'une version spécifiée sur un writer de dictionnaire XML avec un espace de noms et un nom local spécifiés.Saves the current endpoint address of a specified version to an XML dictionary writer with a specified namespace and local name.

WriteTo(AddressingVersion, XmlWriter) WriteTo(AddressingVersion, XmlWriter) WriteTo(AddressingVersion, XmlWriter) WriteTo(AddressingVersion, XmlWriter)

Enregistre l'adresse de point de terminaison actuelle d'une version spécifiée sur un writer XML spécifié.Saves the current endpoint address of a specified version to a specified XML writer.

WriteTo(AddressingVersion, XmlWriter, String, String) WriteTo(AddressingVersion, XmlWriter, String, String) WriteTo(AddressingVersion, XmlWriter, String, String) WriteTo(AddressingVersion, XmlWriter, String, String)

Enregistre l'adresse de point de terminaison actuelle d'une version spécifiée sur un writer XML avec un espace de noms et un nom local spécifiés.Saves the current endpoint address of a specified version to an XML writer with a specified namespace and local name.

Opérateurs

Equality(EndpointAddress, EndpointAddress) Equality(EndpointAddress, EndpointAddress) Equality(EndpointAddress, EndpointAddress) Equality(EndpointAddress, EndpointAddress)

Retourne une valeur qui indique si des adresses de point de terminaison spécifiées ne sont pas équivalentes.Returns a value that indicates whether specified endpoint addresses are not equivalent.

Inequality(EndpointAddress, EndpointAddress) Inequality(EndpointAddress, EndpointAddress) Inequality(EndpointAddress, EndpointAddress) Inequality(EndpointAddress, EndpointAddress)

Retourne une valeur qui indique si des adresses de point de terminaison spécifiées ne sont pas équivalentes.Returns a value that indicates whether specified endpoint addresses are not equivalent.

S’applique à