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

Definicja

Pobiera lub ustawia ciąg używany do otwierania bazy danych programu SQL Server.Gets or sets the string used to open a SQL Server database.

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

Wartość właściwości

Parametry połączenia, Nazwa źródłowej bazy danych i inne parametry wymagane do nawiązania początkowego połączenia.The connection string that includes the source database name, and other parameters needed to establish the initial connection. Wartością domyślną jest ciąg pusty.The default value is an empty string.

Implementuje

Wyjątki

Podano nieprawidłowe połączenie argument ciągu lub nie został podany argument ciągu połączenia wymagane.An invalid connection string argument has been supplied, or a required connection string argument has not been supplied.

Przykłady

Poniższy przykład tworzy SqlConnection i ustawia ConnectionString właściwości przed otwarciem połączenia.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

Uwagi

ConnectionString Jest podobny do parametrów połączenia usługi OLE DB, ale nie jest taka sama.The ConnectionString is similar to an OLE DB connection string, but is not identical. W odróżnieniu od OLE DB i ADO parametry połączenia, który jest zwracany jest taka sama jak zestaw użytkowników ConnectionString, minus informacji o zabezpieczeniach, jeśli ustawiono wartość Persist Security Info false (ustawienie domyślne).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 Data Provider for SQL Server mogą lub nie zwracają hasło w parametrach połączenia, chyba że równa Persist Security Info 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.

Możesz użyć ConnectionString właściwość, aby połączyć się z bazą danych.You can use the ConnectionString property to connect to a database. Poniższy przykład ilustruje typowe parametry połączenia.The following example illustrates a typical connection string.

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

Użyj nowego SqlConnectionStringBuilder do utworzenia prawidłowego połączenia ciągów w czasie wykonywania.Use the new SqlConnectionStringBuilder to construct valid connection strings at run time. Aby uzyskać więcej informacji, zobacz Konstruktorzy parametrów połączeń.For more information, see Connection String Builders.

ConnectionString Właściwość można ustawić tylko wtedy, gdy połączenie jest zamknięte.The ConnectionString property can be set only when the connection is closed. Wiele wartości parametrów połączenia ma odpowiadające właściwości tylko do odczytu.Many of the connection string values have corresponding read-only properties. Po ustawieniu parametrów połączenia tych właściwości są aktualizowane, z wyjątkiem sytuacji, gdy zostanie wykryty błąd.When the connection string is set, these properties are updated, except when an error is detected. W tym przypadku żadnej właściwości są aktualizowane.In this case, none of the properties are updated. SqlConnection właściwości zwracać tylko te ustawienia, które są zawarte w ConnectionString.SqlConnection properties return only those settings that are contained in the ConnectionString.

Aby połączyć komputer lokalny, określ "(local)" dla serwera.To connect to a local computer, specify "(local)" for the server. Jeśli nie określono nazwy serwera, połączenie będzie próbował domyślnego wystąpienia, na komputerze lokalnym.If a server name is not specified, a connection will be attempted to the default instance on the local computer.

Resetowanie ConnectionString zamkniętego połączenia spowoduje zresetowanie wszystkich wartości parametrów połączeń (i powiązane właściwości) w tym hasła.Resetting the ConnectionString on a closed connection resets all connection string values (and related properties) including the password. Na przykład jeśli ustawisz parametry połączenia, który zawiera "bazy danych = AdventureWorks", a następnie zresetować parametry połączenia do "źródła danych = myserver; zabezpieczenia zintegrowane = true", Database właściwość nie jest ustawiona na "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".

Ciąg połączenia jest analizowany natychmiast po ich ustawiania.The connection string is parsed immediately after being set. Jeśli wystąpią błędy w składni, podczas analizowania, wyjątek czasu wykonywania, takie jak ArgumentException, jest generowany.If errors in syntax are found when parsing, a runtime exception, such as ArgumentException, is generated. Inne błędy, można znaleźć tylko wtedy, gdy podejmowana jest próba otwarcia połączenia.Other errors can be found only when an attempt is made to open the connection.

Podstawowy format parametrów połączenia zawiera szereg — słowo kluczowe/pary wartości, oddziel je średnikami.The basic format of a connection string includes a series of keyword/value pairs separated by semicolons. Znak równości (=) łączy każde słowo kluczowe i jego wartość.The equal sign (=) connects each keyword and its value. Aby uwzględnić wartości, które zawiera średnik, znak pojedynczego cudzysłowu ani znaku podwójnego cudzysłowu, wartości muszą być ujęte w podwójny cudzysłów.To include values that contain a semicolon, single-quote character, or double-quote character, the value must be enclosed in double quotation marks. Jeśli wartość zawiera zarówno średnikami, jak i znaku podwójnego cudzysłowu, wartość mogą być ujęte w znaki pojedynczego cudzysłowu.If the value contains both a semicolon and a double-quote character, the value can be enclosed in single quotation marks. Pojedynczy cudzysłów jest również przydatne, jeśli wartość zaczyna się od znaku podwójnego cudzysłowu.The single quotation mark is also useful if the value starts with a double-quote character. Z drugiej strony podwójny cudzysłów służy Jeśli wartość zaczyna się od pojedynczego cudzysłowu.Conversely, the double quotation mark can be used if the value starts with a single quotation mark. Jeśli wartość zawiera znaki pojedynczego cudzysłowu i podwójnego cudzysłowu, znaku cudzysłowu, używane, aby ująć wartość musi być podwójny za każdym razem, gdy wystąpi w wartość.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.

Aby dołączyć spacji ani na końcu wartości ciągu, wartości muszą być ujęte w znaki cudzysłowu pojedynczego lub podwójnego cudzysłowu.To include preceding or trailing spaces in the string value, the value must be enclosed in either single quotation marks or double quotation marks. Spacji wiodących i końcowych wokół integer, Boolean lub wartości wyliczenia są ignorowane, nawet jeśli ujęta w znaki cudzysłowu.Any leading or trailing spaces around integer, Boolean, or enumerated values are ignored, even if enclosed in quotation marks. Jednak spacje wewnątrz ciągu literal — słowo kluczowe lub wartość są zachowywane.However, spaces within a string literal keyword or value are preserved. Pojedyncze lub podwójne znaki cudzysłowu mogą być używane w ciągu połączenia bez korzystania z ogranicznikami (na przykład źródło danych = my'Server lub źródło danych = my "Server), chyba że znak cudzysłowu jest pierwszy lub ostatni znak w wartości.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.

Słowa kluczowe nie są z uwzględnieniem wielkości liter.Keywords are not case sensitive.

W poniższej tabeli wymieniono prawidłowe nazwy wartości — słowo kluczowe w ramach ConnectionString.The following table lists the valid names for keyword values within the ConnectionString.

Słowo kluczoweKeyword DomyślnyDefault OpisDescription
addrAddr BrakN/A Synonim źródła danych.Synonym of Data Source.
AdresAddress BrakN/A Synonim źródła danych.Synonym of Data Source.
AplikacjaApp BrakN/A Synonim Nazwa aplikacji.Synonym of Application Name.
Nazwa aplikacjiApplication Name BrakN/A Nazwa aplikacji lub "SQLClient dostawcy danych .NET" Jeśli nie podano żadnych nazwy aplikacji.The name of the application, or '.NET SQLClient Data Provider' if no application name is provided.

Nazwa aplikacji może być 128 znaków lub mniej.An application name can be 128 characters or less.
ApplicationIntent ReadWrite Deklaruje typ obciążeń aplikacji, podczas nawiązywania połączenia z serwerem.Declares the application workload type when connecting to a server. Możliwe wartości to ReadOnly i ReadWrite.Possible values are ReadOnly and ReadWrite. Na przykład:For example:

ApplicationIntent=ReadOnly

Aby uzyskać więcej informacji na temat Obsługa SqlClient dla zawsze włączonych grup dostępności, zobacz Obsługa SqlClient dla wysokiej dostępności, odzyskiwania po awarii.For more information about SqlClient support for Always On Availability Groups, see SqlClient Support for High Availability, Disaster Recovery.
Przetwarzanie asynchroniczneAsynchronous Processing

—lub—-or-

AsyncAsync
wartość "false"'false' Gdy true, umożliwia obsługę operacji asynchronicznej.When true, enables asynchronous operation support. Rozpoznawane są wartości true, false, yes, i no.Recognized values are true, false, yes, and no.

Ta właściwość jest ignorowana, począwszy od .NET Framework 4.5.NET Framework 4.5.This property is ignored beginning in .NET Framework 4.5.NET Framework 4.5. Aby uzyskać więcej informacji na temat Obsługa SqlClient dla programowania asynchronicznego, zobacz Asynchronous Programming.For more information about SqlClient support for asynchronous programming, see Asynchronous Programming.
AttachDBFilenameAttachDBFilename

—lub—-or-

Właściwości rozszerzoneExtended Properties

—lub—-or-

Początkowa nazwa plikuInitial File Name
BrakN/A Nazwa pliku podstawowej bazy danych, w tym pełną nazwę ścieżki można dołączyć bazy danych.The name of the primary database file, including the full path name of an attachable database. AttachDBFilename jest obsługiwana tylko dla danych podstawowych plików z rozszerzeniem .mdf.AttachDBFilename is only supported for primary data files with an .mdf extension.

Jeśli wartość klucza AttachDBFileName określono w parametrach połączenia, baza danych jest dołączona i staje się domyślna baza danych dla połączenia.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.

Jeśli ten klucz nie jest określona i została wcześniej dołączyć bazy danych, bazy danych będzie nie być ponownie dołączyć.If this key is not specified and if the database was previously attached, the database will not be reattached. Wcześniej dołączonej bazie danych będzie służyć jako domyślna baza danych dla połączenia.The previously attached database will be used as the default database for the connection.

Jeśli ten klucz jest określona, wraz z kluczem AttachDBFileName, wartość tego klucza będzie służyć jako alias.If this key is specified together with the AttachDBFileName key, the value of this key will be used as the alias. Jednakże jeśli nazwa jest już używana w innej bazie danych dołączonych, połączenie zakończy się niepowodzeniem.However, if the name is already used in another attached database, the connection will fail.

Ścieżka może być bezwzględny lub względny przy użyciu parametrów podstawiania DataDirectory.The path may be absolute or relative by using the DataDirectory substitution string. Jeśli DataDirectory jest używany, plik bazy danych musi istnieć w podkatalogu katalogu wskazywany przez ciąg podstawienia.If DataDirectory is used, the database file must exist within a subdirectory of the directory pointed to by the substitution string. Uwaga: Serwer zdalny, HTTP i UNC nazwy ścieżek nie są obsługiwane.Note: Remote server, HTTP, and UNC path names are not supported.

Nazwa bazy danych musi być określona za pomocą słowa kluczowego "database" (lub jeden z jego aliasy) tak jak poniżej: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"

Błąd zostanie wygenerowany, jeśli plik dziennika istnieje w tym samym katalogu co plik danych, a słowa kluczowego "database" jest używany podczas dołączania pliku danych głównych.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. W takim przypadku usuń plik dziennika.In this case, remove the log file. Po dołączeniu bazy danych nowy plik dziennika zostanie automatycznie wygenerowany na podstawie ścieżki fizycznej.Once the database is attached, a new log file will be automatically generated based on the physical path.
UwierzytelnianieAuthentication BrakN/A Metody uwierzytelniania użytej podczas nawiązywania połączenia z SQL bazy danych przez przy użyciu usługi Azure Active Directory Authentication.The authentication method used for Connecting to SQL Database By Using Azure Active Directory Authentication.

Prawidłowe wartości to:Valid values are:

Hasła usługi Active Directory zintegrowane, Active Directory hasło Sql.Active Directory Integrated, Active Directory Password, Sql Password.
Ustawienia szyfrowania kolumnyColumn Encryption Setting BrakN/A Włącza lub wyłącza Always Encrypted funkcjonalność dla połączenia.Enables or disables Always Encrypted functionality for the connection.
Limit czasu połączeniaConnect Timeout

—lub—-or-

Limit czasu połączeniaConnection Timeout

—lub—-or-

limit czasuTimeout
1515 Czas (w sekundach) oczekiwania na połączenie z serwerem przed zakończeniem próby i wygenerowaniem błędu.The length of time (in seconds) to wait for a connection to the server before terminating the attempt and generating an error.

Prawidłowe wartości są większe niż lub równa 0 i mniejsza niż 2147483647.Valid values are greater than or equal to 0 and less than or equal to 2147483647.

Po otwarciu połączenia z usługą Azure SQL Database, należy ustawić limit czasu połączenia do 30 sekund.When opening a connection to a Azure SQL Database, set the connection timeout to 30 seconds.
Okres istnienia połączeniaConnection Lifetime

—lub—-or-

Limit czasu równoważenia obciążeniaLoad Balance Timeout
00 Połączenia są zwracane do puli, jej godzina utworzenia jest porównywany z bieżącym czasem, gdy połączenie jest niszczony, jeśli ten przedział czasu (w sekundach) przekracza wartość określoną przez 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. Jest to przydatne w konfiguracji klastra, aby wymusić Równoważenie obciążenia między używania serwera i serwera, po prostu przełączyć do trybu online.This is useful in clustered configurations to force load balancing between a running server and a server just brought online.

Wartość zero (0) powoduje, że puli połączeń mieć maksymalny limit czasu połączenia.A value of zero (0) causes pooled connections to have the maximum connection timeout.
ConnectRetryCountConnectRetryCount 11 Formanty liczbę ponownego łączenia prób po identyfikuje klienta wystąpił błąd bezczynnego połączenia.Controls the number of reconnection attempts after the client identifies an idle connection failure. Prawidłowe wartości to 0 do 255.Valid values are 0 to 255. Domyślnym ustawieniem jest 1.The default is 1. 0 oznacza, że nie należy próbować ponownie (Wyłącz elastyczność połączenia).0 means do not attempt to reconnect (disable connection resiliency).

Aby uzyskać dodatkowe informacje dotyczące odporności bezczynnego połączenia, zobacz artykułu technicznego — bezczynne elastyczność połączenia.For additional information about idle connection resiliency, see Technical Article - Idle Connection Resiliency.
ConnectRetryIntervalConnectRetryInterval 1010 Określa czas między kolejnymi próbami ponowienia połączenia (ConnectRetryCount).Specifies the time between each connection retry attempt (ConnectRetryCount). Prawidłowe wartości to 1 do 60 sekund (domyślny = 10), są stosowane po pierwsza próba ponownego połączenia.Valid values are 1 to 60 seconds (default=10), applied after the first reconnection attempt. Po wykryciu przerwane połączenia klienta natychmiast próbuje ponownie połączyć; to jest pierwsza próba ponownego połączenia i tylko wtedy, gdy ConnectRetryCount jest większa niż 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. Jeśli pierwsza próba ponownego połączenia nie powiedzie się i ConnectRetryCount jest większa niż 1, klient odczekuje ConnectRetryInterval próby prób ponownego połączenia z drugim i kolejnych.If the first reconnection attempt fails and ConnectRetryCount is greater than 1, the client waits ConnectRetryInterval to try the second and subsequent reconnection attempts.

Aby uzyskać dodatkowe informacje dotyczące odporności bezczynnego połączenia, zobacz artykułu technicznego — bezczynne elastyczność połączenia.For additional information about idle connection resiliency, see Technical Article - Idle Connection Resiliency.
Połączenie kontekstuContext Connection wartość "false"'false' true Jeśli należy w trakcie połączenia programu SQL Server.true if an in-process connection to SQL Server should be made.
Bieżący językCurrent Language

—lub—-or-

JęzykLanguage
BrakN/A Określa język używany dla wiadomości ostrzeżenia lub błędu serwera bazy danych.Sets the language used for database server warning or error messages.

Nazwa języka mogą mieć 128 znaków lub mniej.The language name can be 128 characters or less.
Źródło danychData Source

—lub—-or-

SerwerServer

—lub—-or-

AdresAddress

—lub—-or-

addrAddr

—lub—-or-

Adres sieciowyNetwork Address
BrakN/A Nazwa lub adres sieciowy wystąpienia programu SQL Server, którym chcesz się połączyć.The name or network address of the instance of SQL Server to which to connect. Numer portu, można określić po nazwie serwera:The port number can be specified after the server name:

server=tcp:servername, portnumber

Podczas określania wystąpienia lokalnego, należy zawsze używać (lokalny).When specifying a local instance, always use (local). Aby wymusić protokół, Dodaj jeden z następujących prefiksów:To force a protocol, add one of the following prefixes:

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

Począwszy od .NET Framework 4.5.NET Framework 4.5, można też połączyć z bazą danych LocalDB w następujący sposób:Beginning in .NET Framework 4.5.NET Framework 4.5, you can also connect to a LocalDB database as follows:

server=(localdb)\\myInstance

Aby uzyskać więcej informacji dotyczących programu LocalDB, zobacz Obsługa SqlClient dla LocalDB.For more information about LocalDB, see SqlClient Support for LocalDB.

Źródło danych należy użyć w formacie protokołu TCP lub Named Pipes.Data Source must use the TCP format or the Named Pipes format.

TCP format jest następujący:TCP format is as follows:

-tcp:<nazwa hosta >\< nazwa wystąpienia>- tcp:<host name>\<instance name>
-tcp:<nazwa hosta >,<numer portu TCP/IP >- tcp:<host name>,<TCP/IP port number>

TCP format musi rozpoczynać się od prefiksu "tcp:" i następują wystąpienia bazy danych, określony przez nazwę hosta i nazwę wystąpienia.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. Ten format nie jest stosowana podczas nawiązywania połączenia z usługą Azure SQL Database.This format is not applicable when connecting to Azure SQL Database. TCP jest automatycznie wybierany do połączenia z bazą danych SQL Azure, gdy nie określono protokołu.TCP is automatically selected for connections to Azure SQL Database when no protocol is specified.

Nazwa hosta musi być określona w jednym z następujących sposobów:The host name MUST be specified in one of the following ways:

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

Nazwa wystąpienia jest używana do rozpoznawania określonej numer portu TCP/IP, na którym znajduje się wystąpienie bazy danych.The instance name is used to resolve to a particular TCP/IP port number on which a database instance is hosted. Alternatywnie bezpośrednio określania numeru portu TCP/IP jest również dozwolony.Alternatively, specifying a TCP/IP port number directly is also allowed. Jeśli zarówno nazwa wystąpienia oraz numer portu nie są obecne, używana jest domyślnym wystąpieniem bazy danych.If both instance name and port number are not present, the default database instance is used.

Nazwane potoki format jest następujący:The Named Pipes format is as follows:

— potoki:\\< nazwa hosta>\pipe\< Nazwa potoku>- np:\\<host name>\pipe\<pipe name>

Format potoków nazwanych musi rozpoczynać się od prefiksu "np:" i następuje nazwa nazwanego potoku.The Named Pipes format MUST start with the prefix "np:" and is followed by a named pipe name.

Nazwa hosta musi być określona w jednym z następujących sposobów:The host name MUST be specified in one of the following ways:

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

Nazwa potoku jest używana do identyfikowania wystąpienia bazy danych, do którego zostanie podłączony aplikacji .NET Framework.The pipe name is used to identify the database instance to which the .NET Framework application will be connected.

Jeśli wartość sieci określono klucza prefiksy "tcp:" i "np:" nie powinien być określony.If the value of the Network key is specified, the prefixes "tcp:" and "np:" should not be specified. Uwaga: Można wymusić użycie protokołu TCP, zamiast pamięci współużytkowanej, albo przez dodanie przedrostka tcp: na nazwę serwera w parametrach połączenia lub za pomocą 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.
szyfrowanieEncrypt wartość "false"'false' Gdy true, program SQL Server używa szyfrowania SSL dla wszystkich danych przesyłanych między klientem i serwerem, jeśli serwer ma zainstalowany certyfikat.When true, SQL Server uses SSL encryption for all data sent between the client and server if the server has a certificate installed. Rozpoznawane są wartości true, false, yes, i no.Recognized values are true, false, yes, and no. Aby uzyskać więcej informacji, zobacz składnia ciągu połączenia.For more information, see Connection String Syntax.

Począwszy od .NET Framework 4.5.NET Framework 4.5, gdy TrustServerCertificate ma wartość FAŁSZ i Encrypt ma wartość true, nazwę serwera (lub adres IP) w certyfikacie SSL serwera SQL musi dokładnie odpowiadać serwera nazwę (lub adres IP) określone w parametrach połączenia.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. W przeciwnym razie próba połączenia zakończy się niepowodzeniem.Otherwise, the connection attempt will fail. Informacje na temat obsługi certyfikatów, którego podmiot zaczyna się od symbolu wieloznacznego (*), zobacz zaakceptowane używany przez certyfikatów serwera do uwierzytelniania serwera symboli wieloznacznych.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 Wskazuje, że pulę połączeń programu SQL Server automatycznie rejestruje połączenia w bieżącym kontekście transakcji wątku tworzenia.true indicates that the SQL Server connection pooler automatically enlists the connection in the creation thread's current transaction context.
Partnerski trybu failoverFailover Partner BrakN/A Nazwa serwera partnerskiego trybu failover, w której jest skonfigurowana w procesie dublowania bazy danych.The name of the failover partner server where database mirroring is configured.

Jeśli wartość tego klucza jest "", następnie Initial Catalog muszą być obecne, a jego wartość nie może być "".If the value of this key is "", then Initial Catalog must be present, and its value must not be "".

Nazwa serwera może być 128 znaków lub mniej.The server name can be 128 characters or less.

Jeśli określisz partnerski trybu failover, ale serwer partnerski trybu failover nie jest skonfigurowany dla funkcji dublowania baz danych serwera podstawowego (określonym za pomocą słowa kluczowego serwera) nie jest dostępne, a następnie połączenie zakończy się niepowodzeniem.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.

Jeśli określisz partnerski trybu failover i serwer podstawowy nie jest skonfigurowany dla funkcji dublowania baz danych, połączenie z serwerem podstawowym, (określonym za pomocą słowa kluczowego serwera) zakończy się pomyślnie, jeśli serwer główny jest niedostępny.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.
Katalog początkowyInitial Catalog

—lub—-or-

Baza danychDatabase
BrakN/A Nazwa bazy danych.The name of the database.

Nazwa bazy danych może być 128 znaków lub mniej.The database name can be 128 characters or less.
Zabezpieczenia zintegrowaneIntegrated Security

—lub—-or-

Trusted_ConnectionTrusted_Connection
wartość "false"'false' Gdy false, identyfikator użytkownika i hasło, które są określone w połączeniu.When false, User ID and Password are specified in the connection. Gdy true, bieżące poświadczenia konta Windows są używane do uwierzytelniania.When true, the current Windows account credentials are used for authentication.

Rozpoznawane są wartości true, false, yes, no, i sspi (zdecydowanie zalecane), który jest odpowiednikiem true.Recognized values are true, false, yes, no, and sspi (strongly recommended), which is equivalent to true.

Jeśli identyfikator użytkownika i hasło są określone i zintegrowane zabezpieczeń jest ustawiona na wartość true, identyfikator użytkownika i hasło zostaną zignorowane i zintegrowanych zabezpieczeń, który będzie używany.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 jest Bezpieczniejszym sposobem, aby określić poświadczenia dla połączenia, który używa uwierzytelniania programu 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).
Maksymalny rozmiar puliMax Pool Size 100100 Maksymalna liczba połączeń, które są dozwolone w puli.The maximum number of connections that are allowed in the pool.

Prawidłowe wartości są większe niż lub równa 1.Valid values are greater than or equal to 1. Wartości, które są mniej niż minimalny rozmiar puli wygenerowanie błędu.Values that are less than Min Pool Size generate an error.
Minimalny rozmiar puliMin Pool Size 00 Minimalna liczba połączeń, które są dozwolone w puli.The minimum number of connections that are allowed in the pool.

Prawidłowe wartości są większe niż lub równa 0.Valid values are greater than or equal to 0. Zero (0) w tym polu oznacza, że minimalna połączeń początkowo są otwarte.Zero (0) in this field means no minimum connections are initially opened.

Wartości, które są większe niż maksymalny rozmiar puli wygenerowanie błędu.Values that are greater than Max Pool Size generate an error.
MultipleActiveResultSetsMultipleActiveResultSets wartość "false"'false' Gdy true, aplikacja zapewnia wiele aktywnych zestawów wyników (MARS).When true, an application can maintain multiple active result sets (MARS). Gdy false, aplikacja musi przetworzyć lub anulować wszystkich zestawów wyników z jednej partii, zanim może on wykonać inne usługi batch dla tego połączenia.When false, an application must process or cancel all result sets from one batch before it can execute any other batch on that connection.

Rozpoznawane są wartości true i false.Recognized values are true and false.

Aby uzyskać więcej informacji, zobacz wielu aktywnych zestawów wyników (MARS).For more information, see Multiple Active Result Sets (MARS).
MultiSubnetFailover FAŁSZFALSE Zawsze określać multiSubnetFailover=True podczas nawiązywania połączenia z grupy dostępności odbiornik programu SQL Server 2012 (lub nowszym) grupy dostępności lub SQL Server 2012 (lub nowszy) wystąpienia klastra trybu Failover.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 Konfiguruje SqlClient, aby zapewnić szybsze wykrywanie i połączenie z serwerem () aktywna.multiSubnetFailover=True configures SqlClient to provide faster detection of and connection to the (currently) active server. Możliwe wartości to Yes i No, True i False lub 1 i 0.Possible values are Yes and No, True and False or 1 and 0. Na przykład:For example:

MultiSubnetFailover=True

Wartość domyślna to False.The default is False. Aby uzyskać więcej informacji na temat obsługi firmy SqlClient zawsze na ji zobacz Obsługa SqlClient dla wysokiej dostępności, odzyskiwania po awarii.For more information about SqlClient's support for Always On AGs, see SqlClient Support for High Availability, Disaster Recovery.
Biblioteka sieciowaNetwork Library

—lub—-or-

SiećNetwork

—lub—-or-

NETNet
BrakN/A Biblioteka sieciowa używana do nawiązywania połączenia z wystąpieniem programu SQL Server.The network library used to establish a connection to an instance of SQL Server. Obsługiwane wartości to:Supported values include:

dbnmpntw (nazwane potoki)dbnmpntw (Named Pipes)

dbmsrpcn (wieloprotokołowym, Windows RPC)dbmsrpcn (Multiprotocol, Windows RPC)

Dbmsadsn (Apple Talk)dbmsadsn (Apple Talk)

dbmsgnet (VIA)dbmsgnet (VIA)

dbmslpcn (pamięci współużytkowanej)dbmslpcn (Shared Memory)

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

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

Dbmsvinn (Banyan Vines)Dbmsvinn (Banyan Vines)

Odpowiednie sieci DLL musi być zainstalowany w systemie, do której się łączysz.The corresponding network DLL must be installed on the system to which you connect. Jeśli nie określisz sieci i używać lokalnego serwera (na przykład "." lub "(local)"), Pamięć współużytkowana jest używany.If you do not specify a network and you use a local server (for example, "." or "(local)"), shared memory is used. W tym przykładzie biblioteki sieciowej jest Win32 Winsock TCP/IP (dbmssocn) i 1433 to port używany.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;
Rozmiar pakietuPacket Size 80008000 Rozmiar w bajtach pakietów sieciowych używanych do komunikowania się z wystąpieniem programu SQL Server.Size in bytes of the network packets used to communicate with an instance of SQL Server.

Rozmiar pakietu może być większa lub równa 512 i mniejsza niż lub równa 32768.The packet size can be greater than or equal to 512 and less than or equal to 32768.
HasłoPassword

—lub—-or-

PWDPWD
BrakN/A Hasło dla konta programu SQL Server, logowanie.The password for the SQL Server account logging on. Nie jest to zalecane.Not recommended. Aby zachować wysoki poziom zabezpieczeń, zdecydowanie zalecamy użycie Integrated Security lub Trusted_Connection słowa kluczowego zamiast tego.To maintain a high level of security, we strongly recommend that you use the Integrated Security or Trusted_Connection keyword instead. SqlCredential jest Bezpieczniejszym sposobem, aby określić poświadczenia dla połączenia, który używa uwierzytelniania programu SQL Server.SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication.

Hasło musi mieć 128 znaków lub mniej.The password must be 128 characters or less.
Utrwal informacje zabezpieczającePersist Security Info

—lub—-or-

PersistSecurityInfoPersistSecurityInfo
wartość "false"'false' Po ustawieniu false lub no (zdecydowanie zalecane), informacje związane z zabezpieczeniami, takich jak hasła, nie jest zwracana jako część połączenia, jeśli połączenie jest otwarte lub kiedykolwiek było w stanie otwartym.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. Resetowanie parametrów połączenia powoduje zresetowanie wszystkich wartości parametrów połączeń, w tym hasła.Resetting the connection string resets all connection string values including the password. Rozpoznawane są wartości true, false, yes, i no.Recognized values are true, false, yes, and no.
PoolBlockingPeriodPoolBlockingPeriod AutoAuto Ustawia zachowania okresu blokowania dla puli połączeń.Sets the blocking period behavior for a connection pool. Zobacz PoolBlockingPeriod właściwości, aby uzyskać szczegółowe informacje.See PoolBlockingPeriod property for details.
BuforowaniePooling 'true''true' Jeśli wartość tego klucza jest równa true, wszystkich nowo utworzonych połączenie zostanie dodane do puli po zamknięciu przez aplikację.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. W następnym próba otwarcia tego samego połączenia to połączenie będzie rysowany z puli.In a next attempt to open the same connection, that connection will be drawn from the pool.

Połączenia są traktowane jako takie same, jeśli mają te same parametry połączenia.Connections are considered the same if they have the same connection string. Różne połączenia mają inne połączenie ciągi.Different connections have different connection strings.

Wartość tego klucza, może być "prawda", "false", "yes" lub "no".The value of this key can be "true", "false", "yes", or "no".
ReplikacjiReplication wartość "false"'false' true Jeśli replikacja jest obsługiwana przy użyciu połączenia.true if replication is supported using the connection.
Transakcja powiązaniaTransaction Binding Niejawne UnbindImplicit Unbind Kontroluje skojarzenia połączenia za pomocą zobowiązaniom System.Transactions transakcji.Controls connection association with an enlisted System.Transactions transaction.

Możliwe wartości to:Possible values are:

Transaction Binding=Implicit Unbind;

Transaction Binding=Explicit Unbind;

Niejawne Unbind powoduje, że połączenia można odłączyć od transakcji, po jego zakończeniu.Implicit Unbind causes the connection to detach from the transaction when it ends. Po odłączania, dodatkowych żądań połączenia są wykonywane w trybie autozatwierdzania.After detaching, additional requests on the connection are performed in autocommit mode. System.Transactions.Transaction.Current Właściwość nie jest zaznaczona, podczas wykonywania żądania podczas transakcji jest aktywny.The System.Transactions.Transaction.Current property is not checked when executing requests while the transaction is active. Po zakończeniu transakcji, dodatkowe żądania są wykonywane w trybie autozatwierdzania.After the transaction has ended, additional requests are performed in autocommit mode.

Jeśli transakcja zakończy się system (w zakresie przy użyciu bloku) przed zakończeniem ostatnie polecenie, będą zgłaszać InvalidOperationException.If the system ends the transaction (in the scope of a using block) before the last command completes, it will throw InvalidOperationException.

Jawne przyczyny Usuń powiązanie, połączenie pozostaje dołączony do transakcji, dopóki połączenie jest zamknięte lub jawnie SqlConnection.TransactionEnlist(null) jest wywoływana.Explicit Unbind causes the connection to remain attached to the transaction until the connection is closed or an explicit SqlConnection.TransactionEnlist(null) is called. Począwszy od Program .NET Framework 4.NET Framework 4, usunąć powiązanie niejawnych zmian jawnego usunięcia powiązania przestarzały.Beginning in Program .NET Framework 4.NET Framework 4, changes to Implicit Unbind make Explicit Unbind obsolete. InvalidOperationException Jest generowany, jeśli Transaction.Current nie jest zobowiązaniom transakcji lub jeśli zobowiązaniom transakcji nie jest aktywny.An InvalidOperationException is thrown if Transaction.Current is not the enlisted transaction or if the enlisted transaction is not active.
TransparentNetworkIPResolutionTransparentNetworkIPResolution Zobacz opis.See description. Jeśli wartość tego klucza jest równa true, aplikacja jest wymagany do pobrania wszystkich adresów IP dla określonego wpisu DNS i spróbuj połączyć się z pierwszym elementem na liście.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. Jeśli połączenie nie zostanie nawiązane w ciągu sekund 0,5, aplikacja podejmie próbę połączenia dla wszystkich innych równolegle.If the connection is not established within 0.5 seconds, the application will try to connect to all others in parallel. Podczas pierwszej odpowiedzi, połączenie z adresem IP respondentów nawiązywane aplikacji.When the first answers, the application will establish the connection with the respondent IP address.

Jeśli MultiSubnetFailover jest ustawiona na true, TransparentNetworkIPResolution jest ignorowana.If the MultiSubnetFailover key is set to true, TransparentNetworkIPResolution is ignored.

Jeśli Failover Partner ustawiono klucza TransparentNetworkIPResolution jest ignorowana.If the Failover Partner key is set, TransparentNetworkIPResolution is ignored.

Wartość tego klucza musi być true, false, yes, lub no.The value of this key must be true, false, yes, or no.

Wartość yes jest traktowane takie same jak wartość true.A value of yes is treated the same as a value of true.

Wartość no jest traktowane takie same jak wartość false.A value of no is treated the same as a value of false.

Wartości domyślne są następujące:The default values are as follows:

  • false Kiedy:false when:

    • Łączenie z usługą Azure SQL Database, gdzie źródło danych kończy się na: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" lub "Zintegrowane usługi Active Directory"Authentication is 'Active Directory Password' or 'Active Directory Integrated'
  • true we wszystkich innych przypadkach.true in all other cases.
TrustServerCertificateTrustServerCertificate wartość "false"'false' Po ustawieniu true, protokół SSL jest używany do szyfrowania kanał, gdy pomijanie zalet łańcucha certyfikatów w celu zweryfikowania relacji zaufania.When set to true, SSL is used to encrypt the channel when bypassing walking the certificate chain to validate trust. Jeśli ustawiono TrustServerCertificate true i ustawiono Szyfruj false, kanał nie jest zaszyfrowany.If TrustServerCertificate is set to true and Encrypt is set to false, the channel is not encrypted. Rozpoznawane są wartości true, false, yes, i no.Recognized values are true, false, yes, and no. Aby uzyskać więcej informacji, zobacz składnia ciągu połączenia.For more information, see Connection String Syntax.
Wersji systemuType System Version BrakN/A Wartość ciągu, która wskazuje system typu aplikacja oczekuje.A string value that indicates the type system the application expects. Funkcje dostępne dla aplikacji klienckiej jest zależna od wersji programu SQL Server i poziom zgodności bazy danych.The functionality available to a client application is dependent on the version of SQL Server and the compatibility level of the database. Jawne ustawienie wersji systemu typu, który aplikacja kliencka został napisany dla pozwala uniknąć potencjalnych problemów, które mogłyby spowodować aplikacji rozbić, jeśli jest używana inna wersja programu 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. Uwaga: Wersja systemu typu nie można ustawić dla wspólnego języka środowiska uruchomieniowego (języka wspólnego CLR) kodu wykonywania w trakcie w programie SQL Server.Note: The type system version cannot be set for common language runtime (CLR) code executing in-process in SQL Server. Aby uzyskać więcej informacji, zobacz integrację środowiska uruchomieniowego języka wspólnego serwera SQL.For more information, see SQL Server Common Language Runtime Integration.

Możliwe wartości to: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; Określa, że aplikacja będzie wymagać wersji 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. Druga Type System Version ustawień wymaga wersji 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 jest przestarzała i nie powinna być używana.Latest is obsolete and should not be used. Latest jest odpowiednikiem Type System Version=SQL Server 2008;.Latest is equivalent to Type System Version=SQL Server 2008;.
Identyfikator użytkownikaUser ID

—lub—-or-

IDENTYFIKATOR UIDUID

—lub—-or-
BrakN/A Konto logowania programu SQL Server.The SQL Server login account. Nie jest to zalecane.Not recommended. Aby zachować wysoki poziom zabezpieczeń, zdecydowanie zalecamy użycie Integrated Security lub Trusted_Connection słowa kluczowe zamiast tego.To maintain a high level of security, we strongly recommend that you use the Integrated Security or Trusted_Connection keywords instead. SqlCredential jest Bezpieczniejszym sposobem, aby określić poświadczenia dla połączenia, który używa uwierzytelniania programu SQL Server.SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication.

Identyfikator użytkownika musi być 128 znaków lub mniej.The user ID must be 128 characters or less.
Wystąpienia użytkownikaUser Instance wartość "false"'false' Wartość, która wskazuje, czy do przekierowania, połączenie z domyślnego wystąpienia programu SQL Server Express do wystąpienia inicjowanych przez środowisko uruchomieniowe działającej na koncie obiektu wywołującego.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.
Identyfikator stacji roboczejWorkstation ID

—lub—-or-

WSIDWSID
Nazwa komputera lokalnegoThe local computer name Nazwa stacji roboczej, do łączenia się z serwerem SQL.The name of the workstation connecting to SQL Server.

Identyfikator musi być 128 znaków lub mniej.The ID must be 128 characters or less.

Poniższa lista zawiera prawidłowe nazwy dla buforowania wartości w ramach połączeń ConnectionString.The following list contains the valid names for connection pooling values within the ConnectionString. Aby uzyskać więcej informacji, zobacz programu SQL Server połączenia puli (ADO.NET).For more information, see SQL Server Connection Pooling (ADO.NET).

  • Okres istnienia połączenia (lub limit czasu Równoważenie obciążenia)Connection Lifetime (or Load Balance Timeout)

  • EnlistEnlist

  • Maksymalny rozmiar puliMax Pool Size

  • Minimalny rozmiar puliMin Pool Size

  • BuforowaniePooling

Ustawiając — słowo kluczowe lub wartości, które wymagają typu wartość logiczna buforowania połączeń, można użyć "yes" zamiast "true" i "no" zamiast "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'. Wartości całkowite są reprezentowane jako ciągi.Integer values are represented as strings.

Uwaga

.NET Framework Data Provider for SQL Server używa własnego protokołu do komunikowania się z programem SQL Server.The .NET Framework Data Provider for SQL Server uses its own protocol to communicate with SQL Server. W związku z tym nie obsługuje użycia nazwa źródła danych ODBC (DSN) podczas nawiązywania połączenia z programem SQL Server, ponieważ nie powoduje dodania warstwę 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.

Uwaga

Universal data link (UDL) plików nie są obsługiwane dla .NET Framework Data Provider for SQL Server.Universal data link (UDL) files are not supported for the .NET Framework Data Provider for SQL Server.

Przestroga

W tej wersji aplikacji, należy zachować ostrożność podczas tworzenia parametrów połączenia, w oparciu o dane wejściowe użytkownika (na przykład podczas pobierania informacji o identyfikator i hasło użytkownika z okno dialogowe i dodanie go do parametrów połączenia).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). Aplikacji należy upewnić się, użytkownik nie można osadzić dodatkowych parametrów połączenia w tych wartości (na przykład wprowadzenie hasła jako "validpassword; database = somedb" w celu podjęcia próby dołączenia do innej bazy danych).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). Jeśli potrzebujesz do tworzenia parametrów połączenia na podstawie danych wejściowych użytkownika, użyj nowych SqlConnectionStringBuilder, która sprawdza poprawność parametrów połączenia i pozwala pozbyć się tego problemu.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. Zobacz Konstruktorzy parametrów połączeń Aby uzyskać więcej informacji.See Connection String Builders for more information.

Dotyczy

Zobacz też