Class SqlServerConnectionCopyOptions

Namespace

ItTiger.TigerQuery.Core

Assembly

ItTiger.TigerQuery.Core.dll

Describes the controlled overrides applied by Copy(string, SqlServerConnectionCopyOptions, SqlServerConnectionValidationPolicy?) to a copied connection profile.

public sealed class SqlServerConnectionCopyOptions

Inheritance

object

SqlServerConnectionCopyOptions

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Remarks

Everything the source profile persists is preserved unless it is named here. That includes the authentication mode, the protected password representation, free-form connection-string options, and every metadata entry.

Metadata keys are compared ordinally and case-sensitively and are never trimmed or normalized, exactly as elsewhere in the connection model.

Properties

InitialCatalogOverride

Gets the replacement initial catalog for the copy.

public string? InitialCatalogOverride { get; init; }

Property Value

string

Remarks

null preserves the source database, an empty string clears it to produce a server-level profile, and any other value replaces it.

MetadataToRemove

Gets metadata keys removed from the copy.

public IReadOnlyCollection<string> MetadataToRemove { get; init; }

Property Value

IReadOnlyCollection<string>

Remarks

Removals are applied before MetadataToSet. A key present in both collections is rejected rather than silently resolved.

MetadataToSet

Gets metadata entries added to, or replaced on, the copy.

public IReadOnlyDictionary<string, string> MetadataToSet { get; init; }

Property Value

IReadOnlyDictionary<string, string>

Remarks

Keys must be non-empty and values must not be null.

TargetName

Gets the nonblank name given to the copied profile.

public required string TargetName { get; init; }

Property Value

string

Remarks

The name must not already exist in the store; copy is never an upsert.