/// <summary>Initializes the provider.</summary>
/// <param name="name">The friendly name of the provider.</param>
/// <param name="config">A collection of the name/value pairs representing the provider-specific
/// attributes specified in the configuration for this provider.</param>
/// <exception cref="ArgumentNullException">Thrown when <paramref name="config"/> is null.</exception>
/// <exception cref="ArgumentException">Thrown when the name of the provider has a length of zero.</exception>
/// <exception cref="InvalidOperationException">Thrown when an attempt is made to call Initialize on a
/// provider after the provider has already been initialized.</exception>
/// <exception cref="ProviderException">Thrown when the <paramref name="config"/> contains
/// unrecognized attributes or when the connectionStringName attribute is not configured properly.</exception>
public override void Initialize(string name, NameValueCollection config)
{
if (config == null)
{
throw new ArgumentNullException("config");
}
LoggingHelper.SetDescriptionWhenMissing(config, "SQL logging provider");
// Call initialize first.
base.Initialize(name, config);
// Performing implementation-specific provider initialization here.
this.InitializeConnectionString(config);
bool mustInitializeSchema = this.GetInitializeSchemaAttributeFromConfig(config);
// Check if the configuration is valid, before initializing the database.
this.CheckForUnrecognizedAttributes(name, config);
// When the initialization of the database schema is registered in the configuration file, we
// execute creation of tables and stored procedures.
if (mustInitializeSchema)
{
this.InitializeDatabaseSchema();
}
this.SetInitialized(true);
}
/// <summary>Initializes the provider.</summary>
/// <param name="name">The friendly name of the provider.</param>
/// <param name="config">A collection of the name/value pairs representing the provider-specific
/// attributes specified in the configuration for this provider.</param>
/// <remarks>
/// Inheritors should call <b>base.Initialize</b> before performing implementation-specific provider
/// initialization and call <see cref="LoggingProviderBase.CheckForUnrecognizedAttributes"/> last.
/// </remarks>
/// <exception cref="ArgumentNullException">Thrown when the name of the provider is null or when the
/// <paramref name="config"/> is null.</exception>
/// <exception cref="ArgumentException">Thrown when the name of the provider has a length of zero.</exception>
/// <exception cref="InvalidOperationException">Thrown when an attempt is made to call Initialize on a
/// provider after the provider has already been initialized.</exception>
/// <exception cref="ProviderException">Thrown when the <paramref name="config"/> contains
/// unrecognized attributes.</exception>
public override void Initialize(string name, NameValueCollection config)
{
if (config == null)
{
throw new ArgumentNullException("config");
}
LoggingHelper.SetDescriptionWhenMissing(config, "Debug logging provider");
// Call initialize first.
base.Initialize(name, config);
// Always call this method last
this.CheckForUnrecognizedAttributes(name, config);
}
/// <summary>Initializes the provider.</summary>
/// <param name="name">The friendly name of the provider.</param>
/// <param name="config">A collection of the name/value pairs representing the provider-specific
/// attributes specified in the configuration for this provider.</param>
/// <exception cref="ArgumentNullException">Thrown when the name of the provider is null or when the
/// <paramref name="config"/> is null.</exception>
/// <exception cref="ArgumentException">Thrown when the name of the provider has a length of zero.</exception>
/// <exception cref="InvalidOperationException">Thrown when an attempt is made to call Initialize on a
/// provider after the provider has already been initialized.</exception>
/// <exception cref="ProviderException">Thrown when the <paramref name="config"/> contains
/// unrecognized attributes.</exception>
public override void Initialize(string name, NameValueCollection config)
{
if (config == null)
{
throw new ArgumentNullException("config");
}
LoggingHelper.SetDescriptionWhenMissing(config, "Composite logging provider");
// Call base initialize first. This method prevents initialize from being called more than once.
base.Initialize(name, config);
// Performing implementation-specific provider initialization here (this is the 1st part).
this.InitializeProviderNames(config);
// Always call this method last
this.CheckForUnrecognizedAttributes(name, config);
}
/// <summary>Initializes the provider.</summary>
/// <param name="name">The friendly name of the provider.</param>
/// <param name="config">A collection of the name/value pairs representing the provider-specific
/// attributes specified in the configuration for this provider.</param>
/// <exception cref="ArgumentNullException">Thrown when the name of the provider is null or when the
/// <paramref name="config"/> is null.</exception>
/// <exception cref="ArgumentException">Thrown when the name of the provider has a length of zero.</exception>
/// <exception cref="InvalidOperationException">Thrown when an attempt is made to call Initialize on a
/// provider after the provider has already been initialized.</exception>
/// <exception cref="ProviderException">Thrown when the <paramref name="config"/> contains
/// unrecognized attributes.</exception>
public override void Initialize(string name, NameValueCollection config)
{
if (config == null)
{
throw new ArgumentNullException("config");
}
LoggingHelper.SetDescriptionWhenMissing(config, "Terminator logging provider");
// Check for unsupported attributes fallbackProvider and threshold before calling base.Initialize.
this.ThrowWhenConfigContainsFallbackProvider(name, config);
this.ThrowWhenConfigContainsThreshold(name, config);
// Call base initialize first. This method prevents initialize from being called more than once.
base.Initialize(name, config);
// Always call this method last
this.CheckForUnrecognizedAttributes(name, config);
}
/// <summary>Initializes the provider.</summary>
/// <param name="name">The friendly name of the provider.</param>
/// <param name="config">A collection of the name/value pairs representing the provider-specific
/// attributes specified in the configuration for this provider.</param>
/// <exception cref="ArgumentNullException">Thrown when the name of the provider is null or when the
/// <paramref name="config"/> is null.</exception>
/// <exception cref="ArgumentException">Thrown when the name of the provider has a length of zero.</exception>
/// <exception cref="InvalidOperationException">Thrown when an attempt is made to call Initialize on a
/// provider after the provider has already been initialized.</exception>
/// <exception cref="ProviderException">Thrown when the <paramref name="config"/> contains
/// unrecognized attributes or the provider could not initialized correctly.</exception>
public override void Initialize(string name, NameValueCollection config)
{
if (config == null)
{
throw new ArgumentNullException("config");
}
LoggingHelper.SetDescriptionWhenMissing(config, "XML file logging provider");
// Call initialize first.
base.Initialize(name, config);
// Performing implementation-specific provider initialization here.
this.InitializePath(config);
// Check if the configuration is valid, before testing file authorizations.
this.CheckForUnrecognizedAttributes(name, config);
this.CheckAuthorizationsByCreatingFile();
this.SetInitialized(true);
}
/// <summary>Initializes the provider.</summary>
/// <param name="name">The friendly name of the provider.</param>
/// <param name="config">A collection of the name/value pairs representing the provider-specific
/// attributes specified in the configuration for this provider.</param>
/// <remarks>
/// Inheritors should call <b>base.Initialize</b> before performing implementation-specific provider
/// initialization and call
/// <see cref="LoggingProviderBase.CheckForUnrecognizedAttributes">CheckForUnrecognizedAttributes</see>
/// last.
/// </remarks>
/// <exception cref="ArgumentNullException">Thrown when the name of the provider is null or when the
/// <paramref name="config"/> is null.</exception>
/// <exception cref="ArgumentException">Thrown when the name of the provider has a length of zero.</exception>
/// <exception cref="InvalidOperationException">Thrown when an attempt is made to call Initialize on a
/// provider after the provider has already been initialized.</exception>
/// <exception cref="ProviderException">Thrown when the <paramref name="config"/> contains
/// unrecognized attributes or when the subjectFormatString is formatted incorrectly.</exception>
public override void Initialize(string name, NameValueCollection config)
{
if (config == null)
{
throw new ArgumentNullException("config");
}
LoggingHelper.SetDescriptionWhenMissing(config, "Mail logging provider");
// Call base initialize first. This method prevents initialize from being called more than once.
base.Initialize(name, config);
// Performing implementation-specific provider initialization here.
this.InitializeToProperty(config);
this.InitializeSubjectFormatStringProperty(config);
this.ValidateDotNetMailConfiguration();
// Always call this method last
this.CheckForUnrecognizedAttributes(name, config);
this.SetInitialized(true);
}