OperationContextScope

В примере OperationContextScope показано, как отправлять дополнительные сведения о вызове Windows Communication Foundation (WCF) с помощью заголовков. В этом примере сервер и клиент являются консольными приложениями.

Замечание

Процедура установки и инструкции по сборке для этого примера находятся в конце этого раздела.

В примере показано, как клиент может отправить дополнительные сведения, используя MessageHeader и OperationContextScope. Объект OperationContextScope создается путем задания области канала. Заголовки, которые необходимо передать в удаленную службу, можно добавить в коллекцию OutgoingMessageHeaders. Заголовки, добавленные в эту коллекцию, можно получить в службе, обратившись к IncomingMessageHeaders. Его вызовы выполняются в нескольких каналах, а затем заголовки, добавленные клиенту, применяются только к каналу, который использовался для создания OperationContextScope.

ЧитательЗаголовковСообщений

Это пример службы, которая получает сообщение от клиента и пытается найти заголовок в IncomingMessageHeaders коллекции. Клиент передает GUID, который он отправил в заголовке, и служба извлекает пользовательский заголовок и, если он есть, сравнивает его с GUID, переданным клиентом в качестве аргумента.

public bool RetrieveHeader(string guid)
{
     MessageHeaders messageHeaderCollection =
             OperationContext.Current.IncomingMessageHeaders;
     String guidHeader = null;

     Console.WriteLine("Trying to check if IncomingMessageHeader " +
               " collection contains header with value {0}", guid);
     if (messageHeaderCollection.FindHeader(
                       CustomHeader.HeaderName,
                       CustomHeader.HeaderNamespace) != -1)
     {
          guidHeader = messageHeaderCollection.GetHeader<String>(
           CustomHeader.HeaderName, CustomHeader.HeaderNamespace);
     }
     else
     {
          Console.WriteLine("No header was found");
     }
     if (guidHeader != null)
     {
          Console.WriteLine("Found header with value {0}. "+
         "Does it match with GUID sent as parameter: {1}",
          guidHeader, guidHeader.Equals(guid));
      }

      Console.WriteLine();
      //Return true if header is present and equals the guid sent by
      // client as argument
      return (guidHeader != null && guidHeader.Equals(guid));
}

MessageHeaderClient

Это реализация клиента, использующая прокси, сгенерированный утилитой метаданных ServiceModel (Svcutil.exe), для связи с удаленной службой. Сначала он создает два прокси-объекта MessageHeaderReaderClient.

//Create two clients to the remote service.
MessageHeaderReaderClient client1 = new MessageHeaderReaderClient();
MessageHeaderReaderClient client2 = new MessageHeaderReaderClient();

Затем клиент создает OperationContextScope и привязывает его к client1. Он добавляет MessageHeader к OutgoingMessageHeaders и совершает один вызов для обоих клиентов. Это гарантирует, что заголовок отправляется только на client1 и не на client2 путем проверки значения, возвращаемого вызовом RetrieveHeader.

using (new OperationContextScope(client1.InnerChannel))
{
    //Create a new GUID that is sent as the header.
    String guid = Guid.NewGuid().ToString();

    //Create a MessageHeader for the GUID we just created.
    MessageHeader customHeader = MessageHeader.CreateHeader(CustomHeader.HeaderName, CustomHeader.HeaderNamespace, guid);

    //Add the header to the OutgoingMessageHeader collection.
    OperationContext.Current.OutgoingMessageHeaders.Add(customHeader);

    //Now call RetrieveHeader on both the proxies. Since the OperationContextScope is tied to
    //client1's InnerChannel, the header should only be added to calls made on that client.
    //Calls made on client2 should not be sending the header across even though the call
    //is made in the same OperationContextScope.
    Console.WriteLine("Using client1 to send message");
    Console.WriteLine("Did server retrieve the header? : Actual: {0}, Expected: True", client1.RetrieveHeader(guid));

    Console.WriteLine();
    Console.WriteLine("Using client2 to send message");
    Console.WriteLine("Did server retrieve the header? : Actual: {0}, Expected: False", client2.RetrieveHeader(guid));
}

Этот пример размещен самостоятельно. Приведены следующие выходные данные из запуска примера:

Prompt> Service.exe
The service is ready.
Press <ENTER> to terminate service.

Trying to check if IncomingMessageHeader collection contains header with value 2239da67-546f-42d4-89dc-8eb3c06215d8
Found header with value 2239da67-546f-42d4-89dc-8eb3c06215d8. Does it match with GUID sent as parameter: True

Trying to check if IncomingMessageHeader collection contains header with value 2239da67-546f-42d4-89dc-8eb3c06215d8
No header was found

Prompt>Client.exe
Using client1 to send message
Did server retrieve the header? : Actual: True, Expected: True

Using client2 to send message
Did server retrieve the header? : Actual: False, Expected: False

Press <ENTER> to terminate client.

Настройка, сборка и запуск примера

1. Убедитесь, что вы выполнили процедуру настройки One-Time для образцов Windows Communication Foundation.

2. Чтобы создать версию решения на C# или Visual Basic .NET, следуйте инструкциям по сборке примеров Windows Communication Foundation .

3. Чтобы запустить пример в конфигурации с одним или несколькими компьютерами, следуйте инструкциям в запуска примеров Windows Communication Foundation.