- Supports all Stack Exchange API V2 methods
- Easy to use: one-to-one mapping between StacMan and API methods/params
- Async is easy: methods return
Task<T>so they're ready for C# 5'sawait - Validates that fields are included in the filter (optional – see FilterBehavior below)
- Adheres to the API's throttling rules
StacMan is available on NuGet:
PM> Install-Package StacMan
using StackExchange.StacMan;
...
var client = new StacManClient(FilterBehavior.Strict, key: "my-app-key");
client.RegisterFilters("!mDO35lQRaz");
Synchronous
var response = client.Questions.GetAll("stackoverflow",
page: 1,
pagesize: 10,
sort: Questions.AllSort.Creation,
order: Order.Desc,
filter: "!mDO35lQRaz").Result;
foreach (var question in response.Data.Items)
{
Console.WriteLine(question.Title);
}
Asynchronous
var task = client.Questions.GetAll("stackoverflow",
page: 1,
pagesize: 10,
sort: Questions.AllSort.Creation,
order: Order.Desc,
filter: "!mDO35lQRaz");
task.ContinueWith(t =>
{
foreach (var user in t.Result.Data.Items)
{
Console.WriteLine(question.Title);
}
});
Asynchronous (C# 5)
var response = await client.Questions.GetAll("stackoverflow",
page: 1,
pagesize: 10,
sort: Questions.AllSort.Creation,
order: Order.Desc,
filter: "!mDO35lQRaz");
foreach (var user in response.Data.Items)
{
Console.WriteLine(question.Title);
}
The StacManClient constructor takes a FilterBehavior enum, which can be either Strict or Loose:
FilterBehavior.Strict
- Getting a property not included in the filter throws a
FilterException. - All filters must be "registered" (with the
RegisterFiltersmethod) prior to being used.- IMPORTANT:
RegisterFiltersincurs one API call (per 20 unregistered filters) each time it's called, so for best performance, it should be called sparingly and at most once per filter, e.g. once only when your app starts. (The "default" filter does not need to be registered.)
- IMPORTANT:
FilterBehavior.Loose
- Getting a property not included in the filter returns that property type's default value.
- Filters do not need to be "registered".