Click here to Skip to main content
14,700,282 members
Articles » Platforms, Frameworks & Libraries » Windows Communication Foundation » General
Posted 3 Jun 2009


12 bookmarked

Add custom headers to a WCF channel

Rate me:
Please Sign up or sign in to vote.
2.38/5 (11 votes)
3 Jun 2009CPOL
This piece describes how to add custom headers to a WCF channel and how to use them.


Very often, when designing WCF based SOA services, we run into the need of passing some information repeatedly from the client to the service.

One example would be a user identity information like user ID or the client application identifier. The WCF service needs the user ID information for logging purposes. So for each method call, you have to pass that information.

One way would be to pass it as an additional request parameter. But, each and every method call needs to have this parameter(s) repeatedly. Not a very clean solution. Also, if the data type of this parameter changes, all the method signatures and their calls need to be changed.

A better way to handle this requirement is to add this information to the WCF channel header.

Let's code

First of all, we will add the custom header in the proxy constructor. (Hope you are not using Visual Studio to generate the proxies, or your code would be lost the next time you generate it. Proxy generation using Visual Studio is OK initially when you create the service. You do not have to keep on doing it for each change to the service methods. It is very simple to go to the proxy class and do it manually.)

using System.ServiceModel;
using System.ServiceModel.Channels;

public partial class ZipServiceClient : 
       System.ServiceModel.ClientBase<IZipService>, IZipService
    //Proxy constructor
    public ZipServiceClient()
        //Add basic information to the custom header
           new OperationContextScope(base.InnerChannel));
    // Scope is being passed. Note - If you have multiple service, you can move
    // this method to a common static class.
    // That way you would not have to same code all the proxy files.
    private static void AddCustomHeaderUserInformation(
                                 OperationContextScope scope)
        //Add the basic userId
        MessageHeader<int> customHeaderUserID = 
          new MessageHeader<int>(<State.UserIDToken>);
        MessageHeader untypedHeaderUserID = 

The user ID here is being read from State(session). You would need to replace it to whatever storage location your information is in. Next, we will read the headers in our service.

using System.Runtime.Serialization;
using System.ServiceModel; 

 // Read the headers 

int userID = 
  "UserID", "CustomHeader");

Note: These headers are available anywhere behind the WCF service. You can access them on the Service implementation code and from the layer behind the service.

That's it. It is quite straightforward. I hope I didn't miss any detail. Email me if you have any questions.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Software Developer (Senior)
United States United States
I have been designing and developing solutions on Microsoft platform for over 12 years in various roles and capacities.

Comments and Discussions

GeneralMy vote of 1 Pin
Daniel Murari Boatto17-Sep-14 5:05
MemberDaniel Murari Boatto17-Sep-14 5:05 
GeneralMy vote of 3 Pin
Christian Amado30-Jul-12 5:48
professionalChristian Amado30-Jul-12 5:48 
QuestionYou are missing a detail Pin
jbrentonprivate19-Jul-12 11:27
Memberjbrentonprivate19-Jul-12 11:27 
GeneralMy vote of 2 Pin
Marcelo Lujan [El Bebe.Net ]14-Feb-12 6:31
MemberMarcelo Lujan [El Bebe.Net ]14-Feb-12 6:31 
GeneralMy vote of 5 Pin
Sandeepkumar Ramani15-Sep-11 4:00
MemberSandeepkumar Ramani15-Sep-11 4:00 
GeneralIssue adding the custom http headers in WCF routing service Pin
Vivekanand H19-Apr-11 5:36
MemberVivekanand H19-Apr-11 5:36 
GeneralMy vote of 1 Pin
steliodibello25-Aug-10 22:56
Membersteliodibello25-Aug-10 22:56 
QuestionHow to add the header information Pin
Member 45016504-Mar-10 22:16
MemberMember 45016504-Mar-10 22:16 
AnswerRe: How to add the header information Pin
Vivekanand H15-Apr-11 1:11
MemberVivekanand H15-Apr-11 1:11 
AnswerRe: How to add the header information Pin
Marcelo Lujan [El Bebe.Net ]14-Feb-12 8:56
MemberMarcelo Lujan [El Bebe.Net ]14-Feb-12 8:56 
GeneralMy vote of 2 Pin
ramuknavap27-Oct-09 14:15
Memberramuknavap27-Oct-09 14:15 
QuestionHow? Pin
eidylon28-Sep-09 10:48
Membereidylon28-Sep-09 10:48 
GeneralMy vote of 2 Pin
Bad code hunter4-Jun-09 2:02
MemberBad code hunter4-Jun-09 2:02 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.