MetadataExchangeClient Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Descarrega metadados do serviço.
public ref class MetadataExchangeClient
public class MetadataExchangeClient
type MetadataExchangeClient = class
Public Class MetadataExchangeClient
- Herança
-
MetadataExchangeClient
Exemplos
O exemplo de código seguinte mostra a utilização de MetadataExchangeClient para especificar uma ligação de download, resolver quaisquer referências contidas a metadados e descarregar os metadados.
// Get metadata documents.
Console.WriteLine("URI of the metadata documents retreived:");
MetadataExchangeClient metaTransfer
= new MetadataExchangeClient(httpGetMetaAddress.Uri, MetadataExchangeClientMode.HttpGet);
metaTransfer.ResolveMetadataReferences = true;
MetadataSet otherDocs = metaTransfer.GetMetadata();
foreach (MetadataSection doc in otherDocs.MetadataSections)
Console.WriteLine(doc.Dialect + " : " + doc.Identifier);
Observações
Use o MetadataExchangeClient para descarregar metadados. Normalmente, a MetadataExchangeClient é configurado para um pedido de metadados e depois passado para o MetadataResolver.Resolve método ou MetadataResolver.Resolve para que o MetadataResolver utilize para descarregar metadados.
No entanto, pode usar diretamente MetadataExchangeClient para recuperar metadados como um MetadataSet que contém MetadataSection objetos.
Quer seja usado diretamente ou passado para um MetadataResolver, MetadataExchangeClient tem os seguintes membros para controlar o processo de download de metadados:
Use os construtores para personalizar a ligação a usar ao fazer o pedido de metadados.
Use a HttpCredentials propriedade para especificar as credenciais usadas para fazer um pedido HTTP/GET.
Use a SoapCredentials propriedade para especificar as credenciais usadas para fazer um pedido de metadados WS-Transfer.
Use a MaximumResolvedReferences propriedade para limitar o número de referências a metadados que resolve MetadataExchangeClient .
Use a OperationTimeout propriedade para limitar o tempo gasto a recuperar metadados.
Use a ResolveMetadataReferences propriedade para especificar se deve localizar e recuperar outros documentos de metadados referidos pelos metadados descarregados do endpoint original de metadados.
Use os GetMetadata métodos para iniciar o processo de download.
Além disso, pode criar uma classe derivada que possa sobrepor os seguintes dois métodos protegidos:
Substitua o GetChannelFactory método para modificar o canal que faz um pedido de metadados usando o WS-Transfer.
Substitua o GetWebRequest método para modificar o HttpWebRequest que faz um pedido de metadados usando HTTP/GET.
Construtores
| Name | Description |
|---|---|
| MetadataExchangeClient() |
Inicializa uma nova instância da MetadataExchangeClient classe. |
| MetadataExchangeClient(Binding) |
Inicializa uma nova instância da MetadataExchangeClient classe usando a ligação especificada. |
| MetadataExchangeClient(EndpointAddress) |
Inicializa uma nova instância da MetadataExchangeClient classe. |
| MetadataExchangeClient(String) |
Inicializa uma nova instância da MetadataExchangeClient classe. |
| MetadataExchangeClient(Uri, MetadataExchangeClientMode) |
Inicializa uma nova instância da MetadataExchangeClient classe. |
Propriedades
| Name | Description |
|---|---|
| HttpCredentials |
Obtém ou define as credenciais usadas para fazer um pedido HTTP/GET. |
| MaximumResolvedReferences |
Obtém ou define o número máximo de referências aos metadados que descarrega MetadataExchangeClient . |
| OperationTimeout |
Obtém ou define o período de tempo dentro do qual os metadados devem ser descarregados antes de uma exceção ser lançada. |
| ResolveMetadataReferences |
Recebe ou define um valor que controla se as referências a metadados são resolvidas. |
| SoapCredentials |
Obtém ou definem as credenciais de segurança do cliente usadas para fazer um pedido de metadados WS-Transfer. |
Métodos
| Name | Description |
|---|---|
| BeginGetMetadata(AsyncCallback, Object) |
Inicia uma chamada de método assíncrona que devolve um MetadataSet. |
| BeginGetMetadata(EndpointAddress, AsyncCallback, Object) |
Inicia uma chamada de método assíncrona que devolve a MetadataSet usando o endereço especificado, callback e estado assíncrono. |
| BeginGetMetadata(Uri, MetadataExchangeClientMode, AsyncCallback, Object) |
Inicia uma chamada de método assíncrona que retorna a MetadataSet usando o endereço especificado, callback, estado assíncrono e mecanismo de download. |
| EndGetMetadata(IAsyncResult) |
Termina uma chamada de método assíncrona que retorna um MetadataSet. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetChannelFactory(EndpointAddress, String, String) |
Quando sobrescrito numa classe derivada, devolve a fábrica de canal usada para fazer o pedido de metadados WS-Transfer. |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetMetadata() |
Devolve um MetadataSetficheiro . |
| GetMetadata(EndpointAddress, Uri) |
Retorna a MetadataSet do endereço especificado e na rota especificada. |
| GetMetadata(EndpointAddress) |
Retorna a MetadataSet do endereço especificado. |
| GetMetadata(Uri, MetadataExchangeClientMode) |
Retorna a MetadataSet do endereço especificado usando o modo de download especificado. |
| GetMetadataAsync() |
Devolve um conjunto de metadados assíncronos. |
| GetMetadataAsync(EndpointAddress, Uri) |
Devolve um conjunto de metadados assíncronos do endereço especificado e na rota especificada. |
| GetMetadataAsync(EndpointAddress) |
Devolve um conjunto de metadados assíncronos do endereço especificado. |
| GetMetadataAsync(Uri, MetadataExchangeClientMode) |
Devolve um conjunto de metadados assíncronos do endereço especificado usando o modo de download especificado. |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetWebRequest(Uri, String, String) |
Quando sobrescrito numa classe derivada, devolve o HttpWebRequest usado para fazer pedidos de metadados HTTP/GET. |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |