Amazon Web Services .Net SDK using .With methods

Question

I notice that many of the Request objects that can be created with the AWS SDK for .Net have .With() methods along with public properties that can be set directly.

My question is there a reason to use the .With method as opposed to just setting the property ie:

var listQueuesRequest = new ListQueuesRequest().WithQueueNamePrefix(queueNamePrefix);

or

var listQueuesRequest = new ListQueuesRequest() {
    QueueNamePrefix = queueNamePrefix
};

Answer 1

It's a programming style called Method chaining originating mainly from Java programming in order to create a Fluent interface .

The WithQueueNamePrefix() method will return the same ListQueuesRequest object so that you can immediately continue "chaining" more statements on the same object. The idea is that this improves readability and amount of source code, although not everybody agrees.