SqlConnection.ConnectionString SqlConnection.ConnectionString SqlConnection.ConnectionString SqlConnection.ConnectionString Property

Определение

Получает или задает строку, используемую для открытия базы данных SQL Server.Gets or sets the string used to open a SQL Server database.

public:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
[System.Data.DataSysDescription("SqlConnection_ConnectionString")]
[System.ComponentModel.SettingsBindable(true)]
public string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
Public Property ConnectionString As String

Значение свойства

Строка подключения, включающая имя источника базы данных и другие параметры, необходимые для установки исходного подключения.The connection string that includes the source database name, and other parameters needed to establish the initial connection. Значение по умолчанию - пустая строка.The default value is an empty string.

Реализации

Исключения

Передан недопустимый аргумент строки подключения, или не задан обязательный аргумент строки подключения.An invalid connection string argument has been supplied, or a required connection string argument has not been supplied.

Примеры

В следующем примере создается SqlConnection и ConnectionString задается свойство перед открытием соединения.The following example creates a SqlConnection and sets the ConnectionString property before opening the connection.

private static void OpenSqlConnection()
{
    string connectionString = GetConnectionString();

    using (SqlConnection connection = new SqlConnection())
    {
        connection.ConnectionString = connectionString;

        connection.Open();

        Console.WriteLine("State: {0}", connection.State);
        Console.WriteLine("ConnectionString: {0}",
            connection.ConnectionString);
    }
}

static private string GetConnectionString()
{
    // To avoid storing the connection string in your code, 
    // you can retrieve it from a configuration file.
    return "Data Source=MSSQL1;Initial Catalog=AdventureWorks;"
        + "Integrated Security=true;";
}
Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()

    Using connection As New SqlConnection()

        connection.ConnectionString = connectionString

        connection.Open()

        Console.WriteLine("State: {0}", connection.State)
        Console.WriteLine("ConnectionString: {0}", _
            connection.ConnectionString)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,  
    ' you can retrieve it from a configuration file.
    Return "Data Source=MSSQL1;Database=AdventureWorks;" _
      & "Integrated Security=true;"
End Function

Комментарии

ConnectionString Аналогичен строке подключения OLE DB, но не идентична.The ConnectionString is similar to an OLE DB connection string, but is not identical. В отличие от OLE DB или ADO, возвращаемая строка подключения совпадает с пользовательской ConnectionString, а не со сведениями о безопасности, если для false параметра сохранить сведения о безопасности задано значение (по умолчанию).Unlike OLE DB or ADO, the connection string that is returned is the same as the user-set ConnectionString, minus security information if the Persist Security Info value is set to false (default). Поставщик данных .NET Framework для SQL Server не сохраняет или не возвращает пароль в строке подключения, если только не задан параметр Persist Security Info to true.The .NET Framework Data Provider for SQL Server does not persist or return the password in a connection string unless you set Persist Security Info to true.

ConnectionString Свойство можно использовать для подключения к базе данных.You can use the ConnectionString property to connect to a database. В следующем примере показана типичная строка подключения.The following example illustrates a typical connection string.

"Persist Security Info=False;Integrated Security=true;Initial Catalog=Northwind;server=(local)"  

Используйте New SqlConnectionStringBuilder для создания допустимых строк подключения во время выполнения.Use the new SqlConnectionStringBuilder to construct valid connection strings at run time. Дополнительные сведения см. в статье Connection String Builders (Построители строк подключения).For more information, see Connection String Builders.

ConnectionString Свойство может быть задано только при закрытии соединения.The ConnectionString property can be set only when the connection is closed. Многие значения строки подключения имеют соответствующие свойства только для чтения.Many of the connection string values have corresponding read-only properties. Если задана строка подключения, эти свойства обновляются, за исключением случаев обнаружения ошибки.When the connection string is set, these properties are updated, except when an error is detected. В этом случае ни одно из свойств не обновляется.In this case, none of the properties are updated. SqlConnectionсвойства возвращают только те параметры, которые содержатся в ConnectionString.SqlConnection properties return only those settings that are contained in the ConnectionString.

Для подключения к локальному компьютеру укажите "(local)" для сервера.To connect to a local computer, specify "(local)" for the server. Если имя сервера не указано, будет предпринята попытка подключения к экземпляру по умолчанию на локальном компьютере.If a server name is not specified, a connection will be attempted to the default instance on the local computer.

ConnectionString При сбросе для закрытого соединения сбрасываются все значения строк подключения (и связанные свойства), включая пароль.Resetting the ConnectionString on a closed connection resets all connection string values (and related properties) including the password. Например, если задать строку подключения, включающую "Database = AdventureWorks", а затем сбросить строку подключения к "Data Source = MyServer; Integrated Security = true", Database свойство больше не будет иметь значение "AdventureWorks".For example, if you set a connection string that includes "Database= AdventureWorks", and then reset the connection string to "Data Source=myserver;Integrated Security=true", the Database property is no longer set to "AdventureWorks".

Строка подключения анализируется сразу после установки.The connection string is parsed immediately after being set. Если при синтаксическом анализе обнаружены ошибки в синтаксисе, создается исключение среды выполнения ArgumentException, такое как.If errors in syntax are found when parsing, a runtime exception, such as ArgumentException, is generated. Другие ошибки можно найти только при попытке открыть подключение.Other errors can be found only when an attempt is made to open the connection.

Базовый формат строки подключения включает ряд пар "ключевое слово-значение", разделенных точкой с запятой.The basic format of a connection string includes a series of keyword/value pairs separated by semicolons. Знак равенства (=) соединяет каждое ключевое слово и его значение.The equal sign (=) connects each keyword and its value. Чтобы включить значения, содержащие символы точки с запятой, одиночной кавычки или двойные кавычки, значение должно быть заключено в двойные кавычки.To include values that contain a semicolon, single-quote character, or double-quote character, the value must be enclosed in double quotation marks. Если значение содержит и точку с запятой, и символ двойной кавычки, это значение можно заключить в одинарные кавычки.If the value contains both a semicolon and a double-quote character, the value can be enclosed in single quotation marks. Одинарная кавычка также полезна, если значение начинается с символа двойной кавычки.The single quotation mark is also useful if the value starts with a double-quote character. И наоборот, если значение начинается с одиночной кавычки, можно использовать двойные кавычки.Conversely, the double quotation mark can be used if the value starts with a single quotation mark. Если значение содержит как одинарные, так и двойные кавычки, то символ кавычки, используемый для заключения значения, должен быть удвоен каждый раз, когда он встречается в значении.If the value contains both single-quote and double-quote characters, the quotation mark character used to enclose the value must be doubled every time it occurs within the value.

Чтобы включить в строковое значение предшествующие или конечные пробелы, значение должно быть заключено в одинарные кавычки или двойные кавычки.To include preceding or trailing spaces in the string value, the value must be enclosed in either single quotation marks or double quotation marks. Все начальные и конечные пробелы вокруг целых, логических или перечисляемых значений игнорируются, даже если они заключены в кавычки.Any leading or trailing spaces around integer, Boolean, or enumerated values are ignored, even if enclosed in quotation marks. Однако пробелы в ключевом слове или значении строкового литерала сохраняются.However, spaces within a string literal keyword or value are preserved. Одинарные или двойные кавычки могут использоваться в строке соединения без использования разделителей (например, Data Source = Ми'сервер или Data Source = My "Server), если только символ-кавычка не является первым или последним символом в значении.Single or double quotation marks may be used within a connection string without using delimiters (for example, Data Source= my'Server or Data Source= my"Server), unless a quotation mark character is the first or last character in the value.

В ключевых словах регистр не учитывается.Keywords are not case sensitive.

В следующей таблице перечислены допустимые имена для значений ключевых слов в ConnectionString.The following table lists the valid names for keyword values within the ConnectionString.

Ключевое словоKeyword Значение по умолчаниюDefault ОписаниеDescription
AddrAddr Н/ДN/A Синоним источника данных.Synonym of Data Source.
АдресAddress Н/ДN/A Синоним источника данных.Synonym of Data Source.
ПриложениеApp Н/ДN/A Синоним имени приложения.Synonym of Application Name.
Application NameApplication Name Н/ДN/A Имя приложения или "поставщик данных .NET SQLClient", если не указано имя приложения.The name of the application, or '.NET SQLClient Data Provider' if no application name is provided.

Имя приложения может содержать не более 128 символов.An application name can be 128 characters or less.
ApplicationIntent ReadWrite Объявляет тип рабочей нагрузки приложения при соединении с сервером.Declares the application workload type when connecting to a server. Возможными значениями являются ReadOnly и ReadWrite.Possible values are ReadOnly and ReadWrite. Например:For example:

ApplicationIntent=ReadOnly

Дополнительные сведения о поддержке SqlClient для групп доступности Always On см. в разделе Поддержка SqlClient для высокого уровня доступности и аварийного восстановления.For more information about SqlClient support for Always On Availability Groups, see SqlClient Support for High Availability, Disaster Recovery.
Asynchronous ProcessingAsynchronous Processing

-или--or-

AsyncAsync
IsFalse'false' Когда true, включает поддержку асинхронных операций.When true, enables asynchronous operation support. Допустимые значения: true, false, yes и no.Recognized values are true, false, yes, and no.

Это свойство не обрабатывается, начиная с .NET Framework 4.5.NET Framework 4.5.This property is ignored beginning in .NET Framework 4.5.NET Framework 4.5. Дополнительные сведения о поддержке SqlClient для асинхронного программирования см. в разделе Асинхронное программирование.For more information about SqlClient support for asynchronous programming, see Asynchronous Programming.
AttachDBFilenameAttachDBFilename

-или--or-

Расширенные свойстваExtended Properties

- или --or-

Исходное имя файлаInitial File Name
Н/ДN/A Имя файла базы данных источника, включая полный путь к подключаемой базе данных.The name of the primary database file, including the full path name of an attachable database. AttachDBFilename поддерживается только для первичных файлов данных с расширением MDF.AttachDBFilename is only supported for primary data files with an .mdf extension.

Если значение ключа AttachDBFileName указано в строке подключения, база данных присоединяется и становится базой данных по умолчанию для соединения.If the value of the AttachDBFileName key is specified in the connection string, the database is attached and becomes the default database for the connection.

Если этот ключ не указан и база данных была ранее присоединена, база данных не будет присоединена.If this key is not specified and if the database was previously attached, the database will not be reattached. Ранее присоединенная база данных будет использоваться в качестве базы данных по умолчанию для соединения.The previously attached database will be used as the default database for the connection.

Если этот ключ указан вместе с ключом AttachDBFileName, то в качестве псевдонима будет использоваться значение этого ключа.If this key is specified together with the AttachDBFileName key, the value of this key will be used as the alias. Однако если имя уже используется в другой присоединенной базе данных, произойдет сбой соединения.However, if the name is already used in another attached database, the connection will fail.

Путь может быть абсолютным или относительным с помощью строки подстановки DataDirectory.The path may be absolute or relative by using the DataDirectory substitution string. Если используется DataDirectory, файл базы данных должен находиться в подкаталоге каталога, на который указывает строка подстановки.If DataDirectory is used, the database file must exist within a subdirectory of the directory pointed to by the substitution string. Примечание. Имена путей к удаленному серверу, HTTP и UNC не поддерживаются.Note: Remote server, HTTP, and UNC path names are not supported.

Имя базы данных должно быть указано с помощью ключевого слова "Database" (или одного из его псевдонимов), как показано ниже:The database name must be specified with the keyword 'database' (or one of its aliases) as in the following:

"AttachDbFileName=|DataDirectory|\data\YourDB.mdf;integrated security=true;database=YourDatabase"

Если файл журнала находится в том же каталоге, что и файл данных, а при прикреплении первичного файла данных было использовано ключевое слово «database», будет выдана ошибка.An error will be generated if a log file exists in the same directory as the data file and the 'database' keyword is used when attaching the primary data file. В этом случае следует удалить файл журнала.In this case, remove the log file. После прикрепления базы данных будет автоматически создан новый файл журнала на основе физического пути.Once the database is attached, a new log file will be automatically generated based on the physical path.
Проверка подлинностиAuthentication Н/ДN/A Метод проверки подлинности , используемый для подключения к базе данных SQL с помощью Azure Active Directory проверки подлинности.The authentication method used for Connecting to SQL Database By Using Azure Active Directory Authentication.

Допустимые значения:Valid values are:

Active Directory интегрированный Active Directory пароль, пароль SQL.Active Directory Integrated, Active Directory Password, Sql Password.
Параметр шифрования столбцаColumn Encryption Setting Н/ДN/A Включает или отключает функцию Always encrypted для подключения.Enables or disables Always Encrypted functionality for the connection.
Время ожидания соединенияConnect Timeout

-или--or-

Connection TimeoutConnection Timeout

- или --or-

Время ожиданияTimeout
1515 Продолжительность времени (в секундах) ожидания соединения с сервером перед прекращением попытки и генерацией ошибки.The length of time (in seconds) to wait for a connection to the server before terminating the attempt and generating an error.

Допустимые значения: больше или равно 0 и меньше или равно 2147483647.Valid values are greater than or equal to 0 and less than or equal to 2147483647.

При открытии подключения к базе данных SQL Azure установите время ожидания подключения равным 30 секундам.When opening a connection to a Azure SQL Database, set the connection timeout to 30 seconds.
Время существования подключенияConnection Lifetime

-или--or-

Load Balance TimeoutLoad Balance Timeout
00 Если соединение возвращается в пул, время его создания сравнивается с текущим временем и соединение уничтожается, если этот промежуток времени (в секундах) превышает значение, заданное параметром Connection Lifetime.When a connection is returned to the pool, its creation time is compared with the current time, and the connection is destroyed if that time span (in seconds) exceeds the value specified by Connection Lifetime. Эта возможность полезна в кластеризованных конфигурациях для принудительной балансировки нагрузки между выполняющимся сервером и сервером, только что переведенным в оперативный режим.This is useful in clustered configurations to force load balancing between a running server and a server just brought online.

Нулевое значение (0) приводит к превышению максимального времени ожидания подключения в пуле.A value of zero (0) causes pooled connections to have the maximum connection timeout.
ConnectRetryCountConnectRetryCount 11 Управляет количеством попыток повторного подключения после того, как клиент выявляет ошибку неактивного подключения.Controls the number of reconnection attempts after the client identifies an idle connection failure. Допустимые значения: от 0 до 255.Valid values are 0 to 255. Значение по умолчанию — 1.The default is 1. 0 — не пытаться повторно подключиться (отключить устойчивость подключения).0 means do not attempt to reconnect (disable connection resiliency).

Дополнительные сведения о устойчивости бездействующих подключений см. в статье Техническая статья — устойчивость бездействующего подключения.For additional information about idle connection resiliency, see Technical Article - Idle Connection Resiliency.
ConnectRetryIntervalConnectRetryInterval 1010 Указывает время между попытками повторного подключения (ConnectRetryCount).Specifies the time between each connection retry attempt (ConnectRetryCount). Допустимые значения: от 1 до 60 секунд (по умолчанию — 10), применяются после первой попытки повторного подключения.Valid values are 1 to 60 seconds (default=10), applied after the first reconnection attempt. При обнаружении неработающего соединения клиент немедленно пытается подключиться повторно. Это первая повторная попытки подключения, которая возникает, только если ConnectRetryCount больше 0.When a broken connection is detected, the client immediately attempts to reconnect; this is the first reconnection attempt and only occurs if ConnectRetryCount is greater than 0. Если первая попытка повторного подключения завершается неудачно, а ConnectRetryCount больше 1, клиент ожидает от ConnectRetryInterval попытку выполнить вторую и последующие попытки повторного подключения.If the first reconnection attempt fails and ConnectRetryCount is greater than 1, the client waits ConnectRetryInterval to try the second and subsequent reconnection attempts.

Дополнительные сведения о устойчивости бездействующих подключений см. в статье Техническая статья — устойчивость бездействующего подключения.For additional information about idle connection resiliency, see Technical Article - Idle Connection Resiliency.
Context ConnectionContext Connection IsFalse'false' trueзначение, если необходимо выполнить внутрипроцессный процесс подключения к SQL Server.true if an in-process connection to SQL Server should be made.
Current LanguageCurrent Language

- или --or-

ЯзыкLanguage
Н/ДN/A Задает язык, используемый для предупреждений или сообщений об ошибках сервера базы данных.Sets the language used for database server warning or error messages.

Имя языка может содержать не более 128 символов.The language name can be 128 characters or less.
источника данныхData Source

- или --or-

СерверServer

-или--or-

АдресAddress

-или--or-

AddrAddr

-или--or-

Сетевой адресNetwork Address
Н/ДN/A Имя или сетевой адрес экземпляра SQL Server, к которому производится подключение.The name or network address of the instance of SQL Server to which to connect. Номер порта можно указать после имени сервера:The port number can be specified after the server name:

server=tcp:servername, portnumber

При указании локального экземпляра всегда используйте (local).When specifying a local instance, always use (local). Чтобы принудительно применить протокол, добавьте один из следующих префиксов:To force a protocol, add one of the following prefixes:

np:(local), tcp:(local), lpc:(local)

Начиная с .NET Framework 4.5.NET Framework 4.5, можно также подключиться к базе данных LocalDB следующим образом:Beginning in .NET Framework 4.5.NET Framework 4.5, you can also connect to a LocalDB database as follows:

server=(localdb)\\myInstance

Дополнительные сведения о LocalDB см. в разделе Поддержка SqlClient для LocalDB.For more information about LocalDB, see SqlClient Support for LocalDB.

Источник данных должен использовать формат TCP или именованные каналы.Data Source must use the TCP format or the Named Pipes format.

Формат TCP выглядит следующим образом:TCP format is as follows:

-TCP:<имя узла >\< имя экземпляра>- tcp:<host name>\<instance name>
-TCP:<имя узла >,<номер порта TCP/IP >- tcp:<host name>,<TCP/IP port number>

Формат TCP должен начинаться с префикса "TCP:", за которым следует экземпляр базы данных, как указано в имени узла и имени экземпляра.The TCP format must start with the prefix "tcp:" and is followed by the database instance, as specified by a host name and an instance name. Этот формат неприменим при подключении к базе данных SQL Azure.This format is not applicable when connecting to Azure SQL Database. TCP выбирается автоматически для подключений к базе данных SQL Azure, если не указан протокол.TCP is automatically selected for connections to Azure SQL Database when no protocol is specified.

Имя узла должно быть указано одним из следующих способов:The host name MUST be specified in one of the following ways:

-NetBIOSName- NetBIOSName
- IPv4Address- IPv4Address
- IPv6Address- IPv6Address

Имя экземпляра используется для разрешения на определенный номер порта TCP/IP, на котором размещен экземпляр базы данных.The instance name is used to resolve to a particular TCP/IP port number on which a database instance is hosted. Кроме того, также разрешено указывать номер порта TCP/IP напрямую.Alternatively, specifying a TCP/IP port number directly is also allowed. Если имя экземпляра и номер порта отсутствуют, используется экземпляр базы данных по умолчанию.If both instance name and port number are not present, the default database instance is used.

Формат именованных каналов выглядит следующим образом:The Named Pipes format is as follows:

-NP:\\< имя>узла \пипе\< имя канала>- np:\\<host name>\pipe\<pipe name>

Формат именованных каналов должен начинаться с префикса "NP:", за которым следует имя именованного канала.The Named Pipes format MUST start with the prefix "np:" and is followed by a named pipe name.

Имя узла должно быть указано одним из следующих способов:The host name MUST be specified in one of the following ways:

-NetBIOSName- NetBIOSName
- IPv4Address- IPv4Address
- IPv6Address- IPv6Address

Имя канала используется для указания экземпляра базы данных, к которому будет подключено приложение .NET Framework.The pipe name is used to identify the database instance to which the .NET Framework application will be connected.

Если указано значение сетевого ключа, префиксы "TCP:" и "NP:" указывать не следует.If the value of the Network key is specified, the prefixes "tcp:" and "np:" should not be specified. Примечание. Можно принудительно использовать TCP вместо общей памяти, представив префикс TCP: к имени сервера в строке подключения или с помощью localhost.Note: You can force the use of TCP instead of shared memory, either by prefixing tcp: to the server name in the connection string, or by using localhost.
EncryptEncrypt IsFalse'false' Если значение равно, SQL Server использует SSL-шифрование для всех данных, передаваемых между клиентом и сервером, если на сервере установлен сертификат. trueWhen true, SQL Server uses SSL encryption for all data sent between the client and server if the server has a certificate installed. Допустимые значения: true, false, yes и no.Recognized values are true, false, yes, and no. Дополнительные сведения см. в разделе синтаксис строки подключения.For more information, see Connection String Syntax.

Начиная с .NET Framework 4.5.NET Framework 4.5, если TrustServerCertificate параметр имеет значение Encrypt false и имеет значение true, имя сервера (или IP-адрес) в SQL Server сертификате SSL должно точно совпадать с именем сервера (или IP-адресом), указанным в строке подключения.Beginning in .NET Framework 4.5.NET Framework 4.5, when TrustServerCertificate is false and Encrypt is true, the server name (or IP address) in a SQL Server SSL certificate must exactly match the server name (or IP address) specified in the connection string. В противном случае соединение не будет установлено.Otherwise, the connection attempt will fail. Сведения о поддержке сертификатов, тема которых начинается с подстановочного знака (*), см. в разделе принятые подстановочные знаки, используемые сертификатами сервера для проверки подлинности сервера.For information about support for certificates whose subject starts with a wildcard character (*), see Accepted wildcards used by server certificates for server authentication.
EnlistEnlist 'true''true' trueУказывает, что диспетчер подключений SQL Server автоматически закрепляет соединение в текущем контексте транзакции создания потока.true indicates that the SQL Server connection pooler automatically enlists the connection in the creation thread's current transaction context.
Failover PartnerFailover Partner Н/ДN/A Имя сервера-партнера по обеспечению отработки отказа, на котором настроено зеркальное отображение базы данных.The name of the failover partner server where database mirroring is configured.

Если значение этого параметра — "", должен присутствовать Исходный каталог , а его значение не должно быть "".If the value of this key is "", then Initial Catalog must be present, and its value must not be "".

Имя сервера может содержать не более 128 символов.The server name can be 128 characters or less.

Если указать партнера по обеспечению отработки отказа, но сервер-партнер отработки отказа не настроен для зеркального отображения базы данных, а сервер-источник (указанный с помощью ключевого слова Server) недоступен, произойдет сбой подключения.If you specify a failover partner but the failover partner server is not configured for database mirroring and the primary server (specified with the Server keyword) is not available, then the connection will fail.

Если указан партнер по обеспечению отработки отказа, а сервер-источник не настроен для зеркального отображения базы данных, то подключение к серверу-источнику (заданному с помощью ключевого слова Server) будет выполнено, если сервер-источник доступен.If you specify a failover partner and the primary server is not configured for database mirroring, the connection to the primary server (specified with the Server keyword) will succeed if the primary server is available.
Initial CatalogInitial Catalog

-или--or-

База данныхDatabase
Н/ДN/A Имя базы данных.The name of the database.

Имя базы данных может содержать не более 128 символов.The database name can be 128 characters or less.
Integrated SecurityIntegrated Security

- или --or-

Trusted_ConnectionTrusted_Connection
IsFalse'false' Если falseзначение равно, то в соединении указываются идентификатор пользователя и пароль.When false, User ID and Password are specified in the connection. Если trueзадано значение, то для проверки подлинности используются учетные данные текущей учетной записи Windows.When true, the current Windows account credentials are used for authentication.

Распознаваемые значения true: false no,, true, и sspi (настоятельно рекомендуется), что эквивалентно значению. yesRecognized values are true, false, yes, no, and sspi (strongly recommended), which is equivalent to true.

Если указаны идентификатор пользователя и пароль, а для параметра встроенная безопасность задано значение true, идентификатор пользователя и пароль будут пропущены, а также будет использоваться встроенная безопасность.If User ID and Password are specified and Integrated Security is set to true, the User ID and Password will be ignored and Integrated Security will be used.

SqlCredential— более безопасный способ указания учетных данных для соединения, использующего проверку подлинности SQL Server (Integrated Security=false).SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication (Integrated Security=false).
Max Pool SizeMax Pool Size 100100 Максимальное число подключений, разрешенных в пуле.The maximum number of connections that are allowed in the pool.

Допустимые значения: больше или равно 1.Valid values are greater than or equal to 1. Значения, размер которых меньше минимального размера пула , вызывают ошибку.Values that are less than Min Pool Size generate an error.
Min Pool SizeMin Pool Size 00 Минимальное число подключений, разрешенных в пуле.The minimum number of connections that are allowed in the pool.

Допустимые значения больше или равны 0.Valid values are greater than or equal to 0. Ноль (0) в этом поле означает, что минимальное число подключений изначально не открыто.Zero (0) in this field means no minimum connections are initially opened.

Значения, превышающие максимальный размер пула , вызывают ошибку.Values that are greater than Max Pool Size generate an error.
MultipleActiveResultSetsMultipleActiveResultSets IsFalse'false' Когда trueприложение может поддерживать несколько активных результирующих наборов (MARS).When true, an application can maintain multiple active result sets (MARS). Когда falseприложение должно обрабатывать или отменять все результирующие наборы из одного пакета, прежде чем он сможет выполнить любой другой пакет в этом соединении.When false, an application must process or cancel all result sets from one batch before it can execute any other batch on that connection.

Распознаваемые значения true : falseи.Recognized values are true and false.

Дополнительные сведения см. в разделе Несколько активных результирующих наборов (MARS).For more information, see Multiple Active Result Sets (MARS).
MultiSubnetFailover falseFALSE Всегда указывайте multiSubnetFailover=True при подключении к прослушивателю группы доступности для SQL Server 2012 (или более поздней версии) группы доступности или экземпляра отказоустойчивого кластера SQL Server 2012 (или более поздней версии).Always specify multiSubnetFailover=True when connecting to the availability group listener of a SQL Server 2012 (or later) availability group or a SQL Server 2012 (or later) Failover Cluster Instance. multiSubnetFailover=Trueнастраивает SqlClient для ускоренного обнаружения активного сервера (в настоящее время) и подключения к нему.multiSubnetFailover=True configures SqlClient to provide faster detection of and connection to the (currently) active server. Возможные значения: Yes and No, True and False или и1 . 0Possible values are Yes and No, True and False or 1 and 0. Например:For example:

MultiSubnetFailover=True

Значение по умолчанию — False.The default is False. Дополнительные сведения о поддержке SqlClient для Always On групп доступности см. в статье Поддержка SqlClient для обеспечения высокого уровня доступности и аварийного восстановления.For more information about SqlClient's support for Always On AGs, see SqlClient Support for High Availability, Disaster Recovery.
Network LibraryNetwork Library

-или--or-

СетьNetwork

- или --or-

учитываемNet
Н/ДN/A Сетевая библиотека, используемая для установления соединения с экземпляром SQL Server.The network library used to establish a connection to an instance of SQL Server. Допустимые значения:Supported values include:

dbnmpntw (именованные каналы)dbnmpntw (Named Pipes)

dbmsrpcn (многопротоколный, Windows RPC)dbmsrpcn (Multiprotocol, Windows RPC)

dbmsadsn (Apple говорите)dbmsadsn (Apple Talk)

dbmsgnet (VIA)dbmsgnet (VIA)

dbmslpcn (общая память)dbmslpcn (Shared Memory)

dbmsspxn (IPX/SPX)dbmsspxn (IPX/SPX)

dbmssocn (TCP/IP)dbmssocn (TCP/IP)

Дбмсвинн (Banyan Vines)Dbmsvinn (Banyan Vines)

Соответствующая сетевая библиотека DLL должна быть установлена на системе, с которой устанавливается соединение.The corresponding network DLL must be installed on the system to which you connect. Если сеть не указана и используется локальный сервер (например, "." или "(local)"), используется общая память.If you do not specify a network and you use a local server (for example, "." or "(local)"), shared memory is used. В этом примере сетевой библиотекой является Win32 Winsock TCP/IP (dbmssocn), а портом соединения — 1433.In this example, the network library is Win32 Winsock TCP/IP (dbmssocn), and 1433 is the port being used.

Network Library=dbmssocn;Data Source=000.000.000.000,1433;
Packet SizePacket Size 80008000 Размер (в байтах) сетевых пакетов, используемых для связи с экземпляром SQL Server.Size in bytes of the network packets used to communicate with an instance of SQL Server.

Размер пакета может быть больше или равен 512 и меньше или равен 32768.The packet size can be greater than or equal to 512 and less than or equal to 32768.
ПарольPassword

- или --or-

PWDPWD
Н/ДN/A Пароль для входа в учетную запись SQL Server.The password for the SQL Server account logging on. Не рекомендуется.Not recommended. Чтобы обеспечить высокий уровень безопасности, настоятельно рекомендуется использовать Integrated Security вместо него ключевое слово или. Trusted_ConnectionTo maintain a high level of security, we strongly recommend that you use the Integrated Security or Trusted_Connection keyword instead. SqlCredential— более безопасный способ указания учетных данных для соединения, использующего проверку подлинности SQL Server.SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication.

Пароль должен содержать не более 128 символов.The password must be 128 characters or less.
Persist Security InfoPersist Security Info

- или --or-

персистсекуритинфоPersistSecurityInfo
IsFalse'false' Если задано false значение no или (настоятельно рекомендуется), конфиденциальная информация, например пароль, не возвращается как часть соединения, если соединение открыто или когда-либо находилось в открытом состоянии.When set to false or no (strongly recommended), 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. При сбросе строки подключения сбрасываются все значения строк подключения, включая пароль.Resetting the connection string resets all connection string values including the password. Допустимые значения: true, false, yes и no.Recognized values are true, false, yes, and no.
PoolBlockingPeriodPoolBlockingPeriod АвтоAuto Задает поведение периода блокировки для пула соединений.Sets the blocking period behavior for a connection pool. Дополнительные PoolBlockingPeriod сведения см. в свойстве.See PoolBlockingPeriod property for details.
PoolingPooling 'true''true' Если для этого параметра задано значение true, все вновь созданные соединения будут добавлены в пул при закрытии приложением.When the value of this key is set to true, any newly created connection will be added to the pool when closed by the application. При следующей попытке открыть то же подключение это соединение будет выведено из пула.In a next attempt to open the same connection, that connection will be drawn from the pool.

Соединения считаются одинаковыми, если они имеют одинаковую строку подключения.Connections are considered the same if they have the same connection string. Разные соединения имеют разные строки подключения.Different connections have different connection strings.

Значение этого параметра может быть "true", "false", "Yes" или "No".The value of this key can be "true", "false", "yes", or "no".
ReplicationReplication IsFalse'false' trueзначение, если репликация поддерживается с помощью соединения.true if replication is supported using the connection.
Transaction BindingTransaction Binding Implicit UnbindImplicit Unbind Управляет связью соединения с прикрепленной System.Transactions транзакцией.Controls connection association with an enlisted System.Transactions transaction.

Доступны следующие значения:Possible values are:

Transaction Binding=Implicit Unbind;

Transaction Binding=Explicit Unbind;

Неявная Отмена привязки приводит к отключению соединения от транзакции по ее окончании.Implicit Unbind causes the connection to detach from the transaction when it ends. После отсоединения дополнительные запросы к соединению выполняются в режиме автофиксации.After detaching, additional requests on the connection are performed in autocommit mode. Свойство System.Transactions.Transaction.Current не проверяется при выполнении запросов в то время, когда транзакция активна.The System.Transactions.Transaction.Current property is not checked when executing requests while the transaction is active. После завершения транзакции дополнительные запросы выполняются в режиме автофиксации.After the transaction has ended, additional requests are performed in autocommit mode.

Если система завершает транзакцию (в области блока using) до завершения последней команды, она выдает исключение InvalidOperationException.If the system ends the transaction (in the scope of a using block) before the last command completes, it will throw InvalidOperationException.

Явная Отмена привязки приводит к тому, что соединение остается прикрепленным к транзакции, пока соединение не будет закрыто или не будет вызван явный SqlConnection.TransactionEnlist(null) вызов.Explicit Unbind causes the connection to remain attached to the transaction until the connection is closed or an explicit SqlConnection.TransactionEnlist(null) is called. Начиная с .NET Framework 4.NET Framework 4, изменение неявной отмены привязки делает явную отмену привязки устаревшим.Beginning in .NET Framework 4.NET Framework 4, changes to Implicit Unbind make Explicit Unbind obsolete. Исключение InvalidOperationException выдается, если свойство Transaction.Current не является прикрепленной транзакцией или если прикрепленная транзакция не активна.An InvalidOperationException is thrown if Transaction.Current is not the enlisted transaction or if the enlisted transaction is not active.
TransparentNetworkIPResolutionTransparentNetworkIPResolution См. описание.See description. Если этому ключу присвоено значение true, приложение должно получить все IP-адреса для определенной записи DNS, а затем попытаться подключиться по первому адресу в списке.When the value of this key is set to true, the application is required to retrieve all IP addresses for a particular DNS entry and attempt to connect with the first one in the list. Если подключение не устанавливается в течение 0,5 секунды, приложение попытается параллельно подключиться по другим адресам.If the connection is not established within 0.5 seconds, the application will try to connect to all others in parallel. При получении первого ответа приложение устанавливает подключение по соответствующему IP-адресу.When the first answers, the application will establish the connection with the respondent IP address.

Если ключ имеет trueзначение, TransparentNetworkIPResolution то параметр игнорируется. MultiSubnetFailoverIf the MultiSubnetFailover key is set to true, TransparentNetworkIPResolution is ignored.

Если ключ задан, TransparentNetworkIPResolution игнорируется. Failover PartnerIf the Failover Partner key is set, TransparentNetworkIPResolution is ignored.

Значение этого ключа должно trueбыть, false, yesили no.The value of this key must be true, false, yes, or no.

Значение yes обрабатывается так же, как и trueзначение.A value of yes is treated the same as a value of true.

Значение no обрабатывается так же, как и falseзначение.A value of no is treated the same as a value of false.

Ниже приведены значения по умолчанию.The default values are as follows:

  • falseWhenfalse when:

    • Подключение к базе данных SQL Azure, в которой заканчивается источник данных:Connecting to Azure SQL Database where the data source ends with:

      • .database.chinacloudapi.cn.database.chinacloudapi.cn
      • .database.usgovcloudapi.net.database.usgovcloudapi.net
      • .database.cloudapi.de.database.cloudapi.de
      • .database.windows.net.database.windows.net
    • Authentication— "Active Directory Password" или "Active Directory Integrated"Authentication is 'Active Directory Password' or 'Active Directory Integrated'
  • В остальных случаях — true.true in all other cases.
trustServerCertificateTrustServerCertificate IsFalse'false' Если задано trueзначение, SSL используется для шифрования канала при обходе прохода по цепочке сертификатов для проверки доверия.When set to true, SSL is used to encrypt the channel when bypassing walking the certificate chain to validate trust. Если TrustServerCertificate имеет значение true и для параметра Encrypt задано falseзначение, канал не шифруется.If TrustServerCertificate is set to true and Encrypt is set to false, the channel is not encrypted. Допустимые значения: true, false, yes и no.Recognized values are true, false, yes, and no. Дополнительные сведения см. в разделе синтаксис строки подключения.For more information, see Connection String Syntax.
Версия системы типовType System Version Н/ДN/A Строковое значение, указывающее систему типов, которую должен иметь приложение.A string value that indicates the type system the application expects. Функции, доступные клиентскому приложению, зависят от версии SQL Server и уровня совместимости базы данных.The functionality available to a client application is dependent on the version of SQL Server and the compatibility level of the database. Явное указание системы типов версии СУБД, для которой было написано клиентское приложение, позволяет избежать потенциальных проблем, которые могут привести к сбою приложения при использовании другой версии SQL Server.Explicitly setting the type system version that the client application was written for avoids potential problems that could cause an application to break if a different version of SQL Server is used. Примечание. Версию системы типов нельзя задать для внутрипроцессного выполнения кода среды CLR на сервере SQL Server.Note: The type system version cannot be set for common language runtime (CLR) code executing in-process in SQL Server. Дополнительные сведения см. в разделе SQL Server интеграция со средойCLR.For more information, see SQL Server Common Language Runtime Integration.

Доступны следующие значения:Possible values are:

Type System Version=SQL Server 2012;

Type System Version=SQL Server 2008;

Type System Version=SQL Server 2005;

Type System Version=Latest;

Type System Version=SQL Server 2012;Указывает, что приложению потребуется версия 11.0.0.0 Microsoft. SqlServer. types. dll.Type System Version=SQL Server 2012; specifies that the application will require version 11.0.0.0 of Microsoft.SqlServer.Types.dll. Для других Type System Version параметров потребуется версия 10.0.0.0 Microsoft. SqlServer. types. dll.The other Type System Version settings will require version 10.0.0.0 of Microsoft.SqlServer.Types.dll.

Latestявляется устаревшим и не должен использоваться.Latest is obsolete and should not be used. Latest равно Type System Version=SQL Server 2008;.Latest is equivalent to Type System Version=SQL Server 2008;.
User IDUser ID

-или--or-

ТАКОЙUID

-или--or-
Н/ДN/A Учетная запись входа SQL Server.The SQL Server login account. Не рекомендуется.Not recommended. Для обеспечения высокого уровня безопасности настоятельно рекомендуется использовать Integrated Security вместо них ключевые слова или. Trusted_ConnectionTo maintain a high level of security, we strongly recommend that you use the Integrated Security or Trusted_Connection keywords instead. SqlCredential— более безопасный способ указания учетных данных для соединения, использующего проверку подлинности SQL Server.SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication.

Идентификатор пользователя не должен превышать 128 символов.The user ID must be 128 characters or less.
User InstanceUser Instance IsFalse'false' Значение, указывающее, следует ли перенаправлять соединение из экземпляра SQL Server Express по умолчанию в экземпляр, инициированный средой выполнения под учетной записью вызывающего.A value that indicates whether to redirect the connection from the default SQL Server Express instance to a runtime-initiated instance running under the account of the caller.
Workstation IDWorkstation ID

- или --or-

WSIDWSID
Имя локального компьютераThe local computer name Имя рабочей станции, соединяющейся с SQL Server.The name of the workstation connecting to SQL Server.

Идентификатор должен содержать не более 128 символов.The ID must be 128 characters or less.

Следующий список содержит допустимые имена для значений пула соединений в ConnectionString.The following list contains the valid names for connection pooling values within the ConnectionString. Дополнительные сведения см. в разделе Пулы подключений SQL Server (ADO.NET).For more information, see SQL Server Connection Pooling (ADO.NET).

  • Время существования подключения (или время ожидания балансировки нагрузки)Connection Lifetime (or Load Balance Timeout)

  • EnlistEnlist

  • Max Pool SizeMax Pool Size

  • Min Pool SizeMin Pool Size

  • PoolingPooling

При задании ключевых слов или значений пулов соединений, требующих логического значения, можно использовать "Yes" вместо "true" и "No" вместо "false".When you are setting keyword or connection pooling values that require a Boolean value, you can use 'yes' instead of 'true', and 'no' instead of 'false'. Целочисленные значения представлены в виде строк.Integer values are represented as strings.

Примечание

Поставщик данных .NET Framework для SQL Server использует собственный протокол для взаимодействия с SQL Server.The .NET Framework Data Provider for SQL Server uses its own protocol to communicate with SQL Server. Поэтому он не поддерживает использование имени источника данных ODBC (DSN) при подключении к SQL Server, так как не добавляет уровень ODBC.Therefore, it does not support the use of an ODBC data source name (DSN) when connecting to SQL Server because it does not add an ODBC layer.

Примечание

Файлы универсальной связи данных (UDL) не поддерживаются поставщиком данных .NET Framework для SQL Server.Universal data link (UDL) files are not supported for the .NET Framework Data Provider for SQL Server.

Внимание!

В этом выпуске приложение должно соблюдать осторожность при создании строки подключения на основе вводимых пользователем данных (например, при получении сведений об ИДЕНТИФИКАТОРе пользователя и пароле из диалогового окна и добавлении их в строку подключения).In this release, the application should use caution when constructing a connection string based on user input (for example when retrieving user ID and password information from a dialog box, and appending it to the connection string). Приложение должно убедиться, что пользователь не может внедрять в эти значения дополнительные параметры строки подключения (например, вводить пароль в виде "валидпассворд; Database = сомедб" при попытке присоединения к другой базе данных).The application should make sure that a user cannot embed additional connection string parameters in these values (for example, entering a password as "validpassword;database=somedb" in an attempt to attach to a different database). Если необходимо создать строки подключения на основе вводимых пользователем данных, используйте новый SqlConnectionStringBuilder, который проверяет строку подключения и помогает устранить эту проблему.If you need to construct connection strings based on user input, use the new SqlConnectionStringBuilder, which validates the connection string and helps to eliminate this problem. Дополнительные сведения см. в разделе построители строк подключения .See Connection String Builders for more information.

Применяется к

Дополнительно