#region Fields

/// <summary>

/// Cached DataSource value to reduce allocations on NpgsqlConnection.DataSource.get

/// </summary>

string? _dataSourceCached;

internal string? DataSourceCached

=> _dataSourceCached ??= _host is null || _host.Contains(",")

? null

: IsUnixSocket(_host, _port, out var socketPath, replaceForAbstract: false)

? socketPath

: $"tcp://{_host}:{_port}";

// Note that we can't cache the result due to nullable's assignment not being thread safe

internal TimeSpan HostRecheckSecondsTranslated

=> TimeSpan.FromSeconds(HostRecheckSeconds == 0 ? -1 : HostRecheckSeconds);

#endregion

#region Constructors

/// <summary>

/// Initializes a new instance of the NpgsqlConnectionStringBuilder class.

/// </summary>

public NpgsqlConnectionStringBuilder() => Init();

/// <summary>

/// Initializes a new instance of the NpgsqlConnectionStringBuilder class, optionally using ODBC rules for quoting values.

/// </summary>

/// <param name="useOdbcRules">true to use {} to delimit fields; false to use quotation marks.</param>

public NpgsqlConnectionStringBuilder(bool useOdbcRules) : base(useOdbcRules) => Init();

/// <summary>

/// Initializes a new instance of the NpgsqlConnectionStringBuilder class and sets its <see cref="DbConnectionStringBuilder.ConnectionString"/>.

/// </summary>

public NpgsqlConnectionStringBuilder(string? connectionString)

{

Init();

ConnectionString = connectionString;

}

// Method fake-returns an int only to make sure it's code-generated

private partial int Init();

/// <summary>

/// GeneratedAction and GeneratedActions exist to be able to produce a streamlined binary footprint for NativeAOT.

/// An idiomatic approach where each action has its own method would double the binary size of NpgsqlConnectionStringBuilder.

/// </summary>

enum GeneratedAction

{

Set,

Get,

Remove,

GetCanonical

}

private partial bool GeneratedActions(GeneratedAction action, string keyword, ref object? value);

#endregion

#region Non-static property handling

/// <summary>

/// Gets or sets the value associated with the specified key.

/// </summary>

/// <param name="keyword">The key of the item to get or set.</param>

/// <returns>The value associated with the specified key.</returns>

[AllowNull]

public override object this[string keyword]

{

get

{

if (!TryGetValue(keyword, out var value))

throw new ArgumentException("Keyword not supported: " + keyword, nameof(keyword));

return value;

}

set

{

if (value is null)

{

Remove(keyword);

return;

}

try

{

var val = value;

GeneratedActions(GeneratedAction.Set, keyword.ToUpperInvariant(), ref val);

}

catch (Exception e)

{

throw new ArgumentException("Couldn't set " + keyword, keyword, e);

}

}

}

object? IDictionary<string, object?>.this[string keyword]

{

get => this[keyword];

set => this[keyword] = value!;

}

/// <summary>

/// Adds an item to the <see cref="NpgsqlConnectionStringBuilder"/>.

/// </summary>

/// <param name="item">The key-value pair to be added.</param>

public void Add(KeyValuePair<string, object?> item)

=> this[item.Key] = item.Value!;

void IDictionary<string, object?>.Add(string keyword, object? value)

=> this[keyword] = value;

/// <summary>

/// Removes the entry with the specified key from the DbConnectionStringBuilder instance.

/// </summary>

/// <param name="keyword">The key of the key/value pair to be removed from the connection string in this DbConnectionStringBuilder.</param>

/// <returns><b>true</b> if the key existed within the connection string and was removed; <b>false</b> if the key did not exist.</returns>

public override bool Remove(string keyword)

{

object? value = null;

return GeneratedActions(GeneratedAction.Remove, keyword.ToUpperInvariant(), ref value);

}

/// <summary>

/// Removes the entry from the DbConnectionStringBuilder instance.

/// </summary>

/// <param name="item">The key/value pair to be removed from the connection string in this DbConnectionStringBuilder.</param>

/// <returns><b>true</b> if the key existed within the connection string and was removed; <b>false</b> if the key did not exist.</returns>

public bool Remove(KeyValuePair<string, object?> item)

=> Remove(item.Key);

/// <summary>

/// Clears the contents of the <see cref="NpgsqlConnectionStringBuilder"/> instance.

/// </summary>

public override void Clear()

{

Debug.Assert(Keys != null);

foreach (var k in (string[])Keys)

Remove(k);

}

/// <summary>

/// Determines whether the <see cref="NpgsqlConnectionStringBuilder"/> contains a specific key.

/// </summary>

/// <param name="keyword">The key to locate in the <see cref="NpgsqlConnectionStringBuilder"/>.</param>

/// <returns><b>true</b> if the <see cref="NpgsqlConnectionStringBuilder"/> contains an entry with the specified key; otherwise <b>false</b>.</returns>

public override bool ContainsKey(string keyword)

{

object? value = null;

return GeneratedActions(GeneratedAction.GetCanonical, (keyword ?? throw new ArgumentNullException(nameof(keyword))).ToUpperInvariant(), ref value);

}

/// <summary>

/// Determines whether the <see cref="NpgsqlConnectionStringBuilder"/> contains a specific key-value pair.

/// </summary>

/// <param name="item">The item to locate in the <see cref="NpgsqlConnectionStringBuilder"/>.</param>

/// <returns><b>true</b> if the <see cref="NpgsqlConnectionStringBuilder"/> contains the entry; otherwise <b>false</b>.</returns>

public bool Contains(KeyValuePair<string, object?> item)

=> TryGetValue(item.Key, out var value) &&

((value == null && item.Value == null) || (value != null && value.Equals(item.Value)));

/// <summary>

/// Retrieves a value corresponding to the supplied key from this <see cref="NpgsqlConnectionStringBuilder"/>.

/// </summary>

/// <param name="keyword">The key of the item to retrieve.</param>

/// <param name="value">The value corresponding to the key.</param>

/// <returns><b>true</b> if keyword was found within the connection string, <b>false</b> otherwise.</returns>

public override bool TryGetValue(string keyword, [NotNullWhen(true)] out object? value)

{

object? v = null;

var result = GeneratedActions(GeneratedAction.Get, (keyword ?? throw new ArgumentNullException(nameof(keyword))).ToUpperInvariant(), ref v);

value = v;

return result;

}

void SetValue(string propertyName, object? value)

{

object? canonicalKeyword = null;

var result = GeneratedActions(GeneratedAction.GetCanonical, (propertyName ?? throw new ArgumentNullException(nameof(propertyName))).ToUpperInvariant(), ref canonicalKeyword);

if (!result)

throw new KeyNotFoundException();

if (value == null)

base.Remove((string)canonicalKeyword!);

else

base[(string)canonicalKeyword!] = value;

}

#endregion

#region Properties - Connection

/// <summary>

/// The hostname or IP address of the PostgreSQL server to connect to.

/// </summary>

[Category("Connection")]

[Description("The hostname or IP address of the PostgreSQL server to connect to.")]

[DisplayName("Host")]

[NpgsqlConnectionStringProperty("Server")]

public string? Host

{

get => _host;

set

{

_host = value;

SetValue(nameof(Host), value);

_dataSourceCached = null;

}

}

string? _host;

/// <summary>

/// The TCP/IP port of the PostgreSQL server.

/// </summary>

[Category("Connection")]

[Description("The TCP port of the PostgreSQL server.")]

[DisplayName("Port")]

[NpgsqlConnectionStringProperty]

[DefaultValue(NpgsqlConnection.DefaultPort)]

public int Port

{

get => _port;

set

{

ArgumentOutOfRangeException.ThrowIfNegativeOrZero(value);

_port = value;

SetValue(nameof(Port), value);

_dataSourceCached = null;

}

}

int _port;

///<summary>

/// The PostgreSQL database to connect to.

/// </summary>

[Category("Connection")]

[Description("The PostgreSQL database to connect to.")]

[DisplayName("Database")]

[NpgsqlConnectionStringProperty("DB")]

public string? Database

{

get => _database;

set

{

_database = value;

SetValue(nameof(Database), value);

}

}

string? _database;

/// <summary>

/// The username to connect with.

/// </summary>

[Category("Connection")]

[Description("The username to connect with.")]

[DisplayName("Username")]

[NpgsqlConnectionStringProperty("User Name", "UserId", "User Id", "UID")]

public string? Username

{

get => _username;

set

{

_username = value;

SetValue(nameof(Username), value);

}

}

string? _username;

/// <summary>

/// The password to connect with.

/// </summary>

[Category("Connection")]

[Description("The password to connect with.")]

[PasswordPropertyText(true)]

[DisplayName("Password")]

[NpgsqlConnectionStringProperty("PSW", "PWD")]

public string? Password

{

get => _password;

set

{

_password = value;

SetValue(nameof(Password), value);

}

}

string? _password;

/// <summary>

/// Path to a PostgreSQL password file (PGPASSFILE), from which the password would be taken.

/// </summary>

[Category("Connection")]

[Description("Path to a PostgreSQL password file (PGPASSFILE), from which the password would be taken.")]

[DisplayName("Passfile")]

[NpgsqlConnectionStringProperty]

public string? Passfile

{

get => _passfile;

set

{

_passfile = value;

SetValue(nameof(Passfile), value);

}

}

string? _passfile;

/// <summary>

/// The optional application name parameter to be sent to the backend during connection initiation.

/// </summary>

[Category("Connection")]

[Description("The optional application name parameter to be sent to the backend during connection initiation")]

[DisplayName("Application Name")]

[NpgsqlConnectionStringProperty]

public string? ApplicationName

{

get => _applicationName;

set

{

_applicationName = value;

SetValue(nameof(ApplicationName), value);

}

}

string? _applicationName;

/// <summary>

/// Whether to enlist in an ambient TransactionScope.

/// </summary>

[Category("Connection")]

[Description("Whether to enlist in an ambient TransactionScope.")]

[DisplayName("Enlist")]

[DefaultValue(true)]

[NpgsqlConnectionStringProperty]

public bool Enlist

{

get => _enlist;

set

{

_enlist = value;

SetValue(nameof(Enlist), value);

}

}

bool _enlist;

/// <summary>

/// Gets or sets the schema search path.

/// </summary>

[Category("Connection")]

[Description("Gets or sets the schema search path.")]

[DisplayName("Search Path")]

[NpgsqlConnectionStringProperty]

public string? SearchPath

{

get => _searchPath;

set

{

_searchPath = value;

SetValue(nameof(SearchPath), value);

}

}

string? _searchPath;

/// <summary>

/// Gets or sets the client_encoding parameter.

/// </summary>

[Category("Connection")]

[Description("Gets or sets the client_encoding parameter.")]

[DisplayName("Client Encoding")]

[NpgsqlConnectionStringProperty]

public string? ClientEncoding

{

get => _clientEncoding;

set

{

_clientEncoding = value;

SetValue(nameof(ClientEncoding), value);

}

}

string? _clientEncoding;

/// <summary>

/// Gets or sets the .NET encoding that will be used to encode/decode PostgreSQL string data.

/// </summary>

[Category("Connection")]

[Description("Gets or sets the .NET encoding that will be used to encode/decode PostgreSQL string data.")]

[DisplayName("Encoding")]

[DefaultValue("UTF8")]

[NpgsqlConnectionStringProperty]

public string Encoding

{

get => _encoding;

set

{

_encoding = value;

SetValue(nameof(Encoding), value);

}

}

string _encoding = "UTF8";

/// <summary>

/// Gets or sets the PostgreSQL session timezone, in Olson/IANA database format.

/// </summary>

[Category("Connection")]

[Description("Gets or sets the PostgreSQL session timezone, in Olson/IANA database format.")]

[DisplayName("Timezone")]

[NpgsqlConnectionStringProperty]

public string? Timezone

{

get => _timezone;

set

{

_timezone = value;

SetValue(nameof(Timezone), value);

}

}

string? _timezone;

#endregion

#region Properties - Security

/// <summary>

/// Controls whether SSL is required, disabled or preferred, depending on server support.

/// </summary>

[Category("Security")]

[Description("Controls whether SSL is required, disabled or preferred, depending on server support.")]

[DisplayName("SSL Mode")]

[DefaultValue(SslMode.Prefer)]

[NpgsqlConnectionStringProperty]

public SslMode SslMode

{

get => _sslMode;

set

{

_sslMode = value;

SetValue(nameof(SslMode), value);

}

}

SslMode _sslMode;

/// <summary>

/// Controls how SSL encryption is negotiated with the server, if SSL is used.

/// </summary>

[Category("Security")]

[Description("Controls how SSL encryption is negotiated with the server, if SSL is used.")]

[DisplayName("SSL Negotiation")]

[NpgsqlConnectionStringProperty]

public SslNegotiation SslNegotiation

{

get => UserProvidedSslNegotiation ?? SslNegotiation.Postgres;

set

{

UserProvidedSslNegotiation = value;

SetValue(nameof(SslNegotiation), value);

}

}

internal SslNegotiation? UserProvidedSslNegotiation { get; private set; }

/// <summary>

/// Controls whether GSS encryption is required, disabled or preferred, depending on server support.

/// </summary>

[Category("Security")]

[Description("Controls whether GSS encryption is required, disabled or preferred, depending on server support.")]

[DisplayName("GSS Encryption Mode")]

[NpgsqlConnectionStringProperty]

public GssEncryptionMode GssEncryptionMode

{

get => UserProvidedGssEncMode ?? GssEncryptionMode.Prefer;

set

{

UserProvidedGssEncMode = value;

SetValue(nameof(GssEncryptionMode), value);

}

}

internal GssEncryptionMode? UserProvidedGssEncMode { get; private set; }

/// <summary>

/// Location of a client certificate to be sent to the server.

/// </summary>

[Category("Security")]

[Description("Location of a client certificate to be sent to the server.")]

[DisplayName("SSL Certificate")]

[NpgsqlConnectionStringProperty]

public string? SslCertificate

{

get => _sslCertificate;

set

{

_sslCertificate = value;

SetValue(nameof(SslCertificate), value);

}

}

string? _sslCertificate;

/// <summary>

/// Location of a client key for a client certificate to be sent to the server.

/// </summary>

[Category("Security")]

[Description("Location of a client key for a client certificate to be sent to the server.")]

[DisplayName("SSL Key")]

[NpgsqlConnectionStringProperty]

public string? SslKey

{

get => _sslKey;

set

{

_sslKey = value;

SetValue(nameof(SslKey), value);

}

}

string? _sslKey;

/// <summary>

/// Password for a key for a client certificate.

/// </summary>

[Category("Security")]

[Description("Password for a key for a client certificate.")]

[DisplayName("SSL Password")]

[NpgsqlConnectionStringProperty]

public string? SslPassword

{

get => _sslPassword;

set

{

_sslPassword = value;

SetValue(nameof(SslPassword), value);

}

}

string? _sslPassword;

/// <summary>

/// Location of a CA certificate used to validate the server certificate.

/// </summary>

[Category("Security")]

[Description("Location of a CA certificate used to validate the server certificate.")]

[DisplayName("Root Certificate")]

[NpgsqlConnectionStringProperty]

public string? RootCertificate

{

get => _rootCertificate;

set

{

_rootCertificate = value;

SetValue(nameof(RootCertificate), value);

}

}

string? _rootCertificate;

/// <summary>

/// Whether to check the certificate revocation list during authentication.

/// False by default.

/// </summary>

[Category("Security")]

[Description("Whether to check the certificate revocation list during authentication.")]

[DisplayName("Check Certificate Revocation")]

[NpgsqlConnectionStringProperty]

public bool CheckCertificateRevocation

{

get => _checkCertificateRevocation;

set

{

_checkCertificateRevocation = value;

SetValue(nameof(CheckCertificateRevocation), value);

}

}

bool _checkCertificateRevocation;

/// <summary>

/// The Kerberos service name to be used for authentication.

/// </summary>

[Category("Security")]

[Description("The Kerberos service name to be used for authentication.")]

[DisplayName("Kerberos Service Name")]

[NpgsqlConnectionStringProperty("Krbsrvname")]

[DefaultValue("postgres")]

public string KerberosServiceName

{

get => _kerberosServiceName;

set

{

_kerberosServiceName = value;

SetValue(nameof(KerberosServiceName), value);

}

}

string _kerberosServiceName = "postgres";

/// <summary>

/// The Kerberos realm to be used for authentication.

/// </summary>

[Category("Security")]

[Description("The Kerberos realm to be used for authentication.")]

[DisplayName("Include Realm")]

[DefaultValue(true)]

[NpgsqlConnectionStringProperty]

public bool IncludeRealm

{

get => _includeRealm;

set

{

_includeRealm = value;

SetValue(nameof(IncludeRealm), value);

}

}

bool _includeRealm;

/// <summary>

/// Gets or sets a Boolean value that indicates if security-sensitive information, such as the password, is not returned as part of the connection if the connection is open or has ever been in an open state.

/// </summary>

[Category("Security")]

[Description("Gets or sets a Boolean value that indicates if security-sensitive information, such as the password, is not returned as part of the connection if the connection is open or has ever been in an open state.")]

[DisplayName("Persist Security Info")]

[NpgsqlConnectionStringProperty]

public bool PersistSecurityInfo

{

get => _persistSecurityInfo;

set

{

_persistSecurityInfo = value;

SetValue(nameof(PersistSecurityInfo), value);

}

}

bool _persistSecurityInfo;

/// <summary>

/// When enabled, parameter values are logged when commands are executed. Defaults to false.

/// </summary>

[Category("Security")]

[Description("When enabled, parameter values are logged when commands are executed. Defaults to false.")]

[DisplayName("Log Parameters")]

[NpgsqlConnectionStringProperty]

public bool LogParameters

{

get => _logParameters;

set

{

_logParameters = value;

SetValue(nameof(LogParameters), value);

}

}

bool _logParameters;

internal const string IncludeExceptionDetailDisplayName = "Include Error Detail";

/// <summary>

/// When enabled, PostgreSQL error details are included on <see cref="PostgresException.Detail" /> and

/// <see cref="PostgresNotice.Detail" />. These can contain sensitive data.

/// </summary>

[Category("Security")]

[Description("When enabled, PostgreSQL error and notice details are included on PostgresException.Detail and PostgresNotice.Detail. These can contain sensitive data.")]

[DisplayName(IncludeExceptionDetailDisplayName)]

[NpgsqlConnectionStringProperty]

public bool IncludeErrorDetail

{

get => _includeErrorDetail;

set

{

_includeErrorDetail = value;

SetValue(nameof(IncludeErrorDetail), value);

}

}

bool _includeErrorDetail;

/// <summary>

/// When enabled, failed statements are included on <see cref="NpgsqlException.BatchCommand" />.

/// </summary>

[Category("Security")]

[Description("When enabled, failed batched commands are included on NpgsqlException.BatchCommand.")]

[DisplayName("Include Failed Batched Command")]

[NpgsqlConnectionStringProperty]

public bool IncludeFailedBatchedCommand

{

get => _includeFailedBatchedCommand;

set

{

_includeFailedBatchedCommand = value;

SetValue(nameof(IncludeFailedBatchedCommand), value);

}

}

bool _includeFailedBatchedCommand;

/// <summary>

/// Controls whether channel binding is required, disabled or preferred, depending on server support.

/// </summary>

[Category("Security")]

[Description("Controls whether channel binding is required, disabled or preferred, depending on server support.")]

[DisplayName("Channel Binding")]

[DefaultValue(ChannelBinding.Prefer)]

[NpgsqlConnectionStringProperty]

public ChannelBinding ChannelBinding

{

get => _channelBinding;

set

{

_channelBinding = value;

SetValue(nameof(ChannelBinding), value);

}

}

ChannelBinding _channelBinding;

/// <summary>

/// Controls the available authentication methods.

/// </summary>

[Category("Security")]

[Description("Controls the available authentication methods.")]

[DisplayName("Require Auth")]

[NpgsqlConnectionStringProperty]

public string? RequireAuth

{

get => _requireAuth;

set

{

RequireAuthModes = ParseAuthMode(value);

_requireAuth = value;

SetValue(nameof(RequireAuth), value);

}

}

string? _requireAuth;

internal RequireAuthMode RequireAuthModes { get; private set; }

internal static RequireAuthMode ParseAuthMode(string? value)

{

var modes = value?.Split(',', StringSplitOptions.TrimEntries | StringSplitOptions.RemoveEmptyEntries);

if (modes is not { Length: > 0 })

return RequireAuthMode.All;

var isNegative = false;

RequireAuthMode parsedModes = default;

for (var i = 0; i < modes.Length; i++)

{

var mode = modes[i];

var modeToParse = mode.AsSpan();

if (mode.StartsWith('!'))

{

if (i > 0 && !isNegative)

throw new ArgumentException("Mixing both positive and negative authentication methods is not supported");

modeToParse = modeToParse.Slice(1);

isNegative = true;

}

else

{

if (i > 0 && isNegative)

throw new ArgumentException("Mixing both positive and negative authentication methods is not supported");

}

// Explicitly disallow 'All' as libpq doesn't have it

if (!Enum.TryParse<RequireAuthMode>(modeToParse, out var parsedMode) || parsedMode == RequireAuthMode.All)

throw new ArgumentException($"Unable to parse authentication method \"{modeToParse}\"");

parsedModes |= parsedMode;

}

var allowedModes = isNegative

? (RequireAuthMode)(RequireAuthMode.All - parsedModes)

: parsedModes;

if (allowedModes == default)

throw new ArgumentException($"No authentication method is allowed. Check \"{nameof(RequireAuth)}\" in connection string.");

return allowedModes;

}

#endregion

#region Properties - Pooling

/// <summary>

/// Whether connection pooling should be used.

/// </summary>

[Category("Pooling")]

[Description("Whether connection pooling should be used.")]

[DisplayName("Pooling")]

[NpgsqlConnectionStringProperty]

[DefaultValue(true)]

public bool Pooling

{

get => _pooling;

set

{

_pooling = value;

SetValue(nameof(Pooling), value);

}

}

bool _pooling;

/// <summary>

/// The minimum connection pool size.

/// </summary>

[Category("Pooling")]

[Description("The minimum connection pool size.")]

[DisplayName("Minimum Pool Size")]

[NpgsqlConnectionStringProperty]

[DefaultValue(0)]

public int MinPoolSize

{

get => _minPoolSize;

set

{

ArgumentOutOfRangeException.ThrowIfNegative(value);

_minPoolSize = value;

SetValue(nameof(MinPoolSize), value);

}

}

int _minPoolSize;

/// <summary>

/// The maximum connection pool size.

/// </summary>

[Category("Pooling")]

[Description("The maximum connection pool size.")]

[DisplayName("Maximum Pool Size")]

[NpgsqlConnectionStringProperty]

[DefaultValue(100)]

public int MaxPoolSize

{

get => _maxPoolSize;

set

{

ArgumentOutOfRangeException.ThrowIfNegative(value);

_maxPoolSize = value;

SetValue(nameof(MaxPoolSize), value);

}

}

int _maxPoolSize;

/// <summary>

/// The time to wait before closing idle connections in the pool if the count

/// of all connections exceeds MinPoolSize.

/// </summary>

/// <value>The time (in seconds) to wait. The default value is 300.</value>

[Category("Pooling")]

[Description("The time to wait before closing unused connections in the pool if the count of all connections exceeds MinPoolSize.")]

[DisplayName("Connection Idle Lifetime")]

[NpgsqlConnectionStringProperty]

[DefaultValue(300)]

public int ConnectionIdleLifetime

{

get => _connectionIdleLifetime;

set

{

_connectionIdleLifetime = value;

SetValue(nameof(ConnectionIdleLifetime), value);

}

}

int _connectionIdleLifetime;

/// <summary>

/// How many seconds the pool waits before attempting to prune idle connections that are beyond

/// idle lifetime (<see cref="ConnectionIdleLifetime"/>.

/// </summary>

/// <value>The interval (in seconds). The default value is 10.</value>

[Category("Pooling")]

[Description("How many seconds the pool waits before attempting to prune idle connections that are beyond idle lifetime.")]

[DisplayName("Connection Pruning Interval")]

[NpgsqlConnectionStringProperty]

[DefaultValue(10)]

public int ConnectionPruningInterval

{

get => _connectionPruningInterval;

set

{

_connectionPruningInterval = value;

SetValue(nameof(ConnectionPruningInterval), value);

}

}

int _connectionPruningInterval;

/// <summary>

/// The total maximum lifetime of connections (in seconds). Connections which have exceeded this value will be

/// destroyed instead of returned from the pool. This is useful in clustered configurations to force load

/// balancing between a running server and a server just brought online. It can also be useful to prevent

/// runaway memory growth of connections at the PostgreSQL server side, because in some cases very long lived

/// connections slowly consume more and more memory over time.

/// Defaults to 3600 seconds (1 hour).

/// </summary>

/// <value>The time (in seconds) to wait, or 0 to to make connections last indefinitely.</value>

[Category("Pooling")]

[Description("The total maximum lifetime of connections (in seconds).")]

[DisplayName("Connection Lifetime")]

[NpgsqlConnectionStringProperty("Load Balance Timeout")]

[DefaultValue(3600)]

public int ConnectionLifetime

{

get => _connectionLifetime;

set

{

_connectionLifetime = value;

SetValue(nameof(ConnectionLifetime), value);

}

}

int _connectionLifetime;

#endregion

#region Properties - Timeouts

/// <summary>

/// The time to wait (in seconds) while trying to establish a connection before terminating the attempt and generating an error.

/// Defaults to 15 seconds.

/// </summary>

[Category("Timeouts")]

[Description("The time to wait (in seconds) while trying to establish a connection before terminating the attempt and generating an error.")]

[DisplayName("Timeout")]

[NpgsqlConnectionStringProperty]

[DefaultValue(DefaultTimeout)]

public int Timeout

{

get => _timeout;

set

{

ArgumentOutOfRangeException.ThrowIfNegative(value);

ArgumentOutOfRangeException.ThrowIfGreaterThan(value, NpgsqlConnection.TimeoutLimit);

_timeout = value;

SetValue(nameof(Timeout), value);

}

}

int _timeout;

internal const int DefaultTimeout = 15;

/// <summary>

/// The time to wait (in seconds) while trying to execute a command before terminating the attempt and generating an error.

/// Defaults to 30 seconds.

/// </summary>

[Category("Timeouts")]

[Description("The time to wait (in seconds) while trying to execute a command before terminating the attempt and generating an error. Set to zero for infinity.")]

[DisplayName("Command Timeout")]

[NpgsqlConnectionStringProperty]

[DefaultValue(NpgsqlCommand.DefaultTimeout)]

public int CommandTimeout

{

get => _commandTimeout;

set

{

ArgumentOutOfRangeException.ThrowIfNegative(value);

_commandTimeout = value;

SetValue(nameof(CommandTimeout), value);

}

}

int _commandTimeout;

/// <summary>

/// The time to wait (in milliseconds) while trying to read a response for a cancellation request for a timed out or cancelled query, before terminating the attempt and generating an error.

/// Zero for infinity, -1 to skip the wait.

/// Defaults to 2000 milliseconds.

/// </summary>

[Category("Timeouts")]

[Description("After Command Timeout is reached (or user supplied cancellation token is cancelled) and command cancellation is attempted, Npgsql waits for this additional timeout (in milliseconds) before breaking the connection. Defaults to 2000, set to zero for infinity.")]

[DisplayName("Cancellation Timeout")]

[NpgsqlConnectionStringProperty]

[DefaultValue(2000)]

public int CancellationTimeout

{

get => _cancellationTimeout;

set

{

ArgumentOutOfRangeException.ThrowIfLessThan(value, -1);

_cancellationTimeout = value;

SetValue(nameof(CancellationTimeout), value);

}

}

int _cancellationTimeout;

#endregion

#region Properties - Failover and load balancing

/// <summary>

/// Determines the preferred PostgreSQL target server type.

/// </summary>