Parametry połączenia w ADO.NET

Dotyczy: .NET Framework .NET Standard

Pobieranie ADO.NET

Ciąg połączenia zawiera informacje inicjalizacyjne, które są przekazywane jako parametr przez dostawcę danych do źródła danych. Dostawca danych otrzymuje ciąg połączenia jako wartość właściwości DbConnection.ConnectionString. Dostawca analizuje parametry połączenia i zapewnia poprawność składni oraz że słowa kluczowe są obsługiwane. DbConnection.Open() Następnie metoda przekazuje przeanalizowane parametry połączenia do źródła danych. Źródło danych przeprowadza dalszą walidację i ustanawia połączenie.

Składnia parametrów połączenia

Parametry połączenia to rozdzielana średnikami lista par parametrów klucz/wartość:

keyword1=value; keyword2=value;

Słowa kluczowe nie rozróżniają wielkości liter. Jednak w zależności od źródła danych może być uwzględniana wielkość liter. Zarówno słowa kluczowe, jak i wartości mogą zawierać białe znaki. Początkowe i końcowe białe znaki są ignorowane w słowach kluczowych i wartościach nieujętych w cudzysłowy.

Jeśli wartość zawiera średnik, sterujące znaki Unicode lub wiodące lub końcowe białe znaki, musi być ujęta w pojedyncze lub podwójne cudzysłowy. Przykład:

Keyword=" whitespace  ";
Keyword='special;character';

Otaczający znak nie może wystąpić wewnątrz wartości, którą otacza. Dlatego wartość zawierająca pojedyncze znaki cudzysłowu może być ujęta tylko w podwójne cudzysłowy i odwrotnie:

Keyword='double"quotation;mark';
Keyword="single'quotation;mark";

Możesz również zamaskować znak otaczający, używając obok siebie dwóch takich znaków:

Keyword="double""quotation";
Keyword='single''quotation';

Znaki cudzysłowu, a także znak równości, nie wymagają ucieczki, więc następujące parametry połączenia są prawidłowe:

Keyword=no "escaping" 'required';
Keyword=a=b=c

Ponieważ każda wartość jest odczytywana do następnego średnika lub końca ciągu, wartość w ostatnim przykładzie to a=b=c, a końcowy średnik jest opcjonalny.

Wszystkie parametry połączenia mają tę samą podstawową składnię opisaną powyżej. Zestaw rozpoznanych słów kluczowych zależy od dostawcy. Dostawca danych Microsoft SqlClient dla programu SQL Server obsługuje wiele słów kluczowych ze starszych interfejsów API, ale ogólnie jest bardziej elastyczny i akceptuje synonimy dla wielu typowych słów kluczowych parametrów połączenia.

Błędy wpisywania mogą powodować błędy. Na przykład jest prawidłowy, Integrated Security=true ale IntegratedSecurity=true powoduje błąd.

Parametry połączenia tworzone ręcznie w czasie działania programu z usuniętych danych wejściowych użytkownika są podatne na ataki polegające na wstrzykiwaniu ciągów i zagrażają bezpieczeństwu bazy danych. Aby rozwiązać te problemy, SqlConnectionStringBuilder klasa została utworzona. Ta klasa konstruktora parametrów połączenia uwidacznia parametry jako silnie typizowane właściwości i umożliwia zweryfikowanie parametrów połączenia przed wysłaniem ich do źródła danych.

W tym dziale

Konstruktor parametrów połączenia
Pokazuje, jak używać klasy ConnectionStringBuilder do konstruowania prawidłowych ciągów połączeń podczas działania programu.

Parametry połączenia i pliki konfiguracji
Pokazuje, jak przechowywać i pobierać parametry połączenia w plikach konfiguracji.

Składnia parametrów połączenia
Opisuje sposób konfigurowania parametrów połączenia specyficznych dla dostawcy dla programu SqlClient.

Ochrona informacji o połączeniu
Demonstruje techniki ochrony informacji używanych do nawiązywania połączenia ze źródłem danych.

Treści powiązane

  • Last updated on