Skip to main content
Version: v1.46.0

.Net

NuGet Version NuGet Downloads

Install dependencies​

The first things we will do is install the Open Feature SDK and the GO Feature Flag provider.

dotnet add package OpenFeature.Contrib.GOFeatureFlag

Initialize your Open Feature client​

To evaluate the flags you need to have an Open Feature configured in you app. This code block shows you how you can create a client that you can use in your application.

using OpenFeature;
using OpenFeature.Contrib.GOFeatureFlag;

// ...

var goFeatureFlagProvider = new GoFeatureFlagProvider(new GoFeatureFlagProviderOptions
{
    Endpoint = "http://localhost:1031/",
    Timeout = new TimeSpan(1000 * TimeSpan.TicksPerMillisecond)
});
Api.Instance.SetProvider(goFeatureFlagProvider);
var client = Api.Instance.GetClient("my-app");

Evaluate your flag​

This code block explain how you can create an EvaluationContext and use it to evaluate your flag.

note

In this example we are evaluating a boolean flag, but other types are also available.

Refer to the Open Feature documentation to know more about it.

// Context of your flag evaluation.
// With GO Feature Flag you MUST have a targetingKey that is a unique identifier of the user.
var userContext = EvaluationContext.Builder()
    .Set("targetingKey", "1d1b9238-2591-4a47-94cf-d2bc080892f1") // user unique identifier (mandatory)
    .Set("firstname", "john")
    .Set("lastname", "doe")
    .Set("email", "john.doe@gofeatureflag.org")
    .Set("admin", true) // this field is used in the targeting rule of the flag "flag-only-for-admin"
    .Set("anonymous", false)
    .Build();

var adminFlag = await client.GetBooleanValue("flag-only-for-admin", false, userContext);
if (adminFlag) {
   // flag "flag-only-for-admin" is true for the user
} else {
  // flag "flag-only-for-admin" is false for the user
}

Features status​

StatusFeatureDescription
Remote EvaluationThe provider is calling the remote server to evaluate the feature flags.
Tracking Flag EvaluationThe provider is tracking all the evaluations of your feature flags and you can export them using an exporter.
Configuration Change UpdatesThe provider is able to update the configuration based on the configuration, it means that the provider is able to react to any feature flag change on your configuration.
Provider Events ReactionsYou can add an event handler to the provider to react to the provider events.
ImplementedIn-progressNot implemented yet

Contribute to the provider​

You can find the source of the provider in the open-feature/dotnet-sdk-contrib repository.