AgentPrismSqlServerBuilderExtensions
AgentPrism.SqlServer.dllExtensions that add SQL Server persistence to the AgentPrism chain.
public static class AgentPrismSqlServerBuilderExtensionsInheritance
Section titled “Inheritance”object ← AgentPrismSqlServerBuilderExtensions
Inherited Members
Section titled “Inherited Members”object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Methods
Section titled “Methods”UseSqlServer(IAgentPrismBuilder, string)
Section titled “ UseSqlServer(IAgentPrismBuilder, string)”Enables SQL Server persistence given a connection string.
public static IAgentPrismBuilder UseSqlServer(this IAgentPrismBuilder builder, string connectionString)Parameters
Section titled “Parameters”builder IAgentPrismBuilder
The AgentPrism chain.
connectionString string
The SQL Server connection string.
Returns
Section titled “Returns”The continuation of the chain.
Remarks
Section titled “Remarks”builder.AddAgentPrism() .UseSqlServer(builder.Configuration.GetConnectionString("AgentPrism")!);Exceptions
Section titled “Exceptions”builder is null.
connectionString is empty.
UseSqlServer(IAgentPrismBuilder, IConfiguration)
Section titled “ UseSqlServer(IAgentPrismBuilder, IConfiguration)”Enables SQL Server persistence, reading settings from the AgentPrism:SqlServer section.
public static IAgentPrismBuilder UseSqlServer(this IAgentPrismBuilder builder, IConfiguration configurationSection)Parameters
Section titled “Parameters”builder IAgentPrismBuilder
The AgentPrism chain.
configurationSection IConfiguration
The section settings are read from. Usually
configuration.GetSection(AgentPrismSqlServerOptions.SectionName).
Returns
Section titled “Returns”The continuation of the chain.
Exceptions
Section titled “Exceptions”One of the parameters is null.
UseSqlServer(IAgentPrismBuilder, Action<AgentPrismSqlServerOptions>)
Section titled “ UseSqlServer(IAgentPrismBuilder, Action<AgentPrismSqlServerOptions>)”Enables SQL Server persistence with settings given in code.
public static IAgentPrismBuilder UseSqlServer(this IAgentPrismBuilder builder, Action<AgentPrismSqlServerOptions> configure)Parameters
Section titled “Parameters”builder IAgentPrismBuilder
The AgentPrism chain.
configure Action<AgentPrismSqlServerOptions>
The settings mutator.
Returns
Section titled “Returns”The continuation of the chain.
Remarks
Section titled “Remarks”Stores are registered with ServiceCollectionDescriptorExtensions.Replace,
not TryAdd. AddAgentPrism has already registered the
in-memory stores with TryAddSingleton and runs before this
call in the chain; using TryAdd here would silently do nothing.
Overwriting is correct here because UseSqlServer is the
consumer’s explicit choice. The “register with TryAdd”
rule is for AgentPrism’s defaults, not for explicit calls.
Exceptions
Section titled “Exceptions”One of the parameters is null.