Finish sample

samples/azure-service-bus-netstandard/options/ASBS_5/Publisher/Program.cs

@@ -13,12 +13,15 @@
 
 builder.Services.AddAzureServiceBusTopology(builder.Configuration);
 
-var section = builder.Configuration.GetSection("AzureServiceBus");
-
 var endpointConfiguration = new EndpointConfiguration("Samples.AzureServiceBus.Options.Publisher");
+
+#region OptionsLoading
+var section = builder.Configuration.GetSection("AzureServiceBus");
 var topologyOptions = section.GetSection("Topology").Get<TopologyOptions>()!;
 var topology = TopicTopology.FromOptions(topologyOptions);
 endpointConfiguration.UseTransport(new AzureServiceBusTransport(section["ConnectionString"]!, topology));
+#endregion
+
 endpointConfiguration.UseSerialization<SystemJsonSerializer>();
 endpointConfiguration.DefineCriticalErrorAction(OnCriticalError);
 endpointConfiguration.EnableInstallers();

samples/azure-service-bus-netstandard/options/ASBS_5/Publisher/ServiceCollectionExtensions.cs

@@ -9,7 +9,9 @@ public static void AddAzureServiceBusTopology(
         this IServiceCollection services,
         IConfiguration configuration)
     {
+        #region OptionsValidation
         services.AddSingleton<IValidateOptions<TopologyOptions>, TopologyOptionsValidator>();
         services.AddOptions<TopologyOptions>().Bind(configuration.GetSection("AzureServiceBus:Topology")).ValidateOnStart();
+        #endregion
     }
 }

samples/azure-service-bus-netstandard/options/ASBS_5/Publisher/appsettings.json

@@ -11,6 +11,7 @@
             }
         }
     },
+// startcode PublisherAppsettings
     "AzureServiceBus": {
         "ConnectionString": "Endpoint=sb://...;SharedAccessKeyName=...;SharedAccessKey=...",
         "Topology": {
@@ -20,4 +21,5 @@
             }
         }
     }
+// endcode
 }

samples/azure-service-bus-netstandard/options/ASBS_5/Subscriber/appsettings.json

@@ -11,6 +11,7 @@
             }
         }
     },
+// startcode SubscriberAppsettings
     "AzureServiceBus": {
         "ConnectionString": "Endpoint=sb://...;SharedAccessKeyName=...;SharedAccessKey=...",
         "Topology": {
@@ -20,4 +21,5 @@
             }
         }
     }
+// endcode
 }

samples/azure-service-bus-netstandard/options/sample.md

@@ -17,14 +17,32 @@ include: asb-connectionstring-xplat
 
 The sample contains three executable projects:
 
- * `Publisher`: an NServiceBus endpoint that publishes `EventOne` to topic `event-one` and `EventTwo` to `event-two`.
- * `Subscriber`: an NServiceBus endpoint subscribing to the `EventOne` and `EventTwo` event published by the `Publisher`.
+* `Publisher`: an NServiceBus endpoint that publishes `EventOne` to topic `event-one` and `EventTwo` to `event-two`.
+* `Subscriber`: an NServiceBus endpoint subscribing to the `EventOne` and `EventTwo` event published by the `Publisher`.
+
+### Configuration from options
+
+With the generic hosts ability to load configuration sections it is a matter of loading the topology options from the section in the application settings as shown below:
+
+Snippet: OptionsLoading
+
+In this example the publisher overrides the default topic destination to a custom conventions instead of using the default fullname of the event type:
+
+Snippet: PublisherAppsettings
+
+The subscriber needs to override the subscription mapping accordingly:
+
+Snippet: SubscriberAppsettings
+
+### Validation
+
+The transport provides integration with Microsoft.Extensions.Options and has a built-in options validator. With the generic host it is possible to register the validator to make sure the configuration loaded fulfills the requirements of the broker (e.g. topic name length) and is self-consistent.
+
+Snippet: OptionsValidation
 
 ## Running the sample
 
 1. First, run the `Subscriber` project by itself. This will create all the necessary publish/subscribe infrastructure in Azure Service Bus.
 2. Run the projects normally so that all endpoints start.
 3. The `Publisher` endpoint continuously published two events with a short pause in between.
     * The endpoint in the `Subscriber` window will receive both `EventOne` and `EventTwo`.
-
-TBD