Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Dotyczy: 
.NET Framework .NET Standard
Parametry połączenia zawiera informacje inicjowania przekazywane jako parametr od dostawcy danych do źródła danych. Dostawca danych otrzymuje parametry połączenia jako wartość DbConnection.ConnectionString właściwości. 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 są uwzględniane w wielkości liter. Jednak w zależności od źródła danych może być uwzględniana wielkość liter. Słowa kluczowe i wartości mogą zawierać znaki odstępu. Wiodące i końcowe białe znaki są ignorowane w słowach kluczowych i wartościach bez cudzysłów.
Jeśli wartość zawiera średnik, znaki sterujące Unicode lub wiodące lub końcowe białe znaki, musi być ujęta w pojedynczy lub podwójny cudzysłów. Przykład:
Keyword=" whitespace ";
Keyword='special;character';
Otaczający znak może nie wystąpić w obrębie ujętej wartości. W związku z tym wartość zawierająca pojedyncze cudzysłowy może być ujęta tylko w podwójny cudzysłów i na odwrót:
Keyword='double"quotation;mark';
Keyword="single'quotation;mark";
Możesz również uciec od otaczającego znaku, używając dwóch z nich:
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.