что такое provider в connection string

Entity Connection. Connection String Свойство

Определение

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Возвращает или задает строку соединения EntityConnection.

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

Исключения

Предпринята попытка установить свойство ConnectionString после инициализации EntityConnection из MetadataWorkspace. MetadataWorkspace инициализируется при создании экземпляра EntityConnection через перегрузку, принимающую как параметр MetadataWorkspace или при открытии экземпляра EntityConnection.

В строке подключения предоставлено недопустимое ключевое слово или не предоставлено обязательное.

Примеры

Комментарии

EntityClient Строка подключения состоит из последовательности пар параметров «ключевое слово-значение», разделенных точкой с запятой. Знак равенства (=) соединяет каждое ключевое слово и его значение. В следующей таблице перечислены допустимые имена для значений ключевых слов в строке соединения ConnectionString.

Значение Provider Connection String должно быть заключено в кавычки. Ниже представлен пример такого кода:

Provider Connection String =»Server=serverName; User >

Следующий пример работать не будет:

Пустые пространства, расположенные с обеих сторон вертикальной черты (), не учитываются.

Это ключевое слово является взаимоисключающим по отношению к другим ключевым словам строки соединения.

Приложение может предоставлять непосредственно в ключевое слово/значение ConnectionString свойства, либо можно задать значение для Name ключевое слово. Если Name указывается ключевое слово, ключевое слово/значения строки подключения извлекаются из файла конфигурации приложения, следующим образом:

Если Name используется ключевое слово в ConnectionString свойство, другие ключевые слова не допускаются. Name Ключевое слово ссылается на именованную строку соединения, которая хранится в connectionStrings разделе файла конфигурации приложения, как показано в следующем примере. Provider Значения, Metadata и Provider Connection String извлекаются из файла конфигурации во время выполнения.

Пары «ключевое слово/значение» могут быть также заданы непосредственно в свойстве ConnectionString, как показано в следующем примере. В этом случае Name ключевое слово не используется.

Чтобы избежать случайного размещения объектов, таких как System.Data.Common.CommandTrees и не ObjectContext синхронизированных с их метаданными, EntityConnection необходимо заблокировать свои метаданные. После блокировки метаданных изменения в строке подключения не допускаются. Ниже приведены два сценария блокировки метаданных.

EntityConnectionЭкземпляр создается с помощью конструктора без параметров или с помощью EntityConnection(String) конструктора, который принимает строку подключения. В любом случае строка подключения может быть изменена несколько раз до открытия соединения. Вызов Open или GetMetadataWorkspace Блокировка метаданных.

Когда загружаются метаданные, EntityConnection проверяется наличие концептуальной модели, модели хранения и файла сопоставления.

Источник

Connection String Syntax

Connection String Builders

The connection string builders allow you to construct syntactically valid connection strings at run time, so you do not have to manually concatenate connection string values in your code. For more information, see Connection String Builders.

Windows Authentication

Integrated Security=true throws an exception when used with the OleDb provider.

SqlClient Connection Strings

Windows authentication with SqlClient

Each of the following forms of syntax uses Windows Authentication to connect to the AdventureWorks database on a local server.

SQL Server authentication with SqlClient

Windows Authentication is preferred for connecting to SQL Server. However, if SQL Server Authentication is required, use the following syntax to specify a user name and password. In this example, asterisks are used to represent a valid user name and password.

Windows authentication takes precedence over SQL Server logins. If you specify both Integrated Security=true as well as a user name and password, the user name and password will be ignored and Windows authentication will be used.

Connect to a named instance of SQL Server

To connect to a named instance of SQL Server, use the server name\instance name syntax.

You can also set the DataSource property of the SqlConnectionStringBuilder to the instance name when building a connection string. The DataSource property of a SqlConnection object is read-only.

Type System Version Changes

The Type System Version keyword in a SqlConnection.ConnectionString specifies the client-side representation of SQL Server types. See SqlConnection.ConnectionString for more information about the Type System Version keyword.

Connecting and Attaching to SQL Server Express User Instances

User instances are a feature in SQL Server Express. They allow a user running on a least-privileged local Windows account to attach and run a SQL Server database without requiring administrative privileges. A user instance executes with the user’s Windows credentials, not as a service.

For more information on working with user instances, see SQL Server Express User Instances.

Using TrustServerCertificate

If TrustServerCertificate is set to true and encryption is turned on, the encryption level specified on the server will be used even if Encrypt is set to false in the connection string. The connection will fail otherwise.

Enabling Encryption

To enable encryption when a certificate has not been provisioned on the server, the Force Protocol Encryption and the Trust Server Certificate options must be set in SQL Server Configuration Manager. In this case, encryption will use a self-signed server certificate without validation if no verifiable certificate has been provisioned on the server.

The following table describes all cases.

OleDb Connection Strings

The ConnectionString property of a OleDbConnection allows you to get or set a connection string for an OLE DB data source, such as Microsoft Access. You can also create an OleDb connection string at run time by using the OleDbConnectionStringBuilder class.

OleDb Connection String Syntax

You must specify a provider name for an OleDbConnection connection string. The following connection string connects to a Microsoft Access database using the Jet provider. Note that the User ID and Password keywords are optional if the database is unsecured (the default).

If the Jet database is secured using user-level security, you must provide the location of the workgroup information file (.mdw). The workgroup information file is used to validate the credentials presented in the connection string.

Using DataDirectory to Connect to Access/Jet

Specifying the location of the system database in the connection string is not required if the Access/Jet database is unsecured. Security is off by default, with all users connecting as the built-in Admin user with a blank password. Even when user-level security is correctly implemented, a Jet database remains vulnerable to attack. Therefore, storing sensitive information in an Access/Jet database is not recommended because of the inherent weakness of its file-based security scheme.

Connecting to Excel

The Microsoft Jet provider is used to connect to an Excel workbook. In the following connection string, the Extended Properties keyword sets properties that are specific to Excel. «HDR=Yes;» indicates that the first row contains column names, not data, and «IMEX=1;» tells the driver to always read «intermixed» data columns as text.

Note that the double quotation character required for the Extended Properties must also be enclosed in double quotation marks.

Data Shape Provider Connection String Syntax

Use both the Provider and the Data Provider keywords when using the Microsoft Data Shape provider. The following example uses the Shape provider to connect to a local instance of SQL Server.

Odbc Connection Strings

The ConnectionString property of a OdbcConnection allows you to get or set a connection string for an OLE DB data source. Odbc connection strings are also supported by the OdbcConnectionStringBuilder.

The following connection string uses the Microsoft Text Driver.

Using DataDirectory to Connect to Visual FoxPro

The following OdbcConnection connection string sample demonstrates using DataDirectory to connect to a Microsoft Visual FoxPro file.

Oracle Connection Strings

For more information on ODBC connection string syntax, see ConnectionString.

Источник

Строки подключения и файлы конфигурации

Внедрение строк соединения в код приложения может привести к появлению уязвимых мест в системе безопасности и проблем с обслуживанием. Незашифрованные строки подключения, скомпилированные в исходный код приложения, можно просматривать с помощью средства Ildasm.exe (IL Disassembler). Кроме того, после изменения строки соединения необходимо перекомпилировать приложение. По этим причинам рекомендуется хранить строки соединения в файле конфигурации приложения.

Работа с файлами конфигурации приложения

Файлы конфигурации приложения содержат настройки, относящиеся к отдельному приложению. Например, приложение ASP.NET может иметь один или несколько файлов web.config, а приложение Windows — дополнительный файл app.config. В файлах конфигурации присутствуют общие элементы, хотя имя и расположение любого файла конфигурации в значительной степени зависят от того, где размещается приложение.

Раздел connectionStrings

Строки подключения могут храниться в виде пар «ключ/значение» в разделе connectionStrings элемента configuration файла конфигурации приложения. Дочерние элементы включают add, clear и remove.

Можно сохранить часть строки соединения в файле конфигурации и для ее дополнения во время выполнения использовать класс DbConnectionStringBuilder. Это удобно в сценариях, в которых заранее неизвестны элементы строки соединения или желательно не сохранять конфиденциальные данные в файле конфигурации. Дополнительные сведения см. в статье Connection String Builders (Построители строк подключения).

Использование внешних файлов конфигурации

Внешние файлы конфигурации представляют собой отдельные файлы, каждый из которых содержит фрагмент файла конфигурации, состоящий из одного раздела. В таком случае основной файл конфигурации ссылается на внешний файл конфигурации. Хранение раздела connectionStrings в физически отдельном файле становится удобным в ситуациях, когда может потребоваться внесение изменений в строки подключения после развертывания приложения. Например, в ASP.NET по умолчанию после изменения файлов конфигурации осуществляется перезапуск домена приложения, что приводит к потере сведений о состоянии. Но изменение внешнего файла конфигурации не вызывает перезапуск приложения. Возможность применения внешних файлов конфигурации не ограничивается ASP.NET; их можно также использовать в приложениях Windows. Кроме того, для ограничения доступа к внешним файлам конфигурации могут использоваться средства обеспечения безопасности доступа к файлам и разрешения. Работа с внешними файлами конфигурации во время выполнения осуществляется в прозрачном режиме и не требует разработки специального кода.

Для хранения строк подключения во внешнем файле конфигурации создайте отдельный файл, содержащий единственный раздел connectionStrings. Не следует включать какие-либо дополнительные элементы, разделы или атрибуты. В данном примере показан синтаксис внешнего файла конфигурации.

Получение строк соединения во время выполнения

Файл machine.config также содержит раздел connectionStrings, включающий строку подключения, используемую Visual Studio. При получении строк подключения из файла app.config приложения Windows с помощью имени поставщика в первую очередь загружаются строки подключений из файла machine.config, затем записи из файла app.config. Добавление ключевого слова clear сразу после элемента connectionStrings приводит к удалению из памяти всех ссылок, унаследованных от структуры данных, поэтому учитываются только строки подключений, определенные в локальном файле app.config.

Работа с классами конфигурации

Вызывающему объекту для доступа к файлам конфигурации во время выполнения должны быть предоставлены разрешения. Требуемые разрешения зависят от типа приложения, файла конфигурации и расположения. Дополнительные сведения см. в разделах Использование классов конфигурации и WebConfigurationManager для приложений ASP.NET и ConfigurationManager для приложений Windows.

Для получения строк соединения из файлов конфигурации приложения используется ConnectionStringSettingsCollection. Этот объект содержит коллекцию объектов ConnectionStringSettings, каждый из которых представляет одну запись в разделе connectionStrings. Его свойства сопоставляются с атрибутами строк соединения, что позволяет получить строку соединения, указав имя строки или имя поставщика.

Пример. Список всех строк соединения

Файл System.Configuration.dll не включается в проекты всех типов, поэтому для использования классов конфигурации может потребоваться сформировать на него ссылку. Имя и расположение файла конфигурации определенного приложения зависит от типа приложения и процесса размещения.

Пример. Извлечение строки соединения по имени

Данный пример демонстрирует способ получения строки соединения из файла конфигурации путем указания ее имени. Код создает объект ConnectionStringSettings, сопоставляя указанный входной параметр с именем ConnectionStrings. Если совпадающее имя не найдено, функция возвращает значение null ( Nothing в Visual Basic).

Пример. Извлечение строки соединения по имени поставщика

В этом примере демонстрируется способ получения строки подключения путем указания неизменяемого имени поставщика в формате System.Data.ProviderName. В коде выполняется итерация по ConnectionStringSettingsCollection и происходит возврат строки соединения для первого найденного ProviderName. Если имя поставщика не найдено, функция возвращает значение null ( Nothing в Visual Basic).

Шифрование разделов файлов конфигурации с использованием защищенной конфигурации

В ASP.NET 2.0 появилась новая возможность, защищенная конфигурация, с помощью которой можно шифровать в файле конфигурации конфиденциальную информацию. Защищенная конфигурация разрабатывалась в первую очередь для ASP.NET, но ее можно также использовать для шифрования разделов файлов конфигурации в приложениях Windows. Подробное описание возможностей защищенной конфигурации см. в разделе Шифрование сведений о конфигурации с помощью функции защищенной конфигурации.

В приведенном ниже фрагменте файла конфигурации показан раздел connectionStrings после шифрования. В разделе configProtectionProvider задается поставщик защищенной конфигурации, который используется для шифрования и дешифрования строк подключения. Раздел EncryptedData содержит зашифрованный текст.

Поставщики защищенной конфигурации

Оба поставщика обеспечивают надежное шифрование данных. Однако, если планируется использовать один файл конфигурации на нескольких серверах, как в веб-ферме, то только RsaProtectedConfigurationProvider позволяет экспортировать ключи шифрования, применяемые для шифрования данных, и импортировать их в другой сервер. Дополнительные сведения см. в разделе Импорт и экспорт защищенных контейнеров ключей RSA для конфигурации.

Использование классов конфигурации

Пространство имен System.Security.Cryptography содержит классы, которые предоставляют дополнительные возможности шифрования и расшифровки данных. Эти классы можно использовать в том случае, если требуются криптографические службы, недоступные с использованием защищенной конфигурации. Некоторые из этих классов являются оболочками для Microsoft CryptoAPI, а другие представляют собой реализации полностью на управляемом коде. Дополнительные сведения см. в разделе Службы криптографии.

Пример App.config

Этот пример демонстрирует переключение шифрования раздела connectionStrings в файле app.config для приложения Windows. В этом примере процедура принимает имя приложения в качестве аргумента, например, «MyApplication.exe». Затем файл app.config зашифровывается и копируется в папку, которая содержит исполняемый файл с именем MyApplication.exe.config.

Строку соединения можно расшифровать только на компьютере, где она была зашифрована.

Источник

Ole DbConnection. Connection String Свойство

Определение

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Получает или задает строку, используемую для открытия базы данных.

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

Реализации

Исключения

Передан недопустимый аргумент строки соединения, или не задан обязательный аргумент строки соединения.

Примеры

В следующем примере создается OleDbConnection и задаются некоторые свойства в строке подключения.

Комментарии

Объект ConnectionString предназначен для сопоставления формата строки подключения OLE DB как можно точнее со следующими исключениями:

Свойство можно использовать ConnectionString для подключения к различным источникам данных. В следующем примере показаны несколько возможных строк подключения.

Если в Data Source строке соединения не указано ключевое слово, поставщик попытается подключиться к локальному серверу, если он доступен.

При сбросе ConnectionString для закрытого соединения сбрасываются все значения строк подключения и связанные свойства. Сюда входит пароль. Например, если задать строку подключения, включающую «начальный каталог = AdventureWorks», а затем сбросить строку подключения к «Provider = SQLOLEDB; Data Source = MySQLServer; IntegratedSecurity = SSPI», Database свойство больше не будет иметь значение AdventureWorks. (Начальное значение каталога строки подключения соответствует Database свойству.)

Базовый формат строки подключения включает ряд пар «ключевое слово-значение», разделенных точкой с запятой. Знак равенства (=) соединяет каждое ключевое слово и его значение. Чтобы включить значения, содержащие символы точки с запятой, одиночной кавычки или двойные кавычки, значение должно быть заключено в двойные кавычки. Если значение содержит и точку с запятой, и символ двойной кавычки, это значение можно заключить в одинарные кавычки. Одинарная кавычка также полезна, если значение начинается с символа двойной кавычки. И наоборот, если значение начинается с одиночной кавычки, можно использовать двойные кавычки. Если значение содержит как одинарные, так и двойные кавычки, то символ-знак кавычки, используемый для заключения значения, должен быть удвоен каждый раз, когда он встречается в значении.

Чтобы включить в строковое значение предшествующие или конечные пробелы, значение должно быть заключено в одинарные кавычки или двойные кавычки. Все начальные и конечные пробелы вокруг целых, логических или перечисляемых значений игнорируются, даже если они заключены в кавычки. Однако пробелы в ключевом слове или значении строкового литерала сохраняются. Одинарные или двойные кавычки могут использоваться в строке соединения без использования разделителей (например, Data Source= my’Server или Data Source= my»Server ), если только символ кавычки не является первым или последним символом в значении.

Чтобы включить знак равенства (=) в ключевое слово или значение, перед ним должен стоять другой знак равенства. Например, в гипотетической строке подключения

ключевое слово «Key = Word», а значение — «value».

Если определенное ключевое слово в паре «ключевое слово = значение» встречается несколько раз в строке подключения, то в наборе значений используется последнее вхождение в списке.

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

Следует соблюдать осторожность при создании строки подключения на основе вводимых пользователем данных, например при получении сведений об ИДЕНТИФИКАТОРе пользователя и пароле из диалогового окна и добавлении их в строку подключения. Приложение должно убедиться, что пользователь не может внедрить в эти значения дополнительные параметры строки подключения, например, введя пароль в виде «валидпассворд; база данных = сомедб» при попытке присоединения к другой базе данных. Если вы используете параметр строки подключения расширенных свойств для OLE DB соединений, не следует передавать идентификаторы пользователей и пароли, так как следует избегать сохранения идентификаторов пользователей и паролей в виде открытого текста, если это возможно, и поскольку параметр по умолчанию Persist Security Info= false не влияет на Extended Properties параметр.

Источник